Apollo CLI

Interface terminal-first para gerenciar tarefas, releases, projetos, base de conhecimento, notas, lembretes, flashcards e IA — direto do seu terminal.

​

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

npm install -g @apollo/cli

From source

# Clone the repo and link locally
cd apollo/cli
npm install
npx tsc
npm install -g .

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

Comando	Descrição
apollo login	Autenticar via navegador
apollo logout	Limpar credenciais armazenadas
apollo whoami	Mostrar 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:

Modo	Quando	Comportamento
Pretty	Terminal interativo (TTY)	Tabelas coloridas, spinners, ícones
Plain	Saída redirecionada (sem TTY)	Texto limpo, sem codigos ANSI
JSON	Flag --json	Dados 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:

Entrada	Resoluçã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
me	Especial: 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