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

Intégration de GitHub Actions

Configuration de base :
- name: Installer l’outil en ligne de commande Cursor
  run: |
    curl https://cursor.com/install -fsS | bash
    echo "$HOME/.cursor/bin" >> $GITHUB_PATH

- name: Exécuter Cursor Agent
  env:
    CURSOR_API_KEY: ${{ secrets.CURSOR_API_KEY }}
  run: |
    cursor-agent -p "Ton prompt ici" --model gpt-5

Exemples de recettes

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

Autres systèmes CI

Utilise le CLI 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é API
  • Connexion Internet pour accéder à l’API de Cursor

Niveaux d’autonomie

Choisis le niveau d’autonomie de ton agent :

Autonomie totale

Donne à l’agent le contrôle complet des opérations Git, des appels API et des interactions externes. Configuration plus simple, mais nécessite davantage de confiance. Exemple : Dans notre cookbook Update Documentation, le premier workflow permet à l’agent de :
  • Analyser les changements du PR
  • Créer et gérer des branches Git
  • Commit et push des changements
  • Publier des commentaires sur les pull requests
  • Gérer tous les scénarios d’erreur
- name: Mettre à jour la doc (autonomie totale)
  run: |
    cursor-agent -p "Tu as un accès complet à git, au CLI GitHub et aux opérations de PR. 
    Gère tout le workflow de mise à jour de la doc, y compris les commits, les push et les commentaires de PR."

Approche d’autonomie restreinte

On recommande d’utiliser cette approche avec des restrictions fondées sur des permissions pour les workflows CI en production. Ça te donne le meilleur des deux mondes : l’agent peut gérer intelligemment des analyses complexes et des modifications de fichiers, tandis que les opérations critiques restent déterministes et auditables.
Limite les opérations de l’agent tout en traitant les étapes critiques dans des étapes de workflow séparées. Meilleur contrôle et meilleure prévisibilité. Exemple : Le deuxième workflow du même cookbook restreint l’agent aux seules modifications de fichiers :
- name: Générer des mises à jour de la doc (restreint)
  run: |
    cursor-agent -p "IMPORTANT : Ne crée pas de branches, ne fais pas de commit, ne fais pas de push et ne publie pas de commentaires sur les PR.
    Modifie uniquement les fichiers dans le répertoire de travail. Une étape ultérieure du workflow s’occupe de la publication."

- name: Publier la branche de doc (déterministe)
  run: |
    # Opérations git déterministes gérées par le CI
    git checkout -B "docs/${{ github.head_ref }}"
    git add -A
    git commit -m "docs: mise à jour pour la PR"
    git push origin "docs/${{ github.head_ref }}"

- name: Publier un commentaire de PR (déterministe)  
  run: |
    # Publication de commentaires de PR déterministe gérée par le CI
    gh pr comment ${{ github.event.pull_request.number }} --body "Docs mises à jour"

Restrictions basées sur les permissions

Utilise les configurations d’autorisations 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érer ta clé API

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

Configurer 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 SettingsSecrets and variablesActions
  3. Clique sur New repository secret
  4. Nomme-la CURSOR_API_KEY
  5. Colle ta clé API comme valeur
  6. Clique sur Add secret

Utiliser dans les workflows

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