ledger

Manages the append-only waybill ledger storing work entries, metered token usage, and attribution records.

1|Updated Aug 17, 2026
One-click install
npx skills add https://github.com/Jakeintech/waybill --skill ledger-jakeintech
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: ledger
Source: https://github.com/Jakeintech/waybill/tree/main/skills/ledger
Command: npx skills add https://github.com/Jakeintech/waybill --skill ledger-jakeintech

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? It gives you a local, verifiable record of shipped work and AI token spend, so every value claim about AI-assisted development traces back to checkable events instead of estimates. ## Core Features & Use Cases - Ledger initialization and health checks: Set up the ledger home, seed identity and pricing, and run integrity and conservation verification with the bundled CLI. - Append-only event storage: Read and write work entries, usage events, session receipts, and corrections across monthly-sharded JSONL streams with deterministic ULIDs. - Attribution and portability: Pin sessions to tracker keys, export a redacted career ledger, and keep every token conserved and accounted for. - Use Case: After finishing a feature with Claude, ask to log the shipped item with its pre-registered estimate; the skill appends a sealed event, attributes the metered tokens to the tracker key, and the receipt is ready for your next report. ## Quick Start Ask the assistant to initialize your waybill ledger and show what has been logged so far.

Frequently Asked Questions about ledger

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I initialize the waybill ledger?▼

Run the waybill CLI init command, which creates the ledger home as a git repo, seeds identity from git config, imports list-price rates, and meters existing Claude Code transcripts. The first receipt renders from local git history in under a minute with zero authentication.

How do I log shipped work with token attribution?▼

Construct an event per the schema reference and append it via the waybill CLI append command, which validates the envelope, assigns a deterministic ULID, and commits. Metered tokens join to the entry through the attribution tracker key, never through hand-built JSONL.

Can I edit or delete a ledger entry after writing it?▼

No, the ledger is strictly append-only. Corrections are new events with kind correction and a supersedes field pointing at the old event's id; the latest non-superseded event is authoritative.

Does the ledger work without GitHub or Jira accounts?▼

Yes, the zero-config default is git-only mode with no tracker and no auth. The bootstrap command renders a receipt from local git history, and sync can upgrade tracker and git integrations later when MCP servers are connected.

How does the ledger verify token conservation?▼

The verify command recomputes every deterministic id and escrow hash, then checks that the sum of attributed tokens per session equals the session receipt's source totals per token class. Any mismatch is reported as a meter discrepancy event.

Can I take my ledger data when changing jobs?▼

Yes, the export command with external audience produces a redacted career ledger where keys, titles, and repos are pseudonymized while numbers and dates survive. The ledger home is also a plain git repo you can clone anywhere.