Integrazione con Claude Code

Usa l’Apollo CLI come skill di Claude Code per flussi di sviluppo assistiti dall’IA.

​

Panoramica

L’Apollo CLI include una skill per Claude Code che insegna a Claude come usare i comandi di Apollo. Questo significa che puoi gestire l’intero workspace Apollo dall’interno delle sessioni di Claude Code — creando attività, cercando nella base di conoscenza, prendendo appunti, ripassando flashcard e interrogando Brain senza cambiare strumento.

​

Configurazione

1. Installare il CLI

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

   apollo login
   
3. Installare la skill

   Copia il file della skill nella directory delle skill di Claude Code:

   mkdir -p ~/.claude/skills
   cp apollo/cli/skill/apollo-tasks.md ~/.claude/skills/apollo-tasks.md
   

   Oppure crealo manualmente — vedi il Riferimento del File Skill qui sotto.

Una volta installata, Claude Code scopre automaticamente la skill e la utilizza quando chiedi informazioni su attività, progetti, note, promemoria o qualsiasi richiesta relativa ad Apollo.

​

Come Funziona

La skill insegna a Claude Code a:

1. Verificare l’autenticazione con apollo whoami prima di effettuare richieste
2. Usare sempre --json per output strutturato e analizzabile
3. Risolvere risorse per nome usando la corrispondenza fuzzy del CLI
4. Scegliere il comando giusto in base alla tua richiesta in linguaggio naturale
5. Gestire tutti i domini — attività, release, KB, note, promemoria, flashcard

​

Esempio di Sessione

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

​

Riferimento Completo dei Comandi della Skill

La skill espone i seguenti gruppi di comandi a Claude Code:

​

Comandi per le Attività

Comando	Utilizzo
apollo task list	Elencare e filtrare attività per progetto, stato, assegnatario
apollo task mine	Scorciatoia per tutte le attività assegnate all’utente corrente
apollo task view <ref>	Ottenere i dettagli completi dell’attività
apollo task create	Creare un’attività con titolo, progetto, priorità, assegnatario, descrizione, data di scadenza
apollo task update <id>	Aggiornare stato, priorità, assegnatario, descrizione, data di scadenza, ore
apollo task done <ref>	Contrassegnare un’attività come completata
apollo task assign <ref> <name>	Assegnare un’attività a qualcuno
apollo task bulk-status	Aggiornamento di stato in blocco per ID o filtro progetto/stato
apollo task bulk-assign	Assegnazione in blocco di attività a un utente
apollo task bulk-create	Creare più attività da un file JSON

​

Comandi per le Release

Comando	Utilizzo
apollo release list	Elencare le release, opzionalmente filtrate per progetto
apollo release view <ref>	Dettagli della release con avanzamento delle attività
apollo release create	Creare una nuova release
apollo release update <ref>	Aggiornare nome, versione, stato, data, descrizione della release
apollo release assign-tasks <ref>	Assegnare attività a una release per ID o filtro

​

Comandi per gli Epic

Comando	Utilizzo
apollo epic list -p <project>	Elencare gli epic in un progetto
apollo epic view <name>	Dettagli dell’epic con statistiche di release/attività
apollo epic create	Creare un epic con titolo, progetto, stato, trimestre
apollo epic update <name>	Aggiornare titolo, stato, descrizione, trimestre, colore dell’epic
apollo epic complete <name>	Contrassegnare un epic come completato
apollo epic archive <name>	Archiviare un epic
apollo epic tasks <name>	Tutte le attività di un epic (tramite release)

​

Comandi per il Workflow

Comando	Utilizzo
apollo task start <ref>	Iniziare a lavorare su un’attività — crea branch git e segna come in_progress
apollo task stop	Fermare l’attività corrente — mette in stash il WIP, registra il tempo trascorso
apollo task current	Mostrare l’attività attualmente attiva
apollo task next	Mostrare le attività a priorità più alta classificate per punteggio di urgenza
apollo task deps <ref>	Mostrare l’albero delle dipendenze dell’attività (bloccanti + dipendenti)
apollo filter save <name>	Salvare un filtro attività con nome dai flag
apollo filter list	Elencare tutti i filtri salvati
apollo filter run <name>	Eseguire un filtro salvato (delega a task list)
apollo filter delete <name>	Eliminare un filtro salvato
apollo context set <project>	Impostare il progetto predefinito per tutti i comandi
apollo context show	Mostrare il progetto predefinito attuale
apollo context clear	Cancellare il progetto predefinito

​

Comandi per i Progetti

Comando	Utilizzo
apollo project list	Elencare i progetti accessibili
apollo project view <ref>	Dettagli del progetto con statistiche riepilogative delle attività
apollo project export <ref>	Esportare i dati del progetto come JSON, CSV o Markdown

​

Comandi per la Base di Conoscenza

Comando	Utilizzo
apollo kb list -p <project>	Elencare le pagine KB in un progetto
apollo kb view <title>	Visualizzare una pagina KB con contenuto completo
apollo kb search <query> -p <project>	Cercare pagine KB per titolo o contenuto
apollo kb create	Creare una nuova pagina KB
apollo kb update <title>	Aggiornare contenuto, titolo o cartella di una pagina KB
apollo kb delete <title>	Eliminazione logica di una pagina KB
apollo kb folders -p <project>	Elencare le cartelle KB

​

Note Personali

Comando	Utilizzo
apollo note list	Elencare le note personali
apollo note view <title>	Visualizzare una nota con contenuto completo
apollo note search <query>	Cercare note per titolo o contenuto
apollo note create	Creare una nota con cartella opzionale
apollo note update <title>	Aggiornare contenuto, titolo o cartella di una nota
apollo note folders	Elencare le cartelle delle note

​

Promemoria

Comando	Utilizzo
apollo reminder list	Elencare i promemoria in sospeso
apollo reminder create	Creare un promemoria basato sul tempo
apollo reminder complete <id>	Contrassegnare un promemoria come completato
apollo reminder snooze <id>	Posticipare un promemoria
apollo reminder dismiss <id>	Ignorare un promemoria
apollo reminder delete <id>	Eliminare permanentemente un promemoria

​

Flashcard

Comando	Utilizzo
apollo flashcard list	Elencare le flashcard (usa --due per solo quelle in scadenza)
apollo flashcard view <id>	Visualizzare una carta con statistiche SM-2
apollo flashcard create	Creare una nuova flashcard
apollo flashcard due	Contare e visualizzare in anteprima le carte in scadenza
apollo flashcard review --json	Mostrare le carte in scadenza come JSON per revisione non interattiva

​

Altri Comandi

Comando	Utilizzo
apollo ai "<prompt>"	Interrogare Apollo Brain
apollo status	Dashboard personale — attività, release, bloccanti
apollo whoami	Verificare lo stato di autenticazione

​

Esempi di Workflow

​

Dopo Aver Implementato una Funzionalità

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 della Base di Conoscenza

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.

​

Sessione di Studio

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 Mattutino

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

​

Riferimento del File Skill

Il file della skill si trova in ~/.claude/skills/apollo-tasks.md. Contiene:

• Verifica dell’autenticazione: apollo whoami prima di qualsiasi comando
• Riferimento completo dei comandi per tutti i 34+ comandi del CLI
• Documentazione sulla risoluzione fuzzy dei nomi
• Istruzioni per la modalità JSON per output strutturato
• Esempi di workflow per pattern comuni
• Fallback al server MCP quando il CLI non è disponibile

Claude Code legge questo file al momento dell’invocazione della skill. Qualsiasi aggiornamento al file viene rilevato immediatamente dalle nuove sessioni.

​

Variabili d’Ambiente

Variabile	Descrizione
APOLLO_TOKEN	Token JWT per l’autenticazione (salta il login interattivo)
APOLLO_API_URL	Sovrascrivere l’endpoint API (predefinito: api.apol.dev)

Per ambienti CI o sessioni remote di Claude Code, imposta APOLLO_TOKEN per evitare l’autenticazione interattiva:

export APOLLO_TOKEN="eyJhbGciOiJIUzI1NiIs..."