Integración con Claude Code

Usa el Apollo CLI como una skill de Claude Code para flujos de desarrollo asistidos por IA.

​

Descripción General

El Apollo CLI incluye una skill para Claude Code que enseña a Claude a usar los comandos de Apollo. Esto significa que puedes gestionar todo tu workspace de Apollo desde sesiones de Claude Code — creando tareas, buscando en la base de conocimiento, tomando notas, revisando flashcards y consultando Brain sin cambiar de herramienta.

​

Configuración

1. Instalar el CLI

   cd apollo/cli
   npm install && npx tsc
   npm install -g .
   
2. Autenticarse

   apollo login
   
3. Instalar la skill

   Copia el archivo de la skill al directorio de skills de Claude Code:

   mkdir -p ~/.claude/skills
   cp apollo/cli/skill/apollo-tasks.md ~/.claude/skills/apollo-tasks.md
   

   O créalo manualmente — consulta la Referencia del Archivo de Skill a continuación.

Una vez instalada, Claude Code descubre automáticamente la skill y la utiliza cuando preguntas sobre tareas, proyectos, notas, recordatorios o cualquier solicitud relacionada con Apollo.

​

Cómo Funciona

La skill enseña a Claude Code a:

1. Verificar autenticación con apollo whoami antes de hacer solicitudes
2. Siempre usar --json para salida estructurada y parseable
3. Resolver recursos por nombre usando la coincidencia fuzzy del CLI
4. Elegir el comando correcto según tu solicitud en lenguaje natural
5. Manejar todos los dominios — tareas, releases, KB, notas, recordatorios, flashcards

​

Ejemplo de Sesión

You: What are my current tasks?

Claude: [Runs: apollo task mine --json]

        You have 6 active tasks across 2 projects:

        Delfin One (4 tasks):
        - Fix authentication bug — In Progress, High priority
        - Add retry logic — In Progress, Medium
        - Performance optimization — In Progress, Medium
        - Deploy staging — Blocked

        Apollo (2 tasks):
        - Add CSV export — To Do, Medium
        - Update API docs — To Do, Low

You: Bulk-move all Apollo todo tasks to in_progress

Claude: [Runs: apollo task bulk-status -s in_progress -p "Apollo" --current-status todo --json]

        Done. Updated 2 tasks in Apollo from todo to in_progress.

You: Search the KB for our deployment guide

Claude: [Runs: apollo kb search "deployment" -p "Apollo" --json]

        Found 2 matching pages:
        1. "Production Deployment Guide" (Architecture folder)
        2. "Staging Deploy Runbook" (Operations folder)

You: Create a note about today's standup

Claude: [Runs: apollo note create -t "Standup 2026-02-20" --content "..." --folder "Daily notes"]

        Created note: Standup 2026-02-20

​

Referencia Completa de Comandos de la Skill

La skill expone los siguientes grupos de comandos a Claude Code:

​

Comandos de Tareas

Comando	Uso
apollo task list	Listar y filtrar tareas por proyecto, estado, responsable
apollo task mine	Atajo para todas las tareas asignadas al usuario actual
apollo task view <ref>	Obtener detalles completos de la tarea
apollo task create	Crear una tarea con título, proyecto, prioridad, responsable, descripción, fecha límite
apollo task update <id>	Actualizar estado, prioridad, responsable, descripción, fecha límite, horas
apollo task done <ref>	Marcar una tarea como completada
apollo task assign <ref> <name>	Asignar una tarea a alguien
apollo task bulk-status	Actualización masiva de estado por IDs o filtro de proyecto/estado
apollo task bulk-assign	Asignación masiva de tareas a un usuario
apollo task bulk-create	Crear múltiples tareas desde un archivo JSON

​

Comandos de Releases

Comando	Uso
apollo release list	Listar releases, opcionalmente filtradas por proyecto
apollo release view <ref>	Detalles de la release con progreso de tareas
apollo release create	Crear una nueva release
apollo release update <ref>	Actualizar nombre, versión, estado, fecha y descripción de la release
apollo release assign-tasks <ref>	Asignar tareas a una release por IDs o filtro

​

Comandos de Epics

Comando	Uso
apollo epic list -p <project>	Listar epics en un proyecto
apollo epic view <name>	Detalles del epic con estadísticas de releases/tareas
apollo epic create	Crear un epic con título, proyecto, estado, trimestre
apollo epic update <name>	Actualizar título, estado, descripción, trimestre, color del epic
apollo epic complete <name>	Marcar epic como completado
apollo epic archive <name>	Archivar un epic
apollo epic tasks <name>	Todas las tareas de un epic (vía releases)

​

Comandos de Workflow

Comando	Uso
apollo task start <ref>	Comenzar a trabajar en una tarea — crea rama git + marca como in_progress
apollo task stop	Detener la tarea actual — hace stash del WIP, registra tiempo transcurrido
apollo task current	Mostrar la tarea activa actualmente
apollo task next	Mostrar tareas de mayor prioridad clasificadas por puntuación de urgencia
apollo task deps <ref>	Mostrar árbol de dependencias de la tarea (bloqueadores + dependientes)
apollo filter save <name>	Guardar un filtro de tareas con nombre a partir de flags
apollo filter list	Listar todos los filtros guardados
apollo filter run <name>	Ejecutar un filtro guardado (delega a task list)
apollo filter delete <name>	Eliminar un filtro guardado
apollo context set <project>	Establecer proyecto predeterminado para todos los comandos
apollo context show	Mostrar el proyecto predeterminado actual
apollo context clear	Limpiar el proyecto predeterminado

​

Comandos de Proyectos

Comando	Uso
apollo project list	Listar proyectos accesibles
apollo project view <ref>	Detalles del proyecto con estadísticas resumidas de tareas
apollo project export <ref>	Exportar datos del proyecto como JSON, CSV o Markdown

​

Comandos de la Base de Conocimiento

Comando	Uso
apollo kb list -p <project>	Listar páginas de la KB en un proyecto
apollo kb view <title>	Ver una página de la KB con contenido completo
apollo kb search <query> -p <project>	Buscar páginas de la KB por título o contenido
apollo kb create	Crear una nueva página en la KB
apollo kb update <title>	Actualizar contenido, título o carpeta de una página de la KB
apollo kb delete <title>	Eliminación lógica de una página de la KB
apollo kb folders -p <project>	Listar carpetas de la KB

​

Notas Personales

Comando	Uso
apollo note list	Listar notas personales
apollo note view <title>	Ver una nota con contenido completo
apollo note search <query>	Buscar notas por título o contenido
apollo note create	Crear una nota con carpeta opcional
apollo note update <title>	Actualizar contenido, título o carpeta de una nota
apollo note folders	Listar carpetas de notas

​

Recordatorios

Comando	Uso
apollo reminder list	Listar recordatorios pendientes
apollo reminder create	Crear un recordatorio basado en hora
apollo reminder complete <id>	Marcar un recordatorio como completado
apollo reminder snooze <id>	Posponer un recordatorio
apollo reminder dismiss <id>	Descartar un recordatorio
apollo reminder delete <id>	Eliminar permanentemente un recordatorio

​

Flashcards

Comando	Uso
apollo flashcard list	Listar flashcards (usa --due para solo las pendientes)
apollo flashcard view <id>	Ver una tarjeta con estadísticas SM-2
apollo flashcard create	Crear un nuevo flashcard
apollo flashcard due	Contar y previsualizar tarjetas pendientes
apollo flashcard review --json	Mostrar tarjetas pendientes como JSON para revisión no interactiva

​

Otros Comandos

Comando	Uso
apollo ai "<prompt>"	Consultar Apollo Brain
apollo status	Panel personal — tareas, releases, bloqueadores
apollo whoami	Verificar estado de autenticación

​

Ejemplos de Workflow

​

Después de Implementar una Funcionalidad

You: I just finished the token refresh logic. Mark the task as done
     and check if anything was blocked by it.

Claude: [Runs: apollo task done "token refresh" --json]
        [Runs: apollo task list -s blocked --json]

        Marked "Fix authentication bug" as done.
        This unblocks 1 task:
        - "Deploy staging environment" — was blocked, now ready.
        Want me to move it to In Progress?

​

Workflow de la Base de Conocimiento

You: Create a KB page for our new API rate limiting rules

Claude: [Runs: apollo kb create -t "API Rate Limiting" -p "Apollo"
         --content "## Rate Limits\n..." --folder "Architecture" --json]

        Created KB page "API Rate Limiting" in the Architecture folder.

​

Sesión de Estudio

You: How many flashcards are due?

Claude: [Runs: apollo flashcard due --json]

        You have 12 flashcards due for review.
        Want me to start a review session?

​

Briefing Matutino

You: Give me a morning briefing — my tasks, any reminders, and due flashcards

Claude: [Runs: apollo task mine --json]
        [Runs: apollo reminder list --json]
        [Runs: apollo flashcard due --json]

        Morning Briefing:

        Tasks (6 active):
        - 3 in progress, 2 todo, 1 blocked

        Reminders (2 pending):
        - "Deploy v2" — due in 3 hours
        - "Weekly standup prep" — due tomorrow

        Flashcards: 8 due for review

​

Referencia del Archivo de Skill

El archivo de la skill se encuentra en ~/.claude/skills/apollo-tasks.md. Contiene:

• Verificación de autenticación: apollo whoami antes de cualquier comando
• Referencia completa de comandos para los 34+ comandos del CLI
• Documentación de resolución fuzzy de nombres
• Instrucciones de modo JSON para salida estructurada
• Ejemplos de workflow para patrones comunes
• Fallback a servidor MCP cuando el CLI no está disponible

Claude Code lee este archivo en el momento de invocar la skill. Cualquier actualización del archivo se detecta inmediatamente en nuevas sesiones.

​

Variables de Entorno

Variable	Descripción
APOLLO_TOKEN	Token JWT para autenticación (omite el login interactivo)
APOLLO_API_URL	Sobrescribir endpoint de la API (predeterminado: api.apol.dev)

Para entornos de CI o sesiones remotas de Claude Code, establece APOLLO_TOKEN para evitar la autenticación interactiva:

export APOLLO_TOKEN="eyJhbGciOiJIUzI1NiIs..."