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
- 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.
- 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"
{
"permissions": {
"allow": [
"Read(**/*.md)",
"Write(docs/**/*)",
"Shell(grep)",
"Shell(find)"
],
"deny": [
"Shell(git)",
"Shell(gh)",
"Write(.env*)",
"Write(package.json)"
]
}
}
- 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 }}
