Nutze die Cursor CLI in GitHub Actions und anderen CI/CD-Systemen, um Entwicklungsaufgaben zu automatisieren.
GitHub-Actions-Integration
- 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
- Shell-Skriptausführung (bash, zsh, etc.)
- Umgebungsvariablen zur Konfiguration des API-Keys
- Internetverbindung für den Zugriff auf die Cursor-API
Wähl die Autonomiestufe deines Agents:
Gib dem Agenten vollständige Kontrolle über Git-Operationen, API-Aufrufe und externe Interaktionen. Einfacheres Setup, erfordert mehr Vertrauen.
Beispiel: In unserem 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."
Ansatz mit eingeschränkter Autonomie
Wir empfehlen, diesen Ansatz mit berechtigungsbasierten Einschränkungen für produktive CI-Workflows zu nutzen. So bekommst du das Beste aus beiden Welten: Der Agent kann komplexe Analysen und Dateianpassungen intelligent übernehmen, während kritische Operationen deterministisch und auditierbar bleiben.
- 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: |
# Deterministische Git-Operationen, ausgeführt von der 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: |
# Deterministische PR-Kommentare, ausgeführt von der CI
gh pr comment ${{ github.event.pull_request.number }} --body "Docs updated"
Berechtigungsbasierte Einschränkungen
{
"permissions": {
"allow": [
"Read(**/*.md)",
"Write(docs/**/*)",
"Shell(grep)",
"Shell(find)"
],
"deny": [
"Shell(git)",
"Shell(gh)",
"Write(.env*)",
"Write(package.json)"
]
}
}
- Geh zu deinem GitHub-Repository
- Klick auf Settings → Secrets and variables → Actions
- Klick auf New repository secret
- Nenn ihn
CURSOR_API_KEY
- Füge deinen API-Schlüssel als Wert ein
- Klick auf Add secret
Setz die Umgebungsvariable CURSOR_API_KEY:
env:
CURSOR_API_KEY: ${{ secrets.CURSOR_API_KEY }}
