A Token Ledger for Unfunded Founders: Spending a 10,000,000-Token Free Allowance on Purpose

Description and use

Zero‑cost budget: classify tasks, log token usage, enforce limits, and auto‑deploy/tear‑down preview servers for solo developers.

Problem

Solo founders using free AI tiers run out of tokens unnoticed, causing build stops and wasted effort.

Outcome

Zero-cost budget workflow that prevents token exhaustion, enforces daily limits, and keeps preview servers from lingering.

Workflow

• Classify tasks before AI runs, assigning class A, B, or C.
• Run AI session and record token usage with token-ledger.sh charge.
• Execute token-ledger.sh check before each push or CI run to abort if budget exceeded.
• Deploy preview with preview-lifecycle.sh, run smoke tests, then tear down to free server space.
• Use token-ledger.sh summary to review spend by class.

Evidence

The usage numbers come from the AI tool's own session output and are written into the ledger with one command:

Source

The same check works as a CI gate. A workflow that calls token-ledger.sh check on every push fails the moment the allowance is gone, so the next commit starts with a conscious decision instead of a silent surprise.

Source