Usa Cursor CLI en GitHub Actions y otros sistemas CI/CD para automatizar tareas de desarrollo.
Integración con GitHub Actions
- 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
- 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
- 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.
- 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
{
"permissions": {
"allow": [
"Read(**/*.md)",
"Write(docs/**/*)",
"Shell(grep)",
"Shell(find)"
],
"deny": [
"Shell(git)",
"Shell(gh)",
"Write(.env*)",
"Write(package.json)"
]
}
}
- 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 }}
