time
223a4a0617
time/worker-run env | grep -E '^TIME_(WORKER|MODE|PLANNER|REVIEW)=' ; env -u TIME_WORKER -u TIME_MODE -u TIME_PLANNE
ci / test (pull_request) Successful in 35s
Spend ledger
Time keeps a record of what it spends on models. This folder holds it.
- One file per month:
time/ledger/<YYYY-MM>.jsonl, for example2026-10.jsonl. - One JSON line per model call. Fields:
at: when the call was made, ISO 8601 in UTC (2026-10-14T09:30:00Z).model: the model that was called.in: input (prompt) tokens.out: output (completion) tokens.usd: the cost in US dollars, ornullif the seat has no price (unpriced seats).
Example line:
{"at":"2026-10-14T09:30:00Z","model":"some-model","in":1200,"out":350,"usd":0.0123}
Who writes and reads it
- Written by Time itself. At the end of each run, Time appends that run's calls to the current month's file in one
ledger:commit. - Read by the heartbeat. It adds up
usdfor today and for the month and compares the totals with the capsTIME_DAILY_USDandTIME_MONTHLY_USD. Anullcounts as zero.
When a cap trips
Time stops calling models and opens an issue labelled andon. A monthly cap also sets TIME_MODE=dry-run until a human raises the cap. A daily cap clears itself at midnight UTC. Close the issue once it is handled.
Don't edit it by hand
Humans should never edit these files. The caps rely on them being exact, and Time only ever appends. A hand edit can hide spend or break the next append.