context-lens
Keeps context fill, growth and estimated headroom visible.
Source and capability notes checked · By Arunjay · Updated Oct 2, 2026
What context-lens looks like in use
No recording yet for context-lens. The repository README has the details.
Before you install
A mod is not sandboxed. It runs inside Claude Code with your permissions. This one:
- can read Context breakdown and recent per-turn token counts
Check it yourself before running it: git clone https://github.com/Arunjay4213/claude-mods && claude plugin validate ./ · Not stated licensed
Install
claude plugin marketplace add Arunjay4213/claude-mods
claude plugin install context-lens@claude-mods
Then run /context-lens inside the session.
Needs Claude Code 2.1.287 or later. After installing, run
/reload-plugins if the session was already open.
Full install guide
What changes after installation
A pinned line shows current fill, last-turn growth and a rough estimate of how many similar turns fit before compaction. /context-lens opens category bars and explains which limit the headroom uses.
After clear or compaction, growth history restarts rather than comparing unrelated windows.
Good to know
Turns remaining is a straight-line estimate, so one large read can move it sharply. Fresh sessions need a model response before the first meaningful reading. Use the explicit refresh only when you need a measured category breakdown.
Similar mods
context-inspector
Finds repeated reads, similar outputs and compaction-related waste.
cache-tax
Keeps the prompt cache warm during breaks and stops a cold send once — with its price.
cache-keeper
Combines cache timing, cold-send warnings, chat board and handoff.
agent-usage-guard
Holds a burst of subagents, a huge prompt or a retry loop before it eats your plan window.
Popular mods
agent-profiler
Breaks a session into model wait, tool and subagent time.
Agent Time Machine
Records tool calls and project snapshots on a branching timeline.
loop-detective
Collects evidence when the same Bash failure keeps repeating.
pin-memo
Keeps personal notes and todos above the prompt across resumes.