Zum Hauptinhalt springen

​
Übersicht

Das Apollo CLI wird mit einem Claude Code Skill ausgeliefert, der Claude beibringt, Apollo-Befehle zu verwenden. Das bedeutet, du kannst deinen gesamten Apollo-Workspace aus Claude Code Sitzungen heraus verwalten — Aufgaben erstellen, die Wissensdatenbank durchsuchen, Notizen machen, Lernkarten überprüfen und Brain abfragen, ohne das Werkzeug zu wechseln.

​
Einrichtung

1

CLI installieren

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

Authentifizieren

apollo login
3

Skill installieren

Kopiere die Skill-Datei in das Skills-Verzeichnis von Claude Code:
mkdir -p ~/.claude/skills
cp apollo/cli/skill/apollo-tasks.md ~/.claude/skills/apollo-tasks.md
Oder erstelle sie manuell — siehe die Skill-Datei-Referenz weiter unten.
Nach der Installation erkennt Claude Code den Skill automatisch und verwendet ihn, wenn du nach Aufgaben, Projekten, Notizen, Erinnerungen oder anderen Apollo-bezogenen Anfragen fragst.

​
Funktionsweise

Der Skill bringt Claude Code bei:
  1. Authentifizierung prüfen mit apollo whoami vor Anfragen
  2. Immer --json verwenden für strukturierte, parsbare Ausgabe
  3. Ressourcen nach Namen auflösen mit der Fuzzy-Suche des CLI
  4. Den richtigen Befehl wählen basierend auf deiner natürlichsprachlichen Anfrage
  5. Alle Bereiche abdecken — Aufgaben, Releases, KB, Notizen, Erinnerungen, Lernkarten

​
Beispiel-Sitzung

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

​
Vollständige Skill-Befehlsreferenz

Der Skill stellt Claude Code folgende Befehlsgruppen zur Verfügung:

​
Aufgaben-Befehle

BefehlVerwendung
apollo task listAufgaben nach Projekt, Status, Zuständigem auflisten und filtern
apollo task mineSchnellzugriff auf alle dem aktuellen Benutzer zugewiesenen Aufgaben
apollo task view <ref>Vollständige Aufgabendetails abrufen
apollo task createAufgabe mit Titel, Projekt, Priorität, Zuständigem, Beschreibung, Fälligkeitsdatum erstellen
apollo task update <id>Status, Priorität, Zuständigen, Beschreibung, Fälligkeitsdatum, Stunden aktualisieren
apollo task done <ref>Eine Aufgabe als erledigt markieren
apollo task assign <ref> <name>Eine Aufgabe jemandem zuweisen
apollo task bulk-statusMassen-Statusaktualisierung nach IDs oder Projekt-/Statusfilter
apollo task bulk-assignMassenhafte Zuweisung von Aufgaben an einen Benutzer
apollo task bulk-createMehrere Aufgaben aus einer JSON-Datei erstellen

​
Release-Befehle

BefehlVerwendung
apollo release listReleases auflisten, optional nach Projekt gefiltert
apollo release view <ref>Release-Details mit Aufgabenfortschritt
apollo release createNeues Release erstellen
apollo release update <ref>Release-Name, Version, Status, Datum, Beschreibung aktualisieren
apollo release assign-tasks <ref>Aufgaben einem Release per IDs oder Filter zuweisen

​
Epic-Befehle

BefehlVerwendung
apollo epic list -p <project>Epics in einem Projekt auflisten
apollo epic view <name>Epic-Details mit Release-/Aufgabenstatistiken
apollo epic createEpic mit Titel, Projekt, Status, Quartal erstellen
apollo epic update <name>Titel, Status, Beschreibung, Quartal, Farbe des Epics aktualisieren
apollo epic complete <name>Epic als abgeschlossen markieren
apollo epic archive <name>Ein Epic archivieren
apollo epic tasks <name>Alle Aufgaben eines Epics (über Releases)

​
Workflow-Befehle

BefehlVerwendung
apollo task start <ref>An einer Aufgabe arbeiten — erstellt Git-Branch + markiert als in_progress
apollo task stopAktuelle Aufgabe stoppen — stasht WIP, erfasst verstrichene Zeit
apollo task currentDie derzeit aktive Aufgabe anzeigen
apollo task nextAufgaben mit höchster Priorität nach Dringlichkeitspunktzahl anzeigen
apollo task deps <ref>Abhängigkeitsbaum der Aufgabe anzeigen (Blocker + Abhängige)
apollo filter save <name>Benannten Aufgabenfilter aus Flags speichern
apollo filter listAlle gespeicherten Filter auflisten
apollo filter run <name>Gespeicherten Filter ausführen (delegiert an task list)
apollo filter delete <name>Gespeicherten Filter löschen
apollo context set <project>Standardprojekt für alle Befehle festlegen
apollo context showAktuelles Standardprojekt anzeigen
apollo context clearStandardprojekt löschen

​
Projekt-Befehle

BefehlVerwendung
apollo project listZugängliche Projekte auflisten
apollo project view <ref>Projektdetails mit zusammenfassenden Aufgabenstatistiken
apollo project export <ref>Projektdaten als JSON, CSV oder Markdown exportieren

​
Wissensdatenbank-Befehle

BefehlVerwendung
apollo kb list -p <project>KB-Seiten in einem Projekt auflisten
apollo kb view <title>KB-Seite mit vollständigem Inhalt anzeigen
apollo kb search <query> -p <project>KB-Seiten nach Titel oder Inhalt durchsuchen
apollo kb createNeue KB-Seite erstellen
apollo kb update <title>Inhalt, Titel oder Ordner einer KB-Seite aktualisieren
apollo kb delete <title>KB-Seite logisch löschen
apollo kb folders -p <project>KB-Ordner auflisten

​
Persönliche Notizen

BefehlVerwendung
apollo note listPersönliche Notizen auflisten
apollo note view <title>Notiz mit vollständigem Inhalt anzeigen
apollo note search <query>Notizen nach Titel oder Inhalt durchsuchen
apollo note createNotiz mit optionalem Ordner erstellen
apollo note update <title>Inhalt, Titel oder Ordner einer Notiz aktualisieren
apollo note foldersNotiz-Ordner auflisten

​
Erinnerungen

BefehlVerwendung
apollo reminder listAusstehende Erinnerungen auflisten
apollo reminder createZeitbasierte Erinnerung erstellen
apollo reminder complete <id>Erinnerung als erledigt markieren
apollo reminder snooze <id>Erinnerung verschieben
apollo reminder dismiss <id>Erinnerung verwerfen
apollo reminder delete <id>Erinnerung dauerhaft löschen

​
Lernkarten

BefehlVerwendung
apollo flashcard listLernkarten auflisten (--due für nur fällige Karten)
apollo flashcard view <id>Karte mit SM-2-Statistiken anzeigen
apollo flashcard createNeue Lernkarte erstellen
apollo flashcard dueFällige Karten zählen und vorschauen
apollo flashcard review --jsonFällige Karten als JSON für nicht-interaktive Überprüfung ausgeben

​
Weitere Befehle

BefehlVerwendung
apollo ai "<prompt>"Apollo Brain abfragen
apollo statusPersönliches Dashboard — Aufgaben, Releases, Blocker
apollo whoamiAuthentifizierungsstatus prüfen

​
Workflow-Beispiele

​
Nach der Implementierung eines Features

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?

​
Wissensdatenbank-Workflow

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.

​
Lernsitzung

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?

​
Morgen-Briefing

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

​
Skill-Datei-Referenz

Die Skill-Datei befindet sich unter ~/.claude/skills/apollo-tasks.md. Sie enthält:
  • Authentifizierungsprüfung: apollo whoami vor jedem Befehl
  • Vollständige Befehlsreferenz für alle 34+ CLI-Befehle
  • Dokumentation zur Fuzzy-Namensauflösung
  • JSON-Modus-Anweisungen für strukturierte Ausgabe
  • Workflow-Beispiele für gängige Muster
  • MCP-Server-Fallback wenn das CLI nicht verfügbar ist
Claude Code liest diese Datei beim Aufrufen des Skills. Änderungen an der Datei werden sofort von neuen Sitzungen übernommen.

​
Umgebungsvariablen

VariableBeschreibung
APOLLO_TOKENJWT-Token für Authentifizierung (überspringt interaktiven Login)
APOLLO_API_URLAPI-Endpunkt überschreiben (Standard: api.apol.dev)
Für CI-Umgebungen oder entfernte Claude Code Sitzungen setze APOLLO_TOKEN, um interaktive Authentifizierung zu vermeiden: 
export APOLLO_TOKEN="eyJhbGciOiJIUzI1NiIs..."