Epics

Visualizar epics, explorar releases e tarefas, criar e gerenciar itens de trabalho no nível de iniciativa.

​

Visão Geral

Epics são a camada estratégica na hierarquia de trabalho do Apollo:

Project -> Epic -> Release -> Task

Um epic agrupa releases relacionadas sob uma única iniciativa. O CLI permite listar epics, explorar suas releases e tarefas, acompanhar a conclusão e gerenciar o ciclo de vida dos epics — tudo pelo terminal.

As tarefas se conectam aos epics indiretamente através das releases. Quando você executa apollo epic tasks, o CLI busca todas as releases do epic e então busca as tarefas em lote dessas releases.

​

Status dos Epics

Status	Significado
draft	Fase de planejamento, ainda não ativo
active	Em andamento
completed	Todo o trabalho finalizado
archived	Não mais 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

Opções:

Flag	Descrição
-p, --project <name>	Nome ou ID do projeto (obrigatório)
-s, --status <status>	Filtrar por status (draft, active, completed, archived)
--limit <n>	Máximo de resultados (padrão: 50)

---

​

Ver Detalhes do Epic

Mostra metadados do epic, barra de progresso, distribuição de releases e estatísticas de tarefas:

apollo epic view "Authentication Overhaul"

Exemplo de saída

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

A saída JSON inclui o objeto completo do epic, array de releases e 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
  }
}

---

​

Criar um Epic

apollo epic create \
  -t "Authentication Overhaul" \
  -p "Apollo" \
  --status active \
  --quarter "Q2 2026" \
  --description "Migrate from session-based to JWT auth"

Opções:

Flag	Descrição
-t, --title <title>	Título do epic (obrigatório)
-p, --project <name>	Nome ou ID do projeto (obrigatório)
-s, --status <status>	Status inicial (padrão: draft)
--description <desc>	Descrição do epic
--quarter <text>	Trimestre alvo (ex: Q2 2026)
--color <hex>	Código de cor hexadecimal (padrão: #6366f1)

---

​

Atualizar um Epic

Atualize qualquer campo do epic após a criação:

# 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"

Opções:

Flag	Descrição
-t, --title <title>	Novo título
-s, --status <status>	Novo status (draft, active, completed, archived)
--description <desc>	Nova descrição
--quarter <text>	Novo trimestre alvo
--color <hex>	Novo código de cor hexadecimal

---

​

Concluir um Epic

Atalho para definir o status como completed:

apollo epic complete "Auth Overhaul"

---

​

Arquivar um Epic

Atalho para definir o status como archived:

apollo epic archive "Auth Overhaul"

---

​

Listar Tarefas do Epic

Busca todas as tarefas de todas as releases pertencentes ao epic. Esta é a visualização detalhada recursiva:

apollo epic tasks "Auth Overhaul"

Exemplo de saída

 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)

A saída JSON retorna o array completo de tarefas:

apollo epic tasks "Auth Overhaul" --json

Opções:

Flag	Descrição
--limit <n>	Máximo de tarefas por release (padrão: 200)