Saltar para o conteúdo principal

​
Visão Geral

O Apollo CLI inclui uma skill para Claude Code que ensina o Claude a usar os comandos do Apollo. Isso significa que você pode gerenciar todo o seu workspace Apollo de dentro de sessões do Claude Code — criando tarefas, pesquisando na base de conhecimento, fazendo anotações, revisando flashcards e consultando o Brain sem trocar de ferramenta.

​
Configuração

1

Instalar o CLI

cd apollo/cli
npm install && npx tsc
npm install -g .
2

Autenticar

apollo login
3

Instalar a skill

Copie o arquivo da skill para o diretório de skills do Claude Code:
mkdir -p ~/.claude/skills
cp apollo/cli/skill/apollo-tasks.md ~/.claude/skills/apollo-tasks.md
Ou crie manualmente — veja a Referência do Arquivo de Skill abaixo.
Uma vez instalada, o Claude Code descobre automaticamente a skill e a utiliza quando você pergunta sobre tarefas, projetos, notas, lembretes ou qualquer solicitação relacionada ao Apollo.

​
Como Funciona

A skill ensina o Claude Code a:
  1. Verificar autenticação com apollo whoami antes de fazer requisições
  2. Sempre usar --json para saída estruturada e parseável
  3. Resolver recursos pelo nome usando a correspondência fuzzy do CLI
  4. Escolher o comando certo com base na sua solicitação em linguagem natural
  5. Lidar com todos os domínios — tarefas, releases, KB, notas, lembretes, flashcards

​
Exemplo de Sessão

You: What are my current tasks?

Claude: [Runs: apollo task mine --json]

        You have 6 active tasks across 2 projects:

        Delfin One (4 tasks):
        - Fix authentication bug — In Progress, High priority
        - Add retry logic — In Progress, Medium
        - Performance optimization — In Progress, Medium
        - Deploy staging — Blocked

        Apollo (2 tasks):
        - Add CSV export — To Do, Medium
        - Update API docs — To Do, Low

You: Bulk-move all Apollo todo tasks to in_progress

Claude: [Runs: apollo task bulk-status -s in_progress -p "Apollo" --current-status todo --json]

        Done. Updated 2 tasks in Apollo from todo to in_progress.

You: Search the KB for our deployment guide

Claude: [Runs: apollo kb search "deployment" -p "Apollo" --json]

        Found 2 matching pages:
        1. "Production Deployment Guide" (Architecture folder)
        2. "Staging Deploy Runbook" (Operations folder)

You: Create a note about today's standup

Claude: [Runs: apollo note create -t "Standup 2026-02-20" --content "..." --folder "Daily notes"]

        Created note: Standup 2026-02-20

​
Referência Completa de Comandos da Skill

A skill expõe os seguintes grupos de comandos para o Claude Code:

​
Comandos de Tarefas

ComandoUso
apollo task listListar e filtrar tarefas por projeto, status, responsável
apollo task mineAtalho para todas as tarefas atribuídas ao usuário atual
apollo task view <ref>Obter detalhes completos da tarefa
apollo task createCriar uma tarefa com título, projeto, prioridade, responsável, descrição, data limite
apollo task update <id>Atualizar status, prioridade, responsável, descrição, data limite, horas
apollo task done <ref>Marcar uma tarefa como concluída
apollo task assign <ref> <name>Atribuir uma tarefa a alguém
apollo task bulk-statusAtualização em lote de status por IDs ou filtro de projeto/status
apollo task bulk-assignAtribuição em lote de tarefas a um usuário
apollo task bulk-createCriar múltiplas tarefas a partir de um arquivo JSON

​
Comandos de Releases

ComandoUso
apollo release listListar releases, opcionalmente filtradas por projeto
apollo release view <ref>Detalhes da release com progresso das tarefas
apollo release createCriar uma nova release
apollo release update <ref>Atualizar nome, versão, status, data e descrição da release
apollo release assign-tasks <ref>Atribuir tarefas a uma release por IDs ou filtro

​
Comandos de Epics

ComandoUso
apollo epic list -p <project>Listar epics em um projeto
apollo epic view <name>Detalhes do epic com estatísticas de releases/tarefas
apollo epic createCriar um epic com título, projeto, status, trimestre
apollo epic update <name>Atualizar título, status, descrição, trimestre, cor do epic
apollo epic complete <name>Marcar epic como concluído
apollo epic archive <name>Arquivar um epic
apollo epic tasks <name>Todas as tarefas de um epic (via releases)

​
Comandos de Workflow

ComandoUso
apollo task start <ref>Começar a trabalhar em uma tarefa — cria branch git + marca como in_progress
apollo task stopParar a tarefa atual — faz stash do WIP, registra tempo decorrido
apollo task currentMostrar a tarefa ativa no momento
apollo task nextMostrar tarefas de maior prioridade classificadas por pontuação de urgência
apollo task deps <ref>Mostrar árvore de dependências da tarefa (bloqueadores + dependentes)
apollo filter save <name>Salvar um filtro de tarefas nomeado a partir de flags
apollo filter listListar todos os filtros salvos
apollo filter run <name>Executar um filtro salvo (delega para task list)
apollo filter delete <name>Excluir um filtro salvo
apollo context set <project>Definir projeto padrão para todos os comandos
apollo context showMostrar o projeto padrão atual
apollo context clearLimpar o projeto padrão

​
Comandos de Projetos

ComandoUso
apollo project listListar projetos acessíveis
apollo project view <ref>Detalhes do projeto com estatísticas resumidas de tarefas
apollo project export <ref>Exportar dados do projeto como JSON, CSV ou Markdown

​
Comandos da Base de Conhecimento

ComandoUso
apollo kb list -p <project>Listar páginas da KB em um projeto
apollo kb view <title>Visualizar uma página da KB com conteúdo completo
apollo kb search <query> -p <project>Pesquisar páginas da KB por título ou conteúdo
apollo kb createCriar uma nova página na KB
apollo kb update <title>Atualizar conteúdo, título ou pasta de uma página da KB
apollo kb delete <title>Exclusão lógica de uma página da KB
apollo kb folders -p <project>Listar pastas da KB

​
Notas Pessoais

ComandoUso
apollo note listListar notas pessoais
apollo note view <title>Visualizar uma nota com conteúdo completo
apollo note search <query>Pesquisar notas por título ou conteúdo
apollo note createCriar uma nota com pasta opcional
apollo note update <title>Atualizar conteúdo, título ou pasta de uma nota
apollo note foldersListar pastas de notas

​
Lembretes

ComandoUso
apollo reminder listListar lembretes pendentes
apollo reminder createCriar um lembrete baseado em horário
apollo reminder complete <id>Marcar um lembrete como concluído
apollo reminder snooze <id>Adiar um lembrete
apollo reminder dismiss <id>Descartar um lembrete
apollo reminder delete <id>Excluir permanentemente um lembrete

​
Flashcards

ComandoUso
apollo flashcard listListar flashcards (use --due para apenas cartões pendentes)
apollo flashcard view <id>Visualizar um cartão com estatísticas SM-2
apollo flashcard createCriar um novo flashcard
apollo flashcard dueContar e pré-visualizar cartões pendentes
apollo flashcard review --jsonExibir cartões pendentes como JSON para revisão não interativa

​
Outros Comandos

ComandoUso
apollo ai "<prompt>"Consultar Apollo Brain
apollo statusPainel pessoal — tarefas, releases, bloqueadores
apollo whoamiVerificar status de autenticação

​
Exemplos de Workflow

​
Após Implementar uma Funcionalidade

You: I just finished the token refresh logic. Mark the task as done
     and check if anything was blocked by it.

Claude: [Runs: apollo task done "token refresh" --json]
        [Runs: apollo task list -s blocked --json]

        Marked "Fix authentication bug" as done.
        This unblocks 1 task:
        - "Deploy staging environment" — was blocked, now ready.
        Want me to move it to In Progress?

​
Workflow da Base de Conhecimento

You: Create a KB page for our new API rate limiting rules

Claude: [Runs: apollo kb create -t "API Rate Limiting" -p "Apollo"
         --content "## Rate Limits\n..." --folder "Architecture" --json]

        Created KB page "API Rate Limiting" in the Architecture folder.

​
Sessão de Estudo

You: How many flashcards are due?

Claude: [Runs: apollo flashcard due --json]

        You have 12 flashcards due for review.
        Want me to start a review session?

​
Briefing Matinal

You: Give me a morning briefing — my tasks, any reminders, and due flashcards

Claude: [Runs: apollo task mine --json]
        [Runs: apollo reminder list --json]
        [Runs: apollo flashcard due --json]

        Morning Briefing:

        Tasks (6 active):
        - 3 in progress, 2 todo, 1 blocked

        Reminders (2 pending):
        - "Deploy v2" — due in 3 hours
        - "Weekly standup prep" — due tomorrow

        Flashcards: 8 due for review

​
Referência do Arquivo de Skill

O arquivo da skill está localizado em ~/.claude/skills/apollo-tasks.md. Ele contém:
  • Verificação de autenticação: apollo whoami antes de qualquer comando
  • Referência completa de comandos para todos os 34+ comandos do CLI
  • Documentação de resolução fuzzy de nomes
  • Instruções de modo JSON para saída estruturada
  • Exemplos de workflow para padrões comuns
  • Fallback para servidor MCP quando o CLI não está disponível
O Claude Code lê este arquivo no momento de invocação da skill. Qualquer atualização no arquivo é captada imediatamente por novas sessões.

​
Variáveis de Ambiente

VariávelDescrição
APOLLO_TOKENToken JWT para autenticação (pula o login interativo)
APOLLO_API_URLSobrescrever endpoint da API (padrão: api.apol.dev)
Para ambientes de CI ou sessões remotas do Claude Code, defina APOLLO_TOKEN para evitar autenticação interativa: 
export APOLLO_TOKEN="eyJhbGciOiJIUzI1NiIs..."