Usa Cursor CLI en GitHub Actions y otros sistemas de CI/CD para automatizar tareas de desarrollo.

​
Integración con GitHub Actions

Configuración básica: 
- name: Instalar Cursor CLI
  run: |
    curl https://cursor.com/install -fsS | bash
    echo "$HOME/.cursor/bin" >> $GITHUB_PATH

- name: Ejecutar Cursor Agent
  env:
    CURSOR_API_KEY: ${{ secrets.CURSOR_API_KEY }}
  run: |
    cursor-agent -p "Tu prompt aquí" --model gpt-5

​
Ejemplos del cookbook

Checa nuestros ejemplos del cookbook para ver flujos de trabajo prácticos: actualizar documentación y corregir problemas de CI.

​
Otros sistemas de CI

Usa Cursor CLI en cualquier sistema CI/CD con:
  • Ejecución de scripts de shell (bash, zsh, etc.)
  • Variables de entorno para configurar la clave de API
  • Conectividad a internet para acceder a la API de Cursor

​
Niveles de autonomía

Elige el nivel de autonomía de tu agente:

​
Enfoque de autonomía total

Dale al agente control total sobre operaciones de git, llamadas a API e interacciones externas. Configuración más simple, requiere más confianza. Ejemplo: En nuestro cookbook Update Documentation, el primer flujo de trabajo permite que el agente:
  • Analice los cambios del PR
  • Cree y gestione ramas de git
  • Haga commits y pushes de cambios
  • Publique comentarios en pull requests
  • Maneje todos los escenarios de error
- 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."

​
Enfoque de autonomía restringida

Recomendamos usar este enfoque con restricciones basadas en permisos para flujos de CI en producción. Te da lo mejor de ambos mundos: el agente puede manejar de forma inteligente análisis complejos y modificaciones de archivos, mientras que las operaciones críticas siguen siendo deterministas y auditables.
Limita las operaciones del agente y gestiona los pasos críticos en pasos separados del flujo de trabajo. Más control y previsibilidad. Ejemplo: El segundo flujo de trabajo en el mismo cookbook restringe al agente solo a modificaciones de archivos: 
- 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: |
    # Deterministic git operations handled by 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: |
    # Deterministic PR commenting handled by CI
    gh pr comment ${{ github.event.pull_request.number }} --body "Docs updated"

​
Restricciones basadas en permisos

Usa las permission configurations para aplicar restricciones a nivel de la CLI: 
{
  "permissions": {
    "allow": [
      "Read(**/*.md)",
      "Write(docs/**/*)",
      "Shell(grep)",
      "Shell(find)"
    ],
    "deny": [
      "Shell(git)",
      "Shell(gh)", 
      "Write(.env*)",
      "Write(package.json)"
    ]
  }
}

​
Autenticación

​
Genera tu clave de API

Primero, genera una clave de API desde tu panel de Cursor.

​
Configura los secretos del repositorio

Guarda tu clave de API de Cursor de forma segura en tu repositorio:
  1. Ve a tu repositorio de GitHub
  2. Haz clic en Settings → Secrets and variables → Actions
  3. Haz clic en New repository secret
  4. Ponle el nombre CURSOR_API_KEY
  5. Pega tu clave de API como valor
  6. Haz clic en Add secret

​
Úsala en workflows

Configura tu variable de entorno CURSOR_API_KEY: 
env:
  CURSOR_API_KEY: ${{ secrets.CURSOR_API_KEY }}