Saltar al contenido principal

​
Descripción General

Los epics son la capa estratégica en la jerarquía de trabajo de Apollo: 
Project -> Epic -> Release -> Task
Un epic agrupa releases relacionadas bajo una única iniciativa. El CLI te permite listar epics, explorar sus releases y tareas, seguir el progreso de finalización y gestionar el ciclo de vida de los epics — todo desde el terminal.
Las tareas se conectan a los epics indirectamente a través de las releases. Cuando ejecutas apollo epic tasks, el CLI obtiene todas las releases del epic y luego busca las tareas en lote de esas releases.

​
Estados de los Epics

EstadoSignificado
draftFase de planificación, aun no activo
activeActualmente en progreso
completedTodo el trabajo finalizado
archivedYa no relevante

​
Listar Epics

# List epics in a project
apollo epic list -p "Apollo"

# Filter by status
apollo epic list -p "Apollo" -s active

# Limit results
apollo epic list -p "Apollo" --limit 20
Opciones:
FlagDescripción
-p, --project <name>Nombre o ID del proyecto (obligatorio)
-s, --status <status>Filtrar por estado (draft, active, completed, archived)
--limit <n>Máximo de resultados (por defecto: 50)

​
Ver Detalles del Epic

Muestra metadatos del epic, barra de progreso, desglose de releases y estadísticas de tareas: 
apollo epic view "Authentication Overhaul"

Authentication Overhaul
────────────────────────────────────────────────────────────
  Status:  active
  Project: Apollo
  Quarter: Q2 2026
  ID:      550e8400-...

  Progress
  ████████████░░░░░░░░ 60%  12/20 tasks done
  Releases: 1/3 completed
  In Progress: 4 | Todo: 3 | Blocked: 1

  Releases (3)
  completed      Auth v1.0       12/12 tasks
  in_progress    Auth v1.1       0/5 tasks
  planned        Auth v2.0       0/3 tasks
La salida JSON incluye el objeto completo del epic, el array de releases y las task_stats calculadas: 
apollo epic view "Authentication Overhaul" --json

{
  "id": "550e8400-...",
  "title": "Authentication Overhaul",
  "status": "active",
  "releases": [...],
  "task_stats": {
    "total": 20,
    "done": 12,
    "in_progress": 4,
    "todo": 3,
    "blocked": 1,
    "backlog": 0,
    "completed_releases": 1,
    "total_releases": 3,
    "progress_pct": 60
  }
}

​
Crear un Epic

apollo epic create \
  -t "Authentication Overhaul" \
  -p "Apollo" \
  --status active \
  --quarter "Q2 2026" \
  --description "Migrate from session-based to JWT auth"
Opciones:
FlagDescripción
-t, --title <title>Título del epic (obligatorio)
-p, --project <name>Nombre o ID del proyecto (obligatorio)
-s, --status <status>Estado inicial (por defecto: draft)
--description <desc>Descripción del epic
--quarter <text>Trimestre objetivo (ej: Q2 2026)
--color <hex>Código de color hexadecimal (por defecto: #6366f1)

​
Actualizar un Epic

Actualiza cualquier campo del epic después de crearlo: 
# Change status
apollo epic update "Auth Overhaul" -s active

# Update quarter and description
apollo epic update "Auth Overhaul" --quarter "Q3 2026" --description "Scope expanded"

# Rename
apollo epic update "Auth Overhaul" -t "Auth & SSO Overhaul"
Opciones:
FlagDescripción
-t, --title <title>Nuevo título
-s, --status <status>Nuevo estado (draft, active, completed, archived)
--description <desc>Nueva descripción
--quarter <text>Nuevo trimestre objetivo
--color <hex>Nuevo código de color hexadecimal

​
Completar un Epic

Atajo para establecer el estado como completed: 
apollo epic complete "Auth Overhaul"

​
Archivar un Epic

Atajo para establecer el estado como archived: 
apollo epic archive "Auth Overhaul"

​
Listar Tareas del Epic

Obtiene todas las tareas de todas las releases que pertenecen al epic. Esta es la vista detallada recursiva: 
apollo epic tasks "Auth Overhaul"

 ID       Title                        Status       Release      Assignee
─────────┼────────────────────────────┼────────────┼────────────┼──────────
 550e8400 Implement JWT middleware     done         Auth v1.0    Ian Soares
 7a3b1c2d Add refresh token rotation  in_progress  Auth v1.1    Ana Lima
 9e4f2a8b Fix token expiry edge case  blocked      Auth v1.1    Ian Soares
 ...

12 task(s) across 3 release(s)
La salida JSON devuelve el array completo de tareas: 
apollo epic tasks "Auth Overhaul" --json
Opciones:
FlagDescripción
--limit <n>Máximo de tareas por release (por defecto: 200)