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
Mira nuestros ejemplos de cookbook para flujos de trabajo prácticos: actualizar documentación y corregir problemas 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
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)"
]
}
}
Primero, genera una clave de API desde tu panel de Cursor.
Guarda tu clave de API de Cursor de forma segura en tu repositorio:
- Ve a tu repositorio de GitHub
- Haz clic en Settings → Secrets and variables → Actions
- Haz clic en New repository secret
- Ponle el nombre
CURSOR_API_KEY
- Pega tu clave de API como valor
- Haz clic en Add secret
Configura tu variable de entorno CURSOR_API_KEY:
env:
CURSOR_API_KEY: ${{ secrets.CURSOR_API_KEY }}