Zum Hauptinhalt springen

​
Übersicht

Das Apollo CLI (apollo) bringt Ihren gesamten Workspace in das Terminal. Verwalten Sie Aufgaben, fragen Sie Releases ab, prüfen Sie den Projektstatus, durchsuchen Sie die Wissensdatenbank, erstellen Sie Notizen, wiederholen Sie Flashcards und chatten Sie mit Apollo Brain — alles ohne Ihren Editor oder Ihr Terminal zu verlassen.
Das CLI wurde für drei Zielgruppen entwickelt: Entwickler, die im Terminal arbeiten, Skripte/CI, die strukturierte Ausgaben benötigen, und Claude Code als Skill für KI-gestützte Workflows.

​
Installation

npm install -g @apollo/cli
Überprüfen Sie nach der Installation, ob es funktioniert: 
apollo --version

​
Schnellstart

# 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

​
Authentifizierung

Das CLI verwendet einen browserbasierten Anmeldevorgang (ähnlich wie gh auth login oder aws sso login):
1

Anmeldung starten

Führen Sie apollo login aus. Das CLI startet einen temporären lokalen Server auf localhost:9876.
2

Browser öffnet sich

Ihr Browser öffnet apol.dev/cli-auth, wo Sie sich über Ihren normalen Apollo-Login authentifizieren.
3

Token gespeichert

Nach der Authentifizierung wird der Token in ~/.apollo/config.json gespeichert. Der lokale Server wird automatisch beendet.

​
Token-Verwaltung

BefehlBeschreibung
apollo loginÜber Browser authentifizieren
apollo logoutGespeicherte Anmeldedaten löschen
apollo whoamiAktuellen Benutzer und Authentifizierungsstatus anzeigen

​
CI / Automatisierung

Für nicht-interaktive Umgebungen (CI-Pipelines, Claude Code) setzen Sie die Umgebungsvariable APOLLO_TOKEN: 
export APOLLO_TOKEN="your-supabase-jwt-token"
apollo task list --json
Wenn APOLLO_TOKEN gesetzt ist, überspringt das CLI alle interaktiven Eingabeaufforderungen.

​
Globale Flags

Diese Flags funktionieren mit jedem Befehl: 
--json          # Output raw JSON (for scripts and Claude Code)
--no-color      # Disable colored output

​
Ausgabemodi

Das CLI passt seine Ausgabe automatisch an den Kontext an:
ModusWannVerhalten
PrettyInteraktives Terminal (TTY)Farbige Tabellen, Spinner, Icons
PlainWeitergeleitete Ausgabe (kein TTY)Sauberer Text, keine ANSI-Codes
JSONFlag --jsonRohe strukturierte Daten zum Parsen
Automatisch erkannt über process.stdout.isTTY. Sie müssen dies nie manuell konfigurieren.

​
Fuzzy-Namensauflösung

Jeder Befehl, der eine Ressourcen-Referenz akzeptiert, unterstützt mehrere Formate:
EingabeAuflösung
550e8400-...Direkte UUID-Weitergabe
"Fix authentication bug"Exakte Namensübereinstimmung (Groß-/Kleinschreibung ignoriert)
"fix auth"Fuzzy-Abgleich — wird aufgelöst, wenn es eine eindeutige Übereinstimmung gibt
"deploy"Mehrdeutig — Sie werden aufgefordert, aus Kandidaten zu wählen
meSpezial: wird zum authentifizierten Benutzer aufgelöst (für --assignee)
Wenn ein Fuzzy-Abgleich mehrdeutig ist, zeigt das CLI die Kandidaten an: 
Multiple matches for "deploy":
  1. Deploy staging environment
  2. Deploy monitoring stack
  3. Deploy CLI to npm

Select [1-3]:
Im --json-Modus geben mehrdeutige Übereinstimmungen einen Fehler mit Kandidaten zurück, anstatt eine Eingabeaufforderung anzuzeigen.

​
Konfiguration

Der gesamte CLI-Zustand befindet sich in ~/.apollo/: 
~/.apollo/
├── config.json     # Auth tokens, default project, preferences
└── cache/          # Resolver cache (auto-managed)

​
Befehlsgruppen

Aufgaben-Befehle

Aufgaben erstellen, aktualisieren, zuweisen, abschließen und massenhaft verwalten

Releases und Projekte

Releases verwalten, Aufgaben zu Releases zuweisen und Projekte exportieren

Epics

Epics anzeigen, in Releases und Aufgaben eintauchen, Initiativ-Fortschritt verfolgen

Entwickler-Workflow

Git-integrierter Aufgaben-Start/Stopp, intelligentes Ranking, gespeicherte Filter, Abhängigkeitsbaum

Wissensdatenbank

KB-Seiten und -Ordner suchen, erstellen und verwalten

Persönlicher Bereich

Notizen, Erinnerungen und Flashcards mit verteilter Wiederholung

Apollo KI

Chatten Sie mit Apollo Brain direkt aus Ihrem Terminal

Claude Code Integration

Verwenden Sie das Apollo CLI als Claude Code Skill