Epics

Ver epics, explorar releases y tareas, crear y gestionar elementos de trabajo a nivel de iniciativa.

​

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

Estado	Significado
draft	Fase de planificación, aun no activo
active	Actualmente en progreso
completed	Todo el trabajo finalizado
archived	Ya 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:

Flag	Descripció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"

Ejemplo de salida

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:

Flag	Descripció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:

Flag	Descripció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"

Ejemplo de salida

 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:

Flag	Descripción
--limit <n>	Máximo de tareas por release (por defecto: 200)