Ingest
Claude JSONL + Grok signals. Sliding-window burn from files you already have.
R7 · AURORA VEIL · BEAM LOOP
token-oracle
know when you'll hit the limit
v01 · crystal beams · hero
Aurora DNA with a living crystal. Offline forecast from local logs — Claude and Grok trails, no cloud keys.
Scry the window
5h burn
◉ ~3h 12m left before the wall
Facet hue
01 · problem
Blind burn. Sudden wall.
Plan caps close mid-session. Claude and Grok leave trails in local logs — the shrine only needs what is already on disk. No cloud keys. No surprise lockouts if you scry first.
- No shared countdown across harnesses
- API-key dashboards refused
- Spend without time-left prophecy
02 · solution
Offline rate → purple prophecy
Forecast
Time left before 5h / weekly caps. Multi-sub profiles side by side.
Surface
oracle dash · statusline · report. Local only — zero provider keys.
03 · pillars
What holds the vision
01
Offline-first
No provider keys. Log files only. Soft-fail when trails are missing.
02
Multi-sub
Claude Max + Grok Heavy profiles — one oracle, two windows.
03
Past / Present / Future
Ledger history, live burn, prophecy tab — three tenses of the same math.
04
Statusline
Time-left in Claude / tmux chrome without leaving the session.
04 · quickstart
Run the oracle
npm, npx, uv, or pip — same offline forecast. Click to copy.
$
npm install -g token-oracle
#1 Node shim — bins:
token-oracle · oracle (runs uvx/pipx under the hood)
$
token-oracle init
#2 Guided setup (or
--preset max20)
$
token-oracle dash
#3 Full-screen past / present / future
$
token-oracle forecast
#4 Time left before your cap
$
npx token-oracle dash
#1 Instant — no global install
$
npx token-oracle forecast
#2 One-shot forecast
$
npx token-oracle init
#3 Configure profiles
$
uvx token-oracle dash
#1 Ephemeral Python runner (recommended pure path)
$
uv tool install token-oracle
#2 Install onto PATH via uv
$
token-oracle forecast
#3 Same CLI after install
$
pipx install token-oracle
#1 Isolated Python install
$
pip install token-oracle
#2 Into the current environment
$
token-oracle doctor
#3 Check config + data sources
✓ Real tool is Python on PyPI — npm/npx is a thin launcher.
05 · demo
See the burn
Forecast is offline math from local logs. The dash is the surface — not a cloud meter.
adapters banner · dash gif
shrine stills
Instruments of the vault
06 · brand
The classic shrine
The original oracle banner still belongs here — priestess, hourglass, clarity / foresight / confidence / intention.
oracle-banner · brand art