Saltar para o conteúdo principal

​
Visão Geral

O Apollo CLI (apollo) traz todo o seu workspace para o terminal. Gerencie tarefas, consulte releases, verifique o status de projetos, pesquise na base de conhecimento, crie notas, revise flashcards e converse com o Apollo Brain — tudo sem sair do seu editor ou terminal.
O CLI foi projetado para três públicos: desenvolvedores que vivem no terminal, scripts/CI que precisam de saída estruturada, e Claude Code como skill para fluxos de trabalho assistidos por IA.

​
Instalação

npm install -g @apollo/cli
Após a instalação, verifique se está funcionando: 
apollo --version

​
Início Rápido

# 1. Authenticate
apollo login

# 2. See your tasks
apollo task mine

# 3. Mark a task as done
apollo task done "fix auth bug"

# 4. Search the knowledge base
apollo kb search "deployment" -p "Apollo"

# 5. Create a personal note
apollo note create -t "Meeting notes" --content "Key decisions: ..."

# 6. Check flashcards due for review
apollo flashcard due

# 7. Ask Apollo Brain a question
apollo ai "What tasks are blocked right now?"

# 8. Personal dashboard
apollo status

​
Autenticação

O CLI utiliza um fluxo de login via navegador (semelhante ao gh auth login ou aws sso login):
1

Iniciar login

Execute apollo login. O CLI inicia um servidor local temporário em localhost:9876.
2

O navegador abre

Seu navegador abre em apol.dev/cli-auth, onde você se autentica pelo login normal do Apollo.
3

Token armazenado

Após a autenticação, o token é salvo em ~/.apollo/config.json. O servidor local é encerrado automaticamente.

​
Gerenciamento de Token

ComandoDescrição
apollo loginAutenticar via navegador
apollo logoutLimpar credenciais armazenadas
apollo whoamiMostrar usuário atual e status de autenticação

​
CI / Automação

Para ambientes não interativos (pipelines de CI, Claude Code), defina a variável de ambiente APOLLO_TOKEN: 
export APOLLO_TOKEN="your-supabase-jwt-token"
apollo task list --json
Quando APOLLO_TOKEN está definido, o CLI ignora todos os prompts interativos.

​
Flags Globais

Estas flags funcionam com todos os comandos: 
--json          # Output raw JSON (for scripts and Claude Code)
--no-color      # Disable colored output

​
Modos de Saída

O CLI adapta automaticamente sua saída com base no contexto:
ModoQuandoComportamento
PrettyTerminal interativo (TTY)Tabelas coloridas, spinners, ícones
PlainSaída redirecionada (sem TTY)Texto limpo, sem codigos ANSI
JSONFlag --jsonDados estruturados brutos para parsing
Detectado automaticamente via process.stdout.isTTY. Você nunca precisa configurar isso manualmente.

​
Resolução Fuzzy de Nomes

Todo comando que aceita uma referência a recurso suporta múltiplos formatos:
EntradaResolução
550e8400-...Passagem direta de UUID
"Fix authentication bug"Correspondência exata de nome (case-insensitive)
"fix auth"Correspondência fuzzy — resolve se houver uma única correspondência clara
"deploy"Ambíguo — solicita que você escolha entre candidatos
meEspecial: resolve para o usuário autenticado (para --assignee)
Quando uma correspondência fuzzy e ambigua, o CLI mostra os candidatos: 
Multiple matches for "deploy":
  1. Deploy staging environment
  2. Deploy monitoring stack
  3. Deploy CLI to npm

Select [1-3]:
No modo --json, correspondencias ambiguas retornam um erro com candidatos em vez de solicitar interação.

​
Configuração

Todo o estado do CLI fica em ~/.apollo/: 
~/.apollo/
├── config.json     # Auth tokens, default project, preferences
└── cache/          # Resolver cache (auto-managed)

​
Grupos de Comandos

Comandos de Tarefas

Criar, atualizar, atribuir, concluir e gerenciar tarefas em massa

Releases e Projetos

Gerenciar releases, atribuir tarefas a releases e exportar projetos

Epics

Visualizar epics, explorar releases e tarefas, acompanhar progresso de iniciativas

Fluxo de Trabalho para Desenvolvedores

Início/parada de tarefas com integração Git, ranking inteligente, filtros salvos, árvore de dependências

Base de Conhecimento

Pesquisar, criar e gerenciar páginas e pastas da KB

Espaço Pessoal

Notas, lembretes e flashcards com repetição espacada

Apollo IA

Converse com o Apollo Brain direto do seu terminal

Integração com Claude Code

Use o Apollo CLI como skill do Claude Code