Gunakan Cursor CLI di GitHub Actions dan sistem CI/CD lainnya untuk mengotomatiskan tugas pengembangan.
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
Lihat contoh cookbook kami untuk alur kerja praktis: memperbarui dokumentasi dan memperbaiki isu CI.
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
Pilih tingkat otonomi agent lo:
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"
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)"
]
}
}
Pertama, generate API key dari dashboard Cursor.
Simpan API key Cursor dengan aman di repository:
- Buka repository GitHub lo
- Klik Settings → Secrets and variables → Actions
- Klik New repository secret
- Kasih nama
CURSOR_API_KEY
- Tempel API key lo sebagai value
- Klik Add secret
Set environment variable CURSOR_API_KEY:
env:
CURSOR_API_KEY: ${{ secrets.CURSOR_API_KEY }}