Vai al contenuto principale

​
Panoramica

L’Apollo CLI (apollo) porta l’intero workspace nel terminale. Gestisci attività, consulta release, controlla lo stato dei progetti, cerca nella knowledge base, prendi appunti, ripassa le flashcard e chatta con Apollo Brain — tutto senza uscire dal tuo editor o terminale.
Il CLI è progettato per tre tipi di utenti: sviluppatori che vivono nel terminale, script/CI che necessitano di output strutturato, e Claude Code come skill per flussi di lavoro assistiti dall’IA.

​
Installazione

npm install -g @apollo/cli
Dopo l’installazione, verifica che funzioni: 
apollo --version

​
Avvio Rapido

# 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

​
Autenticazione

Il CLI utilizza un flusso di login basato su browser (simile a gh auth login o aws sso login):
1

Avviare il login

Esegui apollo login. Il CLI avvia un server locale temporaneo su localhost:9876.
2

Il browser si apre

Il browser si apre su apol.dev/cli-auth, dove ti autentichi tramite il normale login di Apollo.
3

Token salvato

Dopo l’autenticazione, il token viene salvato in ~/.apollo/config.json. Il server locale si chiude automaticamente.

​
Gestione dei Token

ComandoDescrizione
apollo loginAutenticarsi tramite browser
apollo logoutCancellare le credenziali salvate
apollo whoamiMostrare l’utente corrente e lo stato di autenticazione

​
CI / Automazione

Per ambienti non interattivi (pipeline CI, Claude Code), imposta la variabile d’ambiente APOLLO_TOKEN: 
export APOLLO_TOKEN="your-supabase-jwt-token"
apollo task list --json
Quando APOLLO_TOKEN è impostato, il CLI salta tutti i prompt interattivi.

​
Flag Globali

Queste flag funzionano con tutti i comandi: 
--json          # Output raw JSON (for scripts and Claude Code)
--no-color      # Disable colored output

​
Modalità di Output

Il CLI adatta automaticamente il suo output in base al contesto:
ModalitàQuandoComportamento
PrettyTerminale interattivo (TTY)Tabelle colorate, spinner, icone
PlainOutput reindirizzato (senza TTY)Testo pulito, senza codici ANSI
JSONFlag --jsonDati strutturati grezzi per il parsing
Rilevato automaticamente tramite process.stdout.isTTY. Non è mai necessario configurarlo manualmente.

​
Risoluzione Fuzzy dei Nomi

Ogni comando che accetta un riferimento a una risorsa supporta formati multipli:
InputRisoluzione
550e8400-...Passaggio diretto dell’UUID
"Fix authentication bug"Corrispondenza esatta del nome (case-insensitive)
"fix auth"Corrispondenza fuzzy — viene risolta se c’e un’unica corrispondenza chiara
"deploy"Ambiguo — ti viene chiesto di scegliere tra i candidati
meSpeciale: si risolve nell’utente autenticato (per --assignee)
Quando una corrispondenza fuzzy e ambigua, il CLI mostra i candidati: 
Multiple matches for "deploy":
  1. Deploy staging environment
  2. Deploy monitoring stack
  3. Deploy CLI to npm

Select [1-3]:
In modalità --json, le corrispondenze ambigue restituiscono un errore con i candidati invece di mostrare un prompt interattivo.

​
Configurazione

Tutto lo stato del CLI risiede in ~/.apollo/: 
~/.apollo/
├── config.json     # Auth tokens, default project, preferences
└── cache/          # Resolver cache (auto-managed)

​
Gruppi di Comandi

Comandi Attività

Creare, aggiornare, assegnare, completare e gestire attività in blocco

Release e Progetti

Gestire release, assegnare attività alle release ed esportare progetti

Epic

Visualizzare epic, esplorare release e attività, monitorare il progresso delle iniziative

Workflow per Sviluppatori

Avvio/arresto attività con integrazione Git, ranking intelligente, filtri salvati, albero delle dipendenze

Knowledge Base

Cercare, creare e gestire pagine e cartelle della KB

Spazio Personale

Note, promemoria e flashcard con ripetizione spaziata

Apollo IA

Chatta con Apollo Brain dal tuo terminale

Integrazione Claude Code

Usa l’Apollo CLI come skill di Claude Code