Context is inventory — know when to restock

LLM context economics,
in your terminal.

Most tools tell you how many tokens you spent. Session Watcher tells you whether the current context is still worth carrying.

Live Demo View on GitHub $ npx -y @nomadop/session-watcher demo
$ npx -y @nomadop/session-watcher replay /path-to-transcript

Try without installing — runs a self-contained demo or replays a real transcript

Based on the EOQ model — "Context Is Inventory", Cheng 2026

Observe → Select → Act
Observe

Live depth & bill premium

A real-time position gauge on the cost U-curve. Optimal at the sweet spot; bill premium signals WATCH at 10%, RESTART at 25%. The model measures; you decide.

vs. post-hoc: "your session yesterday cost $4.20"
Select

Context buckets

Per-path token attribution shows exactly which files, skills, and tools are eating context. Check what to keep, uncheck what to discard. The rebuild cost is the number you negotiate against.

vs. opaque: "200k tokens used" (but from where?)
Act

Handoff & reload

One click captures your selected paths + working state as a handoff package. Next session loads it in one command — only what you chose is rebuilt — no blind re-read of the whole working set.

vs. manual: re-read everything, re-explain the task, lose 10 min
How to install
# Add the marketplace
$ claude plugin marketplace add nomadop/session-watcher

# Install the plugin
$ claude plugin install session-watcher@session-watcher
What you see in your terminal
🟢 55% 0/5 · b+05% u1.0 · Δ500 L100k/b50k · opus

Claude Code statusline — updates every turn, zero context pollution
Requires one-time manual setup: see instructions

When it's time to restart
/sw-handoff next: wire up the auth refresh Reading context buckets… Handoff prepared. Token: refactor-auth-maple Next session: execute the plan task-by-task. /clear when ready.
/clear
/sw-load Loading handoff with token refactor-auth-maple Handoff loaded. Resuming: refactor auth module…

Prepare → clear stale context → reload in a fresh session. Only what you chose is rebuilt.