Gunakan Cursor CLI di GitHub Actions dan sistem CI/CD lainnya untuk mengotomatisasi tugas-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: dokumentasi yang terbarui otomatis dan memperbaiki masalah CI.

​
Sistem CI lainnya

Gunakan Cursor CLI di sistem CI/CD apa pun dengan:
  • Eksekusi skrip shell (bash, zsh, dll.)
  • Variabel environment untuk konfigurasi API key
  • Konektivitas internet untuk mengakses API Cursor

​
Tingkat otonomi

Pilih tingkat otonomi agen lo:

​
Pendekatan otonomi penuh

Kasih agen kontrol penuh atas operasi git, panggilan API, dan interaksi eksternal. Setup lebih simpel, tapi butuh kepercayaan lebih. Contoh: Di cookbook Auto Update Documentation kita, workflow pertama ngebiarin agen buat:
  • Nganalisis perubahan PR
  • Bikin dan ngelola branch git
  • Commit dan push perubahan
  • Ngepost komentar di pull request
  • Nanganin 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

Kita saranin pakai pendekatan ini dengan pembatasan berbasis izin buat workflow CI production. Ini ngasih lo yang terbaik dari dua dunia: agen bisa dengan cerdas nangani analisis kompleks dan modifikasi file, sementara operasi kritikal tetap deterministik dan bisa diaudit.
Batesin operasi agen sambil mindahin langkah kritikal ke step workflow terpisah. Kontrol dan prediktabilitas jadi lebih baik. Contoh: Workflow kedua di cookbook yang sama ngebatesin agen 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 nerapin 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

Setel variabel lingkungan CURSOR_API_KEY: 
env:
  CURSOR_API_KEY: ${{ secrets.CURSOR_API_KEY }}
Kamu bisa mendapatkan kunci API dari Cursor settings.