Waybill

Belege einreichen. Waybill ist eine Token-Abrechnung für KI-gestützte Arbeit – ein Claude Code-Plugin, das jeden Token zählt, ihn der Jira-Story zuordnet, die er ausgeliefert hat, und daraus Wertberichte, Leistungsbeurteilungs-Pakete und Token-Budget-Anfragen erstellt, die einer Prüfung standhalten.

Ein Waybill ist das Versanddokument, das die Fracht und ihre Kosten auflistet. Du versendest; Waybill führt die detaillierte Aufzeichnung.

Warum

Zwei Gespräche bestimmen einen Großteil des Jahres eines Ingenieurs, und beide basieren auf denselben fehlerhaften Eingaben:

• „Was war das KI-Budget wert?“ – Immer mehr Teams verteilen Claude-Tokens basierend auf nachgewiesenem Wert. Nutze sie gut, zeige es, bekomme mehr.

• „Was hast du in diesem Zyklus erreicht?“ – Leistungsbeurteilungen, Beförderungsanträge, Sprint-Reviews.

Menschen beantworten beides aus dem Gedächtnis, am Abend davor, in Adjektiven. Die entscheidende Person kann ehrliche Behauptungen nicht von übertriebenen unterscheiden, also zieht sie alles in Zweifel. Waybill behebt die Beweise, nicht die Überzeugungskraft: Es zeichnet Arbeit auf, während sie passiert, verknüpft jede Behauptung mit einem Artefakt – einem PR, einem Issue, einem Deploy-Tag, einem Transkript – und weigert sich, die Art von Behauptung zuzulassen, die deinen nächsten Pitch ignoriert.

Related MCP server: Token Analyzer MCP

Sechzig Sekunden bis zur ersten Quittung

claude plugin marketplace add Jakeintech/waybill
claude plugin install waybill@waybill

Sage dann in einer Claude Code-Sitzung „initialisiere mein Waybill-Hauptbuch“. Das ist die gesamte Einrichtung: keine Konten, keine Tokens, kein OAuth. Waybill bezieht deine Identität aus git config, importiert die Listenpreise von Anthropic, sodass Kosten ab dem ersten Tag erscheinen, überprüft deine Transkript-Aufbewahrungseinstellung und erstellt eine Bootstrap-Quittung allein aus deiner lokalen Git-Historie – deine ausgelieferte Arbeit, aufgeschlüsselt, in unter einer Minute.

Aktualisieren

Claude Code sendet keine Plugin-Update-Benachrichtigungen; das Aktualisieren erfolgt mit einem einzigen Befehl, wann immer du möchtest:

claude plugin update waybill@waybill

Starte dann Claude Code neu. waybill status (oder waybill --version) zeigt die ausgeführte Engine-Version. Waybill sucht niemals selbstständig nach Updates – keine Netzwerkaufrufe ohne deine Aufforderung ist eine Zusage, kein Versehen. Veröffentlichungen und Änderungsprotokolle befinden sich auf der Releases-Seite; beobachte das Repository (Watch → Custom → Releases), wenn du per E-Mail benachrichtigt werden möchtest.

Der Upgrade-Pfad (optional, fünf Minuten)

Die Verbindung deines Trackers und Git-Hosts verwandelt Commits in Quittungen mit Story Points, Epics und Merge-Zeitstempeln:

# Easiest — reuse your authenticated gh CLI:
export GITHUB_MCP_PAT="$(gh auth token)"
# Or mint a fine-grained read-only PAT (repos/PRs) at
# https://github.com/settings/personal-access-tokens and export it instead.

1. /mcp → schließe den OAuth-Flow für atlassian ab (kein Token nötig).

2. Sage „synchronisiere mein Hauptbuch und erstelle einen Bootstrap-Bericht.“

Du weißt nicht, was verbunden ist oder nicht? waybill status sagt es und gibt den genauen Befehl aus, um Fehlendes zu beheben.

Das importiert deine eigenen Issues und gemergten PRs der letzten ~90 Tage und erstellt einen reinen Faktenbericht – ausgelieferte Elemente, Punkte, PRs, Deploys – bevor du auch nur eine einzige Gewohnheit geändert hast. Ab dann ermöglicht das Öffnen von Aufgaben über das Hauptbuch die stärkeren Behauptungen (siehe Stufen unten).

So funktioniert es

Jeder Claude Code-Token wird deterministisch aus deinen lokalen Transkripten gemessen und der Story zugeordnet, der er diente, mit einem pro-Ereignis-Auflösernamen und -Konfidenz, einer Konservierungsprüfung (Σ zugeordnet = Σ beobachtet, pro Sitzung), die du offline mit waybill verify erneut ausführen kannst, einer Attribution-Inbox für die mehrdeutigen Reste und einer pro-Story-Verschwendungsdiagnose (was die Tokens gekauft haben – und was sie in Wiederholungsschleifen verschwendet haben). Ab Version 1.0 ist das Schema eingefroren: Die Quittungen sind der Vertrag.

Beweisstufen (die ganze Idee)

Jede Zahl in einem Bericht gibt an, woher sie stammt:

1. Fakten – Merge-Zeitstempel, Deploy-Tags, Story Points, Token-Anzahlen.

2. Basislinien-Deltas – deine eigene Vor-Claude-Geschwindigkeit/Zykluszeit im Vergleich zu jetzt.

3. Vorregistrierte Schätzungen – vor der Arbeit protokolliert, als Bereiche gemeldet.

4. Retrospektives Urteil – im Hauptbuch behalten, standardmäßig von Präsentationen ausgeschlossen.

Plus strukturelle Ehrlichkeit: Anhänge-only-Speicher (Korrekturen ersetzen, überschreiben nie), Bereiche werden nie auf Mittelwerte reduziert, Wert zählt nur, wenn gemergt oder deployed, und Kosten (ausgegebene Tokens, Nacharbeit) erscheinen in jeder Präsentation. Vollständige Regeln: Methodik.

Berichtsvorlagen

• token-pitch – die Anfrage, die Quittungen, das Ausgaben-Hauptbuch, der Effizienztrend, die Prognose.

• perf-review – Ergebnisse auf Epic-Ebene für einen Beurteilungszeitraum, einschließlich Review-/Incident-/Dokumentationsarbeit.

• sprint-recap / quarterly – die fortlaufende Aufzeichnung.

Berichte werden auf drei Zielgruppenebenen gerendert – self, internal, external – mit deterministischer Pseudonymisierung, bevor etwas die Organisation verlässt.

Was Waybill niemals tun wird

• Kein Manager-Modus, keine Überwachung. Es fragt nur deine zugewiesenen Issues und deine verfassten PRs ab.

• Kein Peer-Ranking. Die Methodik lehnt Vergleiche mit einzelnen Kollegen bewusst ab – du konkurrierst mit deiner eigenen Basislinie, nicht mit Dave.

• Kein gehosteter Dienst, keine Telemetrie. Alles befindet sich in ~/.waybill/ (einem lokalen Git-Repository, das dir gehört).

• Keine Zeiterfassung. Es zeichnet Ergebnisse und Schätzungen auf, nicht Tastatureingaben.

Dies sind Zusagen, keine Lücken. Siehe ROADMAP.md.

Pausieren, leiser stellen, verlassen

Das Vertrauen in ein Tool, das deine Arbeit aufzeichnet, beinhaltet, genau zu wissen, wie man es stoppt. Der vollständige Ausstiegspfad, vom Herunterfahren bis zum Verlassen:

• Messen pausieren (Kundenengagement, gemeinsam genutzter Rechner, Debugging): setze "metering": { "enabled": false } in ~/.waybill/config.json. Während der Pause wird nichts erfasst oder gemessen – waybill status meldet metering: PAUSED, sodass der Zustand niemals still ist. Vorhandene Daten bleiben unberührt; schalte es zurück, um fortzufahren.

• Die Redseligkeit reduzieren: "notices": { "level": "minimal" } behält nur Budgetschwellen-Zeilen ("off" schaltet alles stumm, was Waybill unaufgefordert sagt – die Messung läuft weiter). Die Verlängerungserinnerung (budgets.renewal_reminder_days, Standard 14) gehorcht demselben Schalter.

• Deine Daten mitnehmen: waybill export --format json (oder csv) gibt das Ausgaben-Hauptbuch aus; das gesamte Hauptbuch liegt bereits als einfaches JSONL in ~/.waybill/ – einem lokalen Git-Repository, das dir gehört. Kopiere es überall hin; nichts ist proprietär.

• Das Tool deinstallieren, die Daten behalten: claude plugin uninstall waybill@waybill, dann starte Claude Code neu. Hooks und Skills verschwinden; ~/.waybill/ bleibt dein Eigentum.

• Alles löschen: rm -rf ~/.waybill (oder $WAYBILL_HOME, falls du eines gesetzt hast). Das ist der gesamte Fußabdruck – Waybill führt keinen anderen Zustand. Sitzungstranskripte unter ~/.claude/ gehören zu Claude Code, nicht zu Waybill, und unterliegen dessen cleanupPeriodDays-Einstellung.

Im Vergleich zu den Alternativen

Dokumentation

• Tutorial: der Schnellstart dieser README, oben.

• Anleitung: Jira/GitHub durch Linear, GitLab, Bitbucket… ersetzen

• Referenz: Hauptbucheintrag & Konfigurationsschema · Skill-Referenz · Testplan – die Dokumente, die Claude liest, sind die Dokumente, die du liest.

• Erklärung: Wertmessungs-Methodik · Roadmap & Umfang · Marke & Stimme · Schema-Freeze & Migrationsrichtlinie

• Spezifikation: vollständige Produktspezifikation – das normative Design, das die ausgelieferte Engine implementiert.

FAQ

Funktioniert es ohne Jira oder GitHub? Ja – das ist der Standard. Der Git-Only-Modus benötigt keine Konfiguration und keine Authentifizierung: Messung, Zuordnung nach Branch/Pin und die Bootstrap-Quittung laufen alle aus lokalen Daten. Die Verbindung eines Trackers/Git-Hosts verbessert die Quittungen; jeder davon mit einem MCP-Server kann eingetauscht werden (Adapter).

Kann ich das für Leistungsbeurteilungen verwenden, wenn mein Unternehmen keine Tokens rationiert? Ja – das ist die perf-review-Vorlage. Der Token-Pitch ist ein Output des Hauptbuchs, nicht dessen Zweck.

Sind meine Daten privat? Lokales JSONL in deinem Home-Verzeichnis; die einzigen Netzwerkaufrufe sind die MCP-Aufrufe, die du autorisierst, beschränkt auf deine eigenen Elemente.

Warum vergleicht es mich nicht mit Teamkollegen? Story Points sind nicht zwischen Personen vergleichbar, das Auslesen von Kollegen wirkt wie Überwachung, und deine eigene Entwicklung ist ohnehin ein stärkerer Beweis. (Methodik §6)

Wie rechtfertige ich KI-Ausgaben gegenüber meinem Vorgesetzten? Führe sync aus, dann „erstelle meinen Token-Pitch“. Bringe die einseitige Zusammenfassung; behalte das Hauptbuch für die Rückfragen.

Mitwirken

Issues und PRs sind willkommen – siehe CONTRIBUTING.md, die Roadmap und Issues mit dem Label good first receipt. Adapter-Konfigurationen für andere Tracker sind der am meisten gewünschte Beitrag. Bitte lies den Verhaltenskodex; Sicherheitsmeldungen gehen über SECURITY.md.

Lizenz

MIT