{"repo":"henchmarketing-rgb/headroom","free":true,"listed":false,"github":"https://github.com/henchmarketing-rgb/headroom","clone":"git clone https://github.com/henchmarketing-rgb/headroom.git","description":"Know your headroom. Context window usage bar for Claude Code.","language":"Shell","stars":68,"topics":["claude","claude-ai","claude-code","context-window","developer-tools","statusline"],"license":"MIT","category":"dev-tools","readme_excerpt":"headroom You're deep in a session. Claude starts dropping earlier context. Compaction fires mid-turn and takes work in progress with it. You had no warning. Claude Code gives you nothing on context usage. headroom fixes that. A live bar in your statusline, updated after every tool call. Now you can see the window filling up. Pace the session, decide when to /compact , or start fresh before things go sideways. Reads your actual session JSONL, not an estimate. Tracks the model you're running (not the env var), so it stays accurate when you switch mid-session. Per-directory, so multiple Claude Code windows don't bleed into each other. --- Install Restart Claude Code to activate. Requires: Python 3, Claude Code --- How it works A PostToolUse hook fires after every Bash , Agent , or Write call. It finds the most recently modified session JSONL in your project directory, reads the last token usage entry, and writes it to /.claude/ . The statusline picks that up and renders the bar. The model is read from the JSONL, not the ANTHROPIC MODEL env var, so it tracks correctly when you run /model mid-session. Sonnet 4.6 and the 1M context window: standard Sonnet 4.6 runs at 200k context. Only max effort mode ( /model then select max) unlocks the full 1M. Claude Code logs that as claude-sonnet-4-6[1m] in the session JSONL and headroom adjusts the ceiling automatically. High thinking still logs as claude-sonnet-4-6 and stays at 200k. --- Manual install Or copy the files yourself: File Desti","default_branch":null,"files":null,"tree":[],"storefront":"/r/henchmarketing-rgb","claimed":false,"request_supported":{"post":"https://gitbuyer.com/r/henchmarketing-rgb/headroom/request-supported","requests":0},"note":"indexed from public GitHub; nothing is for sale on this page. Clone it from GitHub. Paid listings live at /search."}