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

Integración con GitHub Actions

Configuración básica:
- name: Instalar la CLI de Cursor
  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 "Escribe tu prompt aquí" --model gpt-5

Ejemplos de cookbook

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

Otros sistemas de CI

Usa Cursor CLI en cualquier sistema de CI/CD con:
  • Ejecución de scripts de shell (bash, zsh, etc.)
  • Variables de entorno para configurar la clave de API
  • Conexión 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 completo sobre operaciones de Git, llamadas a APIs 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 administre ramas de Git
  • Haga commits y haga push de cambios
  • Publique comentarios en pull requests
  • Maneje todos los escenarios de error
- name: Actualizar docs (autonomía total)
  run: |
    cursor-agent -p "Tienes acceso completo a git, la CLI de GitHub y a las operaciones de PR. 
    Ocúpate de todo el flujo de actualización de la documentación, incluidos los commits, los pushes y los comentarios en PR."

Enfoque de autonomía restringida

Recomendamos usar este enfoque con restricciones basadas en permisos para flujos de trabajo 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 mueve los pasos críticos a etapas separadas del flujo de trabajo. Mejor control y previsibilidad. Ejemplo: El segundo flujo de trabajo de este mismo cookbook restringe al agente únicamente a realizar modificaciones de archivos:
- name: Generar actualizaciones de docs (restringido)
  run: |
    cursor-agent -p "IMPORTANTE: NO crees ramas, no hagas commit ni push, ni publiques comentarios en PR. 
    Modifica únicamente los archivos en el directorio de trabajo. Un paso posterior del flujo se encarga de la publicación."

- name: Publicar rama de docs (determinista)
  run: |
    # Operaciones deterministas de git gestionadas por CI
    git checkout -B "docs/${{ github.head_ref }}"
    git add -A
    git commit -m "docs: actualización para PR"
    git push origin "docs/${{ github.head_ref }}"

- name: Publicar comentario en PR (determinista)  
  run: |
    # Comentarios de PR deterministas gestionados por CI
    gh pr comment ${{ github.event.pull_request.number }} --body "Docs actualizados"

Restricciones basadas en permisos

Usa las configuraciones de permisos para imponer 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 SettingsSecrets and variablesActions
  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 }}
I