Gunakan Cursor CLI di GitHub Actions dan sistem CI/CD lainnya untuk mengotomatiskan tugas pengembangan.

​
Integrasi GitHub Actions

Konfigurasi dasar: 
- name: Install Cursor CLI
  run: |
    curl https://cursor.com/install -fsS | bash
    echo "$HOME/.cursor/bin" >> $GITHUB_PATH

- name: Jalankan Cursor Agent
  env:
    CURSOR_API_KEY: ${{ secrets.CURSOR_API_KEY }}
  run: |
    cursor-agent -p "Your prompt here" --model gpt-5

​
Contoh cookbook

Lihat contoh cookbook kami untuk alur kerja yang praktis: memperbarui dokumentasi dan memperbaiki masalah CI.

​
Sistem CI lainnya

Pakai Cursor CLI di sistem CI/CD apa pun dengan:
  • Eksekusi skrip shell (bash, zsh, dll.)
  • Variabel lingkungan untuk konfigurasi kunci API
  • Koneksi internet untuk mengakses API Cursor

​
Tingkat otonomi

Pilih tingkat otonomi agent lo:

​
Pendekatan otonomi penuh

Kasih agent kontrol penuh atas operasi git, panggilan API, dan interaksi eksternal. Setup lebih simpel, tapi butuh kepercayaan lebih. Contoh: Di cookbook Update Documentation kami, workflow pertama memungkinkan agent buat:
  • Menganalisis perubahan PR
  • Membuat dan mengelola branch git
  • Commit dan push perubahan
  • Ngepos komentar di pull request
  • Menangani semua skenario error
- name: Update docs (full autonomy)
  run: |
    cursor-agent -p "You have full access to git, GitHub CLI, and PR operations. 
    Handle the entire docs update workflow including commits, pushes, and PR comments."

​
Pendekatan otonomi terbatas

Kami merekomendasikan pendekatan ini dengan pembatasan berbasis izin buat workflow CI produksi. Ini ngasih lo yang terbaik dari dua dunia: agent bisa secara cerdas nangani analisis kompleks dan modifikasi file, sementara operasi kritis tetap deterministik dan bisa diaudit.
Batasin operasi agent, sementara langkah-langkah kritis ditangani di step workflow terpisah. Kontrol dan prediktabilitas lebih baik. Contoh: Workflow kedua di cookbook yang sama ngebatasin agent cuma buat modifikasi file: 
- name: Generate docs updates (restricted)
  run: |
    cursor-agent -p "IMPORTANT: Do NOT create branches, commit, push, or post PR comments. 
    Only modify files in the working directory. A later workflow step handles publishing."

- name: Publish docs branch (deterministic)
  run: |
    # Deterministic git operations handled by CI
    git checkout -B "docs/${{ github.head_ref }}"
    git add -A
    git commit -m "docs: update for PR"
    git push origin "docs/${{ github.head_ref }}"

- name: Post PR comment (deterministic)  
  run: |
    # Deterministic PR commenting handled by CI
    gh pr comment ${{ github.event.pull_request.number }} --body "Docs updated"

​
Pembatasan berbasis izin

Pakai permission configurations buat menerapkan pembatasan di level CLI: 
{
  "permissions": {
    "allow": [
      "Read(**/*.md)",
      "Write(docs/**/*)",
      "Shell(grep)",
      "Shell(find)"
    ],
    "deny": [
      "Shell(git)",
      "Shell(gh)", 
      "Write(.env*)",
      "Write(package.json)"
    ]
  }
}

​
Autentikasi

​
Generate API key

Pertama, generate API key dari dashboard Cursor lo.

​
Konfigurasi repository secrets

Simpan Cursor API key lo dengan aman di repository lo:
  1. Buka repository GitHub lo
  2. Klik Settings → Secrets and variables → Actions
  3. Klik New repository secret
  4. Kasih nama CURSOR_API_KEY
  5. Tempel API key lo sebagai value
  6. Klik Add secret

​
Dipakai di workflows

Set environment variable CURSOR_API_KEY lo: 
env:
  CURSOR_API_KEY: ${{ secrets.CURSOR_API_KEY }}