Utilise Cursor CLI dans GitHub Actions et d’autres systèmes CI/CD pour automatiser tes tâches de développement.

​
Intégration à GitHub Actions

Configuration de base : 
- name: Installer le CLI Cursor
  run: |
    curl https://cursor.com/install -fsS | bash
    echo "$HOME/.cursor/bin" >> $GITHUB_PATH

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

​
Exemples de recettes

Découvre nos exemples de recettes pour des workflows pratiques : mise à jour automatique de la documentation et correction des problèmes de CI.

​
Autres systèmes CI

Utilise Cursor CLI dans n’importe quel système CI/CD avec :
  • Exécution de scripts shell (bash, zsh, etc.)
  • Variables d’environnement pour la configuration de la clé API
  • Connectivité Internet pour accéder à l’API de Cursor

​
Niveaux d’autonomie

Choisis le niveau d’autonomie de ton agent :

​
Approche en autonomie totale

Donne à l’agent un contrôle complet sur les opérations git, les appels d’API et les interactions externes. Configuration plus simple, mais nécessite davantage de confiance. Exemple : Dans notre cookbook Auto Update Documentation, le premier workflow permet à l’agent de :
  • Analyser les changements d’une PR
  • Créer et gérer des branches git
  • Commiter et pousser des changements
  • Publier des commentaires sur les pull requests
  • Gérer tous les scénarios d’erreur
- 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."

​
Approche en autonomie restreinte

On recommande d’utiliser cette approche avec des restrictions basées sur des permissions pour les workflows CI en production. Ça te donne le meilleur des deux mondes : l’agent peut gérer intelligemment l’analyse complexe et les modifications de fichiers, tandis que les opérations critiques restent déterministes et auditables.
Limite les actions de l’agent tout en gérant les étapes critiques dans des étapes de workflow séparées. Meilleur contrôle et plus de prédictibilité. Exemple : Le deuxième workflow du même cookbook limite l’agent aux seules modifications de fichiers : 
- 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: |
    # Opérations git déterministes gérées par la 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: |
    # Commentaire de PR déterministe géré par la CI
    gh pr comment ${{ github.event.pull_request.number }} --body "Docs updated"

​
Restrictions basées sur des permissions

Utilise les configurations de permissions pour appliquer des restrictions au niveau du CLI : 
{
  "permissions": {
    "allow": [
      "Read(**/*.md)",
      "Write(docs/**/*)",
      "Shell(grep)",
      "Shell(find)"
    ],
    "deny": [
      "Shell(git)",
      "Shell(gh)", 
      "Write(.env*)",
      "Write(package.json)"
    ]
  }
}

​
Authentification

Définis la variable d’environnement CURSOR_API_KEY : 
env:
  CURSOR_API_KEY: ${{ secrets.CURSOR_API_KEY }}
Tu peux obtenir ta clé API dans les paramètres de Cursor.