Saltar para o conteúdo principal

Visão Geral

Os comandos de tarefas permitem gerenciar suas tarefas do Apollo sem abrir o aplicativo web. Todos os comandos suportam resolução fuzzy de nomes — você pode referenciar tarefas por título, correspondência parcial ou UUID.

Comandos

Listar Tarefas

# Your assigned tasks (shortcut)
apollo task mine

# All tasks in a project
apollo task list -p "Apollo"

# Filter by status
apollo task list -s todo,in_progress

# Combine filters
apollo task list -p "Apollo" -s in_progress -a me --limit 50

# Filter by release, specialty, or task type
apollo task list -p "Delfin One" --release "P3.1"
apollo task list -p "Delfin One" --specialty "frontend"
apollo task list -p "Delfin One" --unassigned --due-before 2026-03-01
Opções:
FlagDescrição
-p, --project <name>Filtrar por nome ou ID do projeto
-s, --status <status>Filtrar por status: backlog, todo, in_progress, blocked, done
-a, --assignee <name>Filtrar por responsável (use me para você mesmo)
--release <name>Filtrar por nome da release (correspondência fuzzy)
--specialty <name>Filtrar por especialidade (ex: frontend, back-end, ai)
--task-type <name>Filtrar por tipo de tarefa (ex: feature, bug, chore)
--unassignedMostrar apenas tarefas sem responsável
--due-before <date>Tarefas com vencimento até uma data (YYYY-MM-DD)
--limit <n>Máximo de resultados (padrão: 50)

Ver Detalhes da Tarefa

# By title (fuzzy match)
apollo task view "fix auth"

# By UUID
apollo task view 550e8400-e29b-41d4-a716-446655440000
Mostra todos os detalhes da tarefa: status, prioridade, responsável, projeto, descrição, datas e dependências.

Criar uma Tarefa

# Basic
apollo task create -t "Add dark mode to CLI" -p "Apollo"

# Full options
apollo task create \
  -t "Implement token refresh" \
  -p "Delfin One" \
  --priority high \
  --assignee me \
  --description "Handle expired JWT tokens gracefully" \
  --due 2026-03-15
Opções:
FlagDescrição
-t, --title <title>Título da tarefa (obrigatório)
-p, --project <name>Nome ou ID do projeto (obrigatório)
--priority <level>critical, high, medium ou low
--assignee <name>Nome do responsável ou me
--description <text>Descrição da tarefa
--due <date>Data de vencimento (YYYY-MM-DD)
--hours <n>Horas estimadas

Atualizar uma Tarefa

# Change status
apollo task update <id> -s in_progress

# Change priority and assignee
apollo task update <id> --priority critical --assignee "carlos"

# Update description
apollo task update <id> --description "Updated requirements: also handle refresh tokens"

# Set due date and estimated hours
apollo task update <id> --due 2026-04-01 --hours 8
Opções:
FlagDescrição
-s, --status <status>Novo status
--priority <level>Nova prioridade
--assignee <name>Novo responsável
--description <text>Nova descrição
--due <date>Nova data de vencimento (YYYY-MM-DD)
--hours <n>Novas horas estimadas

Ações Rápidas

# Mark as done
apollo task done <id-or-title>

# Assign to someone
apollo task assign <id-or-title> "Ian"

Operações em Massa

Para gerenciar várias tarefas de uma vez, o CLI oferece comandos em massa que operam em conjuntos de tarefas filtrados por projeto, status ou IDs explícitos.

Atualização de Status em Massa

Altere o status de várias tarefas de uma vez:
# By explicit IDs
apollo task bulk-status -s done --ids "id1,id2,id3"

# By project + current status filter
apollo task bulk-status -s in_progress -p "Apollo" --current-status todo

# Move all blocked tasks in a project to todo
apollo task bulk-status -s todo -p "Apollo" --current-status blocked
Opções:
FlagDescrição
-s, --status <status>Novo status a definir (obrigatório)
--ids <id1,id2,...>IDs de tarefas separados por vírgula
-p, --project <name>Filtrar por projeto
--current-status <status>Atualizar apenas tarefas com este status atual

Atribuição em Massa

Atribua várias tarefas a um membro da equipe:
# Assign specific tasks
apollo task bulk-assign -a me --ids "id1,id2"

# Assign all unassigned tasks in a project
apollo task bulk-assign -a "Ian" -p "Apollo" --unassigned-only
Opções:
FlagDescrição
-a, --assignee <name>Nome do responsável ou me (obrigatório)
--ids <id1,id2,...>IDs de tarefas separados por vírgula
-p, --project <name>Filtrar por projeto
--unassigned-onlyAtribuir apenas tarefas sem responsável atual

Criação em Massa

Crie várias tarefas de uma vez a partir de um arquivo JSON:
# From a JSON file
apollo task bulk-create -p "Apollo" --file tasks.json
O arquivo JSON deve conter um array de objetos de tarefa:
[
  { "title": "Set up CI pipeline", "status": "todo", "priority": "high" },
  { "title": "Write unit tests", "status": "todo" },
  { "title": "Update documentation", "status": "backlog" }
]
Cada objeto de tarefa pode incluir: title, status, priority, description, due_date, estimated_hours.

Saída JSON

Todos os comandos suportam --json para saída estruturada:
apollo task list --json
[
  {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "title": "Fix authentication bug",
    "status": "in_progress",
    "priority": "high",
    "project_id": "...",
    "assigned_to": "..."
  }
]

Exemplos com Piping

# Count tasks by status
apollo task list -p "Apollo" --json | jq 'group_by(.status) | map({status: .[0].status, count: length})'

# Get titles of blocked tasks
apollo task list -s blocked --json | jq '.[].title'