Apollo CLI

Interfaccia terminal-first per gestire attività, release, progetti, knowledge base, note, promemoria, flashcard e IA — dal tuo terminale.

​

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

npm install -g @apollo/cli

From source

# Clone the repo and link locally
cd apollo/cli
npm install
npx tsc
npm install -g .

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

Comando	Descrizione
apollo login	Autenticarsi tramite browser
apollo logout	Cancellare le credenziali salvate
apollo whoami	Mostrare 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à	Quando	Comportamento
Pretty	Terminale interattivo (TTY)	Tabelle colorate, spinner, icone
Plain	Output reindirizzato (senza TTY)	Testo pulito, senza codici ANSI
JSON	Flag --json	Dati 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:

Input	Risoluzione
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
me	Speciale: 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