Geliştirme görevlerini otomatikleştirmek için Cursor CLI’yi GitHub Actions ve diğer CI/CD sistemlerinde kullan.

​
GitHub Actions entegrasyonu

Temel kurulum: 
- name: Cursor CLI'yi yükle
  run: |
    curl https://cursor.com/install -fsS | bash
    echo "$HOME/.cursor/bin" >> $GITHUB_PATH

- name: Cursor Agent'i çalıştır
  env:
    CURSOR_API_KEY: ${{ secrets.CURSOR_API_KEY }}
  run: |
    cursor-agent -p "Buraya istemini yaz" --model gpt-5

​
Cookbook örnekleri

Pratik iş akışları için cookbook örneklerimize göz at: dokümantasyonu güncelleme ve CI sorunlarını düzeltme.

​
Diğer CI sistemleri

Cursor CLI’yi herhangi bir CI/CD sisteminde şöyle kullan:
  • Kabuk betiği çalıştırma (bash, zsh, vb.)
  • API anahtarı yapılandırması için ortam değişkenleri
  • Cursor’un API’sine erişim için internet bağlantısı

​
Otonomi seviyeleri

Agent’ının otonomi seviyesini seç:

​
Tam otonomi yaklaşımı

Agent’a git işlemleri, API çağrıları ve harici etkileşimler üzerinde tam kontrol ver. Kurulumu daha basit, daha fazla güven gerektirir. Örnek: Update Documentation cookbook’ümüzdeki ilk iş akışı agent’a şunları yapma olanağı verir:
  • PR değişikliklerini analiz et
  • Git branch’leri oluştur ve yönet
  • Değişiklikleri commit’le ve push’la
  • Pull request’lere yorum yap
  • Tüm hata senaryolarını yönet
- 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."

​
Kısıtlı otonomi yaklaşımı

Üretim CI iş akışları için bu yaklaşımı izin tabanlı kısıtlamalarla kullanmanı öneriyoruz. Böylece iki dünyanın en iyisini elde edersin: agent karmaşık analiz ve dosya değişikliklerini akıllıca ele alırken kritik işlemler deterministik ve denetlenebilir kalır.
Kritik adımları ayrı iş akışı adımlarında ele alırken agent’ın yapabileceklerini sınırla. Daha iyi kontrol ve öngörülebilirlik sağlar. Örnek: Aynı cookbook’teki ikinci iş akışı, agent’ı yalnızca dosya değişiklikleriyle sınırlar: 
- 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"

​
İzin tabanlı kısıtlamalar

Kısıtlamaları CLI düzeyinde zorlamak için permission configurations kullan: 
{
  "permissions": {
    "allow": [
      "Read(**/*.md)",
      "Write(docs/**/*)",
      "Shell(grep)",
      "Shell(find)"
    ],
    "deny": [
      "Shell(git)",
      "Shell(gh)", 
      "Write(.env*)",
      "Write(package.json)"
    ]
  }
}

​
Kimlik Doğrulama

​
API anahtarını oluştur

Önce, Cursor kontrol panelinden bir API anahtarı oluştur.

​
Depo sırlarını yapılandır

Cursor API anahtarını depona güvenli bir şekilde kaydet:
  1. GitHub depona git
  2. Settings → Secrets and variables → Actions’a tıkla
  3. New repository secret’a tıkla
  4. Adını CURSOR_API_KEY yap
  5. Değer olarak API anahtarını yapıştır
  6. Add secret’a tıkla

​
İş akışlarında kullan

CURSOR_API_KEY ortam değişkenini ayarla: 
env:
  CURSOR_API_KEY: ${{ secrets.CURSOR_API_KEY }}