Saltar al contenido principal

​
Descripción General

El Apollo CLI (apollo) lleva todo tu espacio de trabajo al terminal. Gestiona tareas, consulta releases, verifica el estado de proyectos, busca en la base de conocimiento, toma notas, repasa flashcards y chatea con Apollo Brain — todo sin salir de tu editor o terminal.
El CLI está diseñado para tres audiencias: desarrolladores que viven en el terminal, scripts/CI que necesitan salida estructurada, y Claude Code como skill para flujos de trabajo asistidos por IA.

​
Instalación

npm install -g @apollo/cli
Después de la instalación, verifica que funciona: 
apollo --version

​
Inicio Rápido

# 1. Authenticate
apollo login

# 2. See your tasks
apollo task mine

# 3. Mark a task as done
apollo task done "fix auth bug"

# 4. Search the knowledge base
apollo kb search "deployment" -p "Apollo"

# 5. Create a personal note
apollo note create -t "Meeting notes" --content "Key decisions: ..."

# 6. Check flashcards due for review
apollo flashcard due

# 7. Ask Apollo Brain a question
apollo ai "What tasks are blocked right now?"

# 8. Personal dashboard
apollo status

​
Autenticación

El CLI utiliza un flujo de inicio de sesión basado en navegador (similar a gh auth login o aws sso login):
1

Iniciar sesión

Ejecuta apollo login. El CLI inicia un servidor local temporal en localhost:9876.
2

El navegador se abre

Tu navegador se abre en apol.dev/cli-auth, donde te autentificas con tu inicio de sesión normal de Apollo.
3

Token almacenado

Tras la autenticación, el token se guarda en ~/.apollo/config.json. El servidor local se cierra automáticamente.

​
Gestión de Tokens

ComandoDescripción
apollo loginAutenticarse vía navegador
apollo logoutBorrar credenciales almacenadas
apollo whoamiMostrar usuario actual y estado de autenticación

​
CI / Automatización

Para entornos no interactivos (pipelines de CI, Claude Code), configura la variable de entorno APOLLO_TOKEN: 
export APOLLO_TOKEN="your-supabase-jwt-token"
apollo task list --json
Cuando APOLLO_TOKEN está configurado, el CLI omite todas las solicitudes interactivas.

​
Flags Globales

Estas flags funcionan con todos los comandos: 
--json          # Output raw JSON (for scripts and Claude Code)
--no-color      # Disable colored output

​
Modos de Salida

El CLI adapta automáticamente su salida según el contexto:
ModoCuandoComportamiento
PrettyTerminal interactivo (TTY)Tablas con colores, spinners, iconos
PlainSalida redirigida (sin TTY)Texto limpio, sin codigos ANSI
JSONFlag --jsonDatos estructurados en bruto para parsing
Detectado automáticamente vía process.stdout.isTTY. Nunca necesitas configurar esto manualmente.

​
Resolución Fuzzy de Nombres

Cada comando que acepta una referencia a recurso soporta múltiples formatos:
EntradaResolución
550e8400-...Paso directo de UUID
"Fix authentication bug"Coincidencia exacta de nombre (case-insensitive)
"fix auth"Coincidencia fuzzy — se resuelve si hay una única coincidencia clara
"deploy"Ambiguo — te pide seleccionar entre candidatos
meEspecial: se resuelve al usuario autenticado (para --assignee)
Cuando una coincidencia fuzzy es ambigua, el CLI muestra los candidatos: 
Multiple matches for "deploy":
  1. Deploy staging environment
  2. Deploy monitoring stack
  3. Deploy CLI to npm

Select [1-3]:
En modo --json, las coincidencias ambiguas devuelven un error con candidatos en lugar de solicitar interacción.

​
Configuración

Todo el estado del CLI se almacena en ~/.apollo/: 
~/.apollo/
├── config.json     # Auth tokens, default project, preferences
└── cache/          # Resolver cache (auto-managed)

​
Grupos de Comandos

Comandos de Tareas

Crear, actualizar, asignar, completar y gestionar tareas en lote

Releases y Proyectos

Gestionar releases, asignar tareas a releases y exportar proyectos

Epics

Ver epics, explorar releases y tareas, seguir el progreso de iniciativas

Flujo de Trabajo para Desarrolladores

Inicio/parada de tareas con integración Git, ranking inteligente, filtros guardados, árbol de dependencias

Base de Conocimiento

Buscar, crear y gestionar páginas y carpetas de la KB

Espacio Personal

Notas, recordatorios y flashcards con repetición espaciada

Apollo IA

Chatea con Apollo Brain desde tu terminal

Integración con Claude Code

Usa el Apollo CLI como skill de Claude Code