Integração com Claude Code

Use o Apollo CLI como uma skill do Claude Code para fluxos de desenvolvimento assistidos por IA.

​

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

Comando	Uso
apollo task list	Listar e filtrar tarefas por projeto, status, responsável
apollo task mine	Atalho para todas as tarefas atribuídas ao usuário atual
apollo task view <ref>	Obter detalhes completos da tarefa
apollo task create	Criar 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-status	Atualização em lote de status por IDs ou filtro de projeto/status
apollo task bulk-assign	Atribuição em lote de tarefas a um usuário
apollo task bulk-create	Criar múltiplas tarefas a partir de um arquivo JSON

​

Comandos de Releases

Comando	Uso
apollo release list	Listar releases, opcionalmente filtradas por projeto
apollo release view <ref>	Detalhes da release com progresso das tarefas
apollo release create	Criar 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

Comando	Uso
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 create	Criar 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

Comando	Uso
apollo task start <ref>	Começar a trabalhar em uma tarefa — cria branch git + marca como in_progress
apollo task stop	Parar a tarefa atual — faz stash do WIP, registra tempo decorrido
apollo task current	Mostrar a tarefa ativa no momento
apollo task next	Mostrar 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 list	Listar 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 show	Mostrar o projeto padrão atual
apollo context clear	Limpar o projeto padrão

​

Comandos de Projetos

Comando	Uso
apollo project list	Listar 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

Comando	Uso
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 create	Criar 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

Comando	Uso
apollo note list	Listar 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 create	Criar uma nota com pasta opcional
apollo note update <title>	Atualizar conteúdo, título ou pasta de uma nota
apollo note folders	Listar pastas de notas

​

Lembretes

Comando	Uso
apollo reminder list	Listar lembretes pendentes
apollo reminder create	Criar 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

Comando	Uso
apollo flashcard list	Listar flashcards (use --due para apenas cartões pendentes)
apollo flashcard view <id>	Visualizar um cartão com estatísticas SM-2
apollo flashcard create	Criar um novo flashcard
apollo flashcard due	Contar e pré-visualizar cartões pendentes
apollo flashcard review --json	Exibir cartões pendentes como JSON para revisão não interativa

​

Outros Comandos

Comando	Uso
apollo ai "<prompt>"	Consultar Apollo Brain
apollo status	Painel pessoal — tarefas, releases, bloqueadores
apollo whoami	Verificar 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ável	Descrição
APOLLO_TOKEN	Token JWT para autenticação (pula o login interativo)
APOLLO_API_URL	Sobrescrever 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..."