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

​
Integrasi GitHub Actions

Konfigurasi dasar: 
- name: Instal 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 "Prompt kamu di sini" --model gpt-5

​
Contoh cookbook

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

​
Sistem CI lainnya

Pakai Cursor CLI di sistem CI/CD apa pun dengan:
  • Eksekusi skrip shell (bash, zsh, dll.)
  • Variabel lingkungan untuk konfigurasi API key
  • 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 kita, workflow pertama bikin agent bisa:
  • Menganalisis perubahan PR
  • Bikin dan ngelola branch git
  • Commit dan push perubahan
  • Ngepost komentar di pull request
  • Nanganin semua skenario error
- name: Perbarui dokumentasi (otonomi penuh)
  run: |
    cursor-agent -p "Kamu punya akses penuh ke git, GitHub CLI, dan operasi PR. 
    Tangani seluruh alur pembaruan dokumentasi, termasuk commit, push, dan komentar PR."

​
Pendekatan otonomi terbatas

Kami merekomendasikan pakai pendekatan ini dengan pembatasan berbasis izin untuk alur kerja CI produksi. Ini ngasih kamu yang terbaik dari dua sisi: agen bisa dengan cerdas menangani analisis kompleks dan modifikasi file, sementara operasi kritis tetap deterministik dan bisa diaudit.
Batasi operasi agen, sementara langkah-langkah kritis ditangani di langkah alur kerja terpisah. Kontrol dan prediktabilitas jadi lebih baik. Contoh: Alur kerja kedua di cookbook yang sama membatasi agen hanya untuk modifikasi file: 
- name: Hasilkan pembaruan docs (terbatas)
  run: |
    cursor-agent -p "PENTING: Jangan membuat branch, commit, push, atau mengirim komentar PR. 
    Hanya ubah file di direktori kerja. Langkah workflow selanjutnya yang akan menangani publikasi."

- name: Publikasikan branch docs (deterministik)
  run: |
    # Operasi git deterministik ditangani oleh CI
    git checkout -B "docs/${{ github.head_ref }}"
    git add -A
    git commit -m "docs: update untuk PR"
    git push origin "docs/${{ github.head_ref }}"

- name: Kirim komentar PR (deterministik)  
  run: |
    # Komentar PR deterministik ditangani oleh CI
    gh pr comment ${{ github.event.pull_request.number }} --body "Docs diperbarui"

​
Pembatasan berbasis izin

Gunakan konfigurasi izin untuk menegakkan pembatasan pada tingkat 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.

​
Konfigurasikan repository secrets

Simpan API key Cursor dengan aman di repository:
  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

​
Gunakan di workflows

Set environment variable CURSOR_API_KEY: 
env:
  CURSOR_API_KEY: ${{ secrets.CURSOR_API_KEY }}
⌘I