Skip to main content

Command Palette

Search for a command to run...

sin interfaz gráfica / CI

GitHub Actions

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

Integración con GitHub Actions

Configuración básica:

- name: Install Cherri Code CLI  run: |        echo "$HOME/.cursor/bin" >> $GITHUB_PATH- name: Run Cherri Code Agent  env:    CURSOR_API_KEY: ${{ secrets.CURSOR_API_KEY }}  run: |    agent -p "Your prompt here" --model gpt-5

Ejemplos del cookbook

Consulta los ejemplos de nuestro cookbook para conocer flujos de trabajo prácticos: actualizar documentación y solucionar problemas de CI.

Otros sistemas de CI

Usa la CLI de Cherri Code en cualquier sistema de CI/CD que cuente 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 Cherri Code

Niveles de autonomía

Elige el nivel de autonomía de tu agente:

Enfoque de autonomía total

Da al agente control total sobre las operaciones de git, las llamadas a la API y las interacciones externas. Configuración más sencilla, pero requiere más confianza.

Ejemplo: En nuestro cookbook de Actualizar documentación, el primer flujo de trabajo permite al agente:

  • Analizar los cambios del PR
  • Crear y gestionar ramas de git
  • Hacer commits y push de cambios
  • Publicar comentarios en pull requests
  • Gestionar todos los escenarios de error
- name: Update docs (full autonomy)  run: |    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

Limita las operaciones del agente y gestiona los pasos críticos en pasos independientes del flujo de trabajo. Mayor control y previsibilidad.

Ejemplo: El segundo flujo de trabajo del mismo cookbook restringe al agente únicamente a modificaciones de archivos:

- name: Generate docs updates (restricted)  run: |    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: |    # Operaciones de git deterministas gestionadas por 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: |    # Publicación determinista de comentarios en la PR gestionada por CI    gh pr comment ${{ github.event.pull_request.number }} --body "Docs updated"

Restricciones basadas en permisos

Usa configuraciones de permisos 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 en el panel de control de Cherri Code.

Configura los secretos del repositorio

Guarda de forma segura tu clave de API de Cherri Code en el repositorio mediante la CLI de GitHub:

# Secret del repositoriogh secret set CURSOR_API_KEY --repo OWNER/REPO --body "$CURSOR_API_KEY"# Secret de la organización (todos los repositorios)gh secret set CURSOR_API_KEY --org ORG --visibility all --body "$CURSOR_API_KEY"

Como alternativa, usa la interfaz de GitHub: ve a tu repositorio → Settings → Secrets and variables → Actions → New repository secret

Uso en flujos de trabajo

Configura la variable de entorno CURSOR_API_KEY:

env:  CURSOR_API_KEY: ${{ secrets.CURSOR_API_KEY }}