Saltar para o conteúdo principal

​
Visão Geral

Os comandos de workflow transformam o Apollo CLI em um gerenciador de trabalho focado no desenvolvedor. Inicie uma tarefa e obtenha um branch git automaticamente. Deixe a pontuação de urgência dizer o que trabalhar a seguir. Salve seus filtros favoritos. Defina um projeto padrão para parar de digitar -p em todo lugar.
Todos os comandos de workflow suportam --json para scripts e integração com o Claude Code.

​
Iniciar / Parar / Atual

​
apollo task start <id>

Resolve uma tarefa, cria um branch git, marca como in_progress e rastreia sua sessão ativa. 
# Start by name (fuzzy match)
apollo task start "fix auth bug"

# Start by short ID
apollo task start a1b2c3d4

# Custom branch name
apollo task start "fix auth" --branch "hotfix/auth-fix"

# Skip branch creation
apollo task start "review docs" --no-branch
​
--base
string
padrão:"main"
Branch base a partir do qual criar
​
--branch
string
Substituir o nome do branch gerado automaticamente
​
--no-branch
boolean
padrão:"false"
Pular a criação do branch git, apenas atualizar o status da tarefa
O que acontece:
  1. Gera o nome do branch: feat/<shortId>-<slugified-title>
  2. Cria e faz checkout do branch (ou faz checkout se já existir)
  3. Armazena metadados da tarefa como configuração do branch git
  4. Marca a tarefa como in_progress no Apollo
  5. Atribui a tarefa a você automaticamente se não estiver atribuída
  6. Armazena a sessão ativa localmente para stop e current

​
apollo task stop [id]

Para sua sessão ativa. Faz stash de trabalho não commitado, atualiza o status e mostra o tempo decorrido. 
# Stop the current active task
apollo task stop

# Stop and mark as done
apollo task stop --done

# Stop without git stash
apollo task stop --no-stash
​
--done
boolean
padrão:"false"
Marcar a tarefa como done em vez de retornar para todo
​
--no-stash
boolean
padrão:"false"
Pular o git stash mesmo se houver alterações não commitadas

​
apollo task current

Mostra a tarefa ativa no momento com o tempo decorrido. 
apollo task current
# Working on: Fix authentication bug
#   Project: Apollo
#   Branch:  feat/a1b2c3d4-fix-authentication-bug
#   Elapsed: 1h 23m
#   ID:      a1b2c3d4-...

​
Próxima Tarefa (Ranking Inteligente)

​
apollo task next

Mostra suas tarefas de maior prioridade classificadas por uma pontuação de urgência ponderada. Inspirado no sistema de coeficientes de urgência do Taskwarrior. 
# Show top 5 tasks (default)
apollo task next

# Show top 3 with score breakdown
apollo task next -n 3 --explain

# Scope to a project
apollo task next -p "Apollo"
​
-p, --project
string
Limitar a um projeto específico
​
-n, --count
number
padrão:"5"
Número de tarefas a mostrar
​
--explain
boolean
padrão:"false"
Mostrar o detalhamento da pontuação de cada tarefa

​
Algoritmo de Pontuação

Cada tarefa e pontuada em 6 fatores com pesos diferentes:
FatorPesoMax BrutoDescrição
Priority4x20critical=20, high=15, medium=10, low=5
Due Date3x20overdue=20, today=18, this week=12, this month=6
Unblocked2x10+10 se sem bloqueios, -20 se bloqueado
Impact2x20+5 por tarefa que você desbloqueia (max 4)
Age1x50-5 baseado nos dias desde a criação
Status1x8in_progress=8, todo=5, blocked=0
A pontuação bruta é normalizada para 0-100. Use --explain para ver o detalhamento exato.

​
Filtros Salvos

Salve combinações de filtros de tarefas usadas frequentemente e replique-as com um único comando.

​
apollo filter save <name>

# Save a filter for high-priority blocked tasks
apollo filter save "my-blockers" --status "blocked" --priority "high,critical" --assignee me

# Save a filter for a project's todo list
apollo filter save "apollo-todo" --project "Apollo" --status "todo"
​
-s, --status
string
Filtro de status (separado por vírgula)
​
--priority
string
Filtro de prioridade (separado por vírgula)
​
-a, --assignee
string
Nome do responsável ou me
​
-p, --project
string
Nome do projeto
​
--release
string
Nome da release
​
--unassigned
boolean
Apenas tarefas não atribuídas
​
--due-before
string
Com vencimento antes da data
​
--limit
string
Máximo de resultados

​
apollo filter list

apollo filter list
# Name          Flags
# my-blockers   status=blocked, priority=high,critical, assignee=me
# apollo-todo   project=Apollo, status=todo

​
apollo filter run <name>

Reproduz o filtro salvo executando apollo task list com as flags armazenadas. 
apollo filter run "my-blockers"
# Equivalent to: apollo task list --status blocked --priority high,critical --assignee me

​
apollo filter delete <name>

apollo filter delete "my-blockers"
Os filtros são armazenados localmente em ~/.apollo/apollo-local.json e persistem entre sessões.

​
Contexto de Projeto

Defina um projeto padrão para não precisar digitar -p "NomeDoProjeto" em cada comando.

​
apollo context set <project>

apollo context set "Apollo"
# Default project set to: Apollo
# All commands will use this project unless -p is specified.

​
apollo context show

apollo context show
# Default project: Apollo

​
apollo context clear

apollo context clear
# Default project cleared.
Comandos que respeitam o contexto: task list, release list, epic list, kb list, kb search, kb folders. Uma flag -p explicita sempre sobrescreve o contexto padrão.

​
Dependências de Tarefas

​
apollo task deps [id]

Visualize a árvore de dependências de uma tarefa — quem bloqueia você e quem você desbloqueia. 
# Show deps for a specific task
apollo task deps "fix auth bug"

# Only show upstream blockers
apollo task deps "fix auth" --direction up

# Deeper traversal
apollo task deps "fix auth" --depth 5

# Project-wide dependency chains
apollo task deps --project "Apollo"
​
--direction
string
padrão:"both"
up (apenas bloqueadores), down (apenas dependentes), ou both
​
--depth
number
padrão:"3"
Profundidade máxima de travessia
​
-p, --project
string
Mostrar todas as cadeias de dependência em um projeto (sem necessidade de ID de tarefa)
Visualização de tarefa única mostra uma árvore com ícones de status: 
  Dependencies for: Fix auth bug
  ──────────────────────────────────────────────────


  ▲ Blocks me (upstream):
  │
  └── ✓ Set up OAuth provider done
      └── ○ Configure redirect URLs todo

  ▼ I unblock (downstream):
  │
  ├── ○ Update login page todo
  └── ○ Add SSO support todo
Visualização do projeto mostra cadeias lineares: 
  Dependency chains in Apollo (8 tasks with deps)
  ──────────────────────────────────────────────────

  Chain 1 (3 tasks):
  ✓ Set up OAuth → ● Fix auth bug → ○ Update login page

  Chain 2 (2 tasks):
  ○ Design API schema → ○ Implement REST endpoints