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

​
Intégration à GitHub Actions

Configuration de base : 
- name: Installer la 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 "Ton prompt ici" --model gpt-5

​
Exemples de cookbook

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

​
Autres systèmes CI

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

​
Niveaux d’autonomie

Choisis le niveau d’autonomie de ton agent :

​
Approche à autonomie totale

Donne à l’agent le contrôle complet des opérations git, des appels API et des interactions externes. Configuration plus simple, nécessite plus de confiance. Exemple : Dans notre cookbook Mettre à jour la 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 à autonomie restreinte

On recommande d’utiliser cette approche avec des restrictions basées sur des permissions pour les workflows CI en production. Tu as ainsi 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 opérations de l’agent et traite les étapes critiques dans des étapes de workflow séparées. Meilleur contrôle et plus de prévisibilité. Exemple : Le deuxième workflow du même cookbook restreint 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

​
Génère ta clé API

D’abord, génère une clé API depuis ton tableau de bord Cursor.

​
Configure les secrets du dépôt

Stocke ta clé API Cursor en toute sécurité dans ton dépôt :
  1. Va sur ton dépôt GitHub
  2. Clique sur Settings → Secrets and variables → Actions
  3. Clique sur New repository secret
  4. Nomme-la CURSOR_API_KEY
  5. Colle ta clé API comme valeur
  6. Clique sur Add secret

​
Utilisation dans les workflows

Définis la variable d’environnement CURSOR_API_KEY : 
env:
  CURSOR_API_KEY: ${{ secrets.CURSOR_API_KEY }}