CLI-Referenz · Befehle

usage

Den Token-Verbrauch der Agenten-Sitzungen an Workban melden. Normalerweise ruft das niemand von Hand auf: Die Hooks melden nach jeder Runde und am Ende einer Sitzung, task done meldet zuletzt. Was gezählt und wie es zugeordnet wird, steht unter Token-Verbrauch.

workban usage report

Liest das Protokoll einer Agenten-Sitzung, ordnet jede Antwort dem Task zu, den die Sitzung zu der Zeit in Arbeit hatte, und schickt die Zeilen je Task, Subagent, Modell und Stunde an Workban. Ohne --session die Sitzung, aus der der Befehl läuft (CLAUDE_CODE_SESSION_ID bei Claude Code, CODEX_THREAD_ID bei Codex).

workban usage report [Optionen]

Optionen

--session <id>Wert
Sitzung, sonst die aus CLAUDE_CODE_SESSION_ID oder CODEX_THREAD_ID
--agent <type>Wert
Agent der SitzungWerte: claude-code · codexStandard: claude-code
--transcript <path>Wert
Protokolldatei der Sitzung, sonst wird sie gesucht
--allSchalter
alle Sitzungen, die in diesem Repo einen Task gestartet haben
--dir <path>Wert
Repo-Verzeichnis (für Hooks im Hintergrund)

Gemeldet wird nur in einem Repo mit .workban.toml; das Projekt kommt von dort.
Jede Zeile trägt ihren vollständigen Stand. Gesendet werden nur Zeilen, die sich seit der letzten Meldung geändert haben; ein zweiter Aufruf direkt danach schickt nichts.
Läuft für die Sitzung schon eine Meldung, übernimmt sie den Auftrag in einem weiteren Durchgang.
--all meldet zusätzlich jede Sitzung, die in diesem Repo einen Task gestartet hat und deren Protokoll auf diesem Rechner liegt. Gedacht für Umgebungen, die per Timer nachholen.
--transcript nennt die Protokolldatei, sonst sucht die CLI sie unter ~/.claude/projects bzw. ~/.codex/sessions.

workban usage report                                  # die laufende Sitzung
workban usage report --all                            # alle Sitzungen mit Tasks in diesem Repo
workban usage report --session 9558c4ce-… --agent claude-code