Verwende die Cursor CLI in GitHub Actions und anderen CI/CD-Systemen, um Entwicklungsaufgaben zu automatisieren.

​
GitHub-Actions-Integration

Basis-Setup: 
- name: Cursor-CLI installieren
  run: |
    curl https://cursor.com/install -fsS | bash
    echo "$HOME/.cursor/bin" >> $GITHUB_PATH

- name: Cursor Agent ausführen
  env:
    CURSOR_API_KEY: ${{ secrets.CURSOR_API_KEY }}
  run: |
    cursor-agent -p "Your prompt here" --model gpt-5

​
Cookbook-Beispiele

Schau dir unsere Cookbook-Beispiele für praktische Workflows an: automatisch aktualisierte Doku und CI-Probleme beheben.

​
Andere CI-Systeme

Verwende die Cursor CLI in jedem CI/CD-System mit:
  • Shell-Script-Ausführung (bash, zsh, etc.)
  • Umgebungsvariablen für die API-Key-Konfiguration
  • Internetverbindung, um Cursors API zu erreichen

​
Autonomiestufen

Wähl die Autonomiestufe deines Agents:

​
Vollständige Autonomie

Gib dem Agenten die vollständige Kontrolle über Git-Operationen, API-Aufrufe und externe Interaktionen. Einfacheres Setup, erfordert mehr Vertrauen. Beispiel: In unserem Auto Update Documentation Cookbook lässt der erste Workflow den Agenten:
  • PR-Änderungen analysieren
  • Git-Branches erstellen und verwalten
  • Änderungen committen und pushen
  • Kommentare in Pull Requests posten
  • Alle Fehlerszenarien behandeln
- 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."

​
Eingeschränkte Autonomie

Wir empfehlen, diesen Ansatz mit berechtigungsbasierten Einschränkungen für produktive CI-Workflows zu verwenden. So bekommst du das Beste aus beiden Welten: Der Agent kann komplexe Analysen und Dateianpassungen intelligent handhaben, während kritische Operationen deterministisch und auditierbar bleiben.
Begrenze die Agent-Operationen und führe kritische Schritte in separaten Workflow-Schritten aus. Das sorgt für bessere Kontrolle und Vorhersehbarkeit. Beispiel: Der zweite Workflow im selben Cookbook beschränkt den Agenten auf reine Dateianpassungen: 
- 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"

​
Berechtigungsbasierte Einschränkungen

Verwende Permission-Konfigurationen, um Einschränkungen auf CLI-Ebene durchzusetzen: 
{
  "permissions": {
    "allow": [
      "Read(**/*.md)",
      "Write(docs/**/*)",
      "Shell(grep)",
      "Shell(find)"
    ],
    "deny": [
      "Shell(git)",
      "Shell(gh)", 
      "Write(.env*)",
      "Write(package.json)"
    ]
  }
}

​
Authentifizierung

Setz deine Umgebungsvariable CURSOR_API_KEY: 
env:
  CURSOR_API_KEY: ${{ secrets.CURSOR_API_KEY }}
Deinen API-Schlüssel bekommst du in den Cursor-Einstellungen.