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
Découvre nos exemples de recettes pour des workflows concrets : mise à jour de la doc et correction des problèmes de 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 :
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)"
]
}
}
D’abord, génère une clé API depuis ton tableau de bord Cursor.
Stocke ta clé API Cursor en toute sécurité dans ton dépôt :
- Va sur ton dépôt GitHub
- Clique sur Settings → Secrets and variables → Actions
- Clique sur New repository secret
- Nomme-la
CURSOR_API_KEY
- Colle ta clé API comme valeur
- 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 }}