Zum Hauptinhalt springen

Übersicht

Epics sind die strategische Ebene in Apollos Arbeitshierarchie:
Project -> Epic -> Release -> Task
Ein Epic fasst verwandte Releases unter einer einzelnen Initiative zusammen. Das CLI ermöglicht es Ihnen, Epics aufzulisten, deren Releases und Aufgaben zu erkunden, den Fortschritt zu verfolgen und den Epic-Lebenszyklus zu verwalten — alles aus dem Terminal.
Aufgaben sind mit Epics indirekt über Releases verbunden. Wenn Sie apollo epic tasks ausführen, ruft das CLI alle Releases des Epics ab und holt dann die Aufgaben stapelweise über diese Releases.

Epic-Status

StatusBedeutung
draftPlanungsphase, noch nicht aktiv
activeDerzeit in Bearbeitung
completedAlle Arbeiten abgeschlossen
archivedNicht mehr relevant

Epics auflisten

# List epics in a project
apollo epic list -p "Apollo"

# Filter by status
apollo epic list -p "Apollo" -s active

# Limit results
apollo epic list -p "Apollo" --limit 20
Optionen:
FlagBeschreibung
-p, --project <name>Projektname oder -ID (erforderlich)
-s, --status <status>Nach Status filtern (draft, active, completed, archived)
--limit <n>Maximale Ergebnisse (Standard: 50)

Epic-Details anzeigen

Zeigt Epic-Metadaten, Fortschrittsbalken, Release-Aufschlüsselung und Aufgabenstatistiken:
apollo epic view "Authentication Overhaul"
Authentication Overhaul
────────────────────────────────────────────────────────────
  Status:  active
  Project: Apollo
  Quarter: Q2 2026
  ID:      550e8400-...

  Progress
  ████████████░░░░░░░░ 60%  12/20 tasks done
  Releases: 1/3 completed
  In Progress: 4 | Todo: 3 | Blocked: 1

  Releases (3)
  completed      Auth v1.0       12/12 tasks
  in_progress    Auth v1.1       0/5 tasks
  planned        Auth v2.0       0/3 tasks
Die JSON-Ausgabe enthält das vollständige Epic-Objekt, das Releases-Array und die berechneten task_stats:
apollo epic view "Authentication Overhaul" --json
{
  "id": "550e8400-...",
  "title": "Authentication Overhaul",
  "status": "active",
  "releases": [...],
  "task_stats": {
    "total": 20,
    "done": 12,
    "in_progress": 4,
    "todo": 3,
    "blocked": 1,
    "backlog": 0,
    "completed_releases": 1,
    "total_releases": 3,
    "progress_pct": 60
  }
}

Ein Epic erstellen

apollo epic create \
  -t "Authentication Overhaul" \
  -p "Apollo" \
  --status active \
  --quarter "Q2 2026" \
  --description "Migrate from session-based to JWT auth"
Optionen:
FlagBeschreibung
-t, --title <title>Epic-Titel (erforderlich)
-p, --project <name>Projektname oder -ID (erforderlich)
-s, --status <status>Anfangsstatus (Standard: draft)
--description <desc>Epic-Beschreibung
--quarter <text>Zielquartal (z.B. Q2 2026)
--color <hex>Farb-Hex-Code (Standard: #6366f1)

Ein Epic aktualisieren

Aktualisieren Sie jedes Epic-Feld nach der Erstellung:
# Change status
apollo epic update "Auth Overhaul" -s active

# Update quarter and description
apollo epic update "Auth Overhaul" --quarter "Q3 2026" --description "Scope expanded"

# Rename
apollo epic update "Auth Overhaul" -t "Auth & SSO Overhaul"
Optionen:
FlagBeschreibung
-t, --title <title>Neuer Titel
-s, --status <status>Neuer Status (draft, active, completed, archived)
--description <desc>Neue Beschreibung
--quarter <text>Neues Zielquartal
--color <hex>Neuer Farb-Hex-Code

Ein Epic abschließen

Schnellbefehl zum Setzen des Status auf completed:
apollo epic complete "Auth Overhaul"

Ein Epic archivieren

Schnellbefehl zum Setzen des Status auf archived:
apollo epic archive "Auth Overhaul"

Epic-Aufgaben auflisten

Ruft alle Aufgaben über alle Releases ab, die zum Epic gehören. Dies ist die rekursive Detailansicht:
apollo epic tasks "Auth Overhaul"
 ID       Title                        Status       Release      Assignee
─────────┼────────────────────────────┼────────────┼────────────┼──────────
 550e8400 Implement JWT middleware     done         Auth v1.0    Ian Soares
 7a3b1c2d Add refresh token rotation  in_progress  Auth v1.1    Ana Lima
 9e4f2a8b Fix token expiry edge case  blocked      Auth v1.1    Ian Soares
 ...

12 task(s) across 3 release(s)
Die JSON-Ausgabe gibt das vollständige Aufgaben-Array zurück:
apollo epic tasks "Auth Overhaul" --json
Optionen:
FlagBeschreibung
--limit <n>Maximale Aufgaben pro Release (Standard: 200)