Vai al contenuto principale

​
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à

ComandoUtilizzo
apollo task listElencare e filtrare attività per progetto, stato, assegnatario
apollo task mineScorciatoia per tutte le attività assegnate all’utente corrente
apollo task view <ref>Ottenere i dettagli completi dell’attività
apollo task createCreare 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-statusAggiornamento di stato in blocco per ID o filtro progetto/stato
apollo task bulk-assignAssegnazione in blocco di attività a un utente
apollo task bulk-createCreare più attività da un file JSON

​
Comandi per le Release

ComandoUtilizzo
apollo release listElencare le release, opzionalmente filtrate per progetto
apollo release view <ref>Dettagli della release con avanzamento delle attività
apollo release createCreare 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

ComandoUtilizzo
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 createCreare 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

ComandoUtilizzo
apollo task start <ref>Iniziare a lavorare su un’attività — crea branch git e segna come in_progress
apollo task stopFermare l’attività corrente — mette in stash il WIP, registra il tempo trascorso
apollo task currentMostrare l’attività attualmente attiva
apollo task nextMostrare 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 listElencare 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 showMostrare il progetto predefinito attuale
apollo context clearCancellare il progetto predefinito

​
Comandi per i Progetti

ComandoUtilizzo
apollo project listElencare 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

ComandoUtilizzo
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 createCreare 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

ComandoUtilizzo
apollo note listElencare 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 createCreare una nota con cartella opzionale
apollo note update <title>Aggiornare contenuto, titolo o cartella di una nota
apollo note foldersElencare le cartelle delle note

​
Promemoria

ComandoUtilizzo
apollo reminder listElencare i promemoria in sospeso
apollo reminder createCreare 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

ComandoUtilizzo
apollo flashcard listElencare le flashcard (usa --due per solo quelle in scadenza)
apollo flashcard view <id>Visualizzare una carta con statistiche SM-2
apollo flashcard createCreare una nuova flashcard
apollo flashcard dueContare e visualizzare in anteprima le carte in scadenza
apollo flashcard review --jsonMostrare le carte in scadenza come JSON per revisione non interattiva

​
Altri Comandi

ComandoUtilizzo
apollo ai "<prompt>"Interrogare Apollo Brain
apollo statusDashboard personale — attività, release, bloccanti
apollo whoamiVerificare 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

VariabileDescrizione
APOLLO_TOKENToken JWT per l’autenticazione (salta il login interattivo)
APOLLO_API_URLSovrascrivere 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..."