henchmarketing-rgb

henchmarketing-rgb / headroom

Public

Know your headroom. Context window usage bar for Claude Code.

henchmarketing.online claude claude-ai claude-code context-window developer-tools
14
0
100% credibility
Found Apr 25, 2026 at 14 stars -- GitGems finds repos before they trend. Get early access to the next one.
Sign Up Free
AI Analysis
Shell
AI Summary

Headroom displays a real-time progress bar in the status line of Claude Code, tracking actual conversation memory usage to prevent context loss.

How It Works

1
😩 AI forgets early chat

You're deep into a helpful conversation with your AI coding buddy, but it starts dropping details from the beginning as things get long.

2
🔍 Find headroom helper

You discover headroom, a simple bar that shows exactly how full the conversation memory is, right in the bottom status area.

3
📥 Set it up quickly

Copy and run one easy line to add the memory tracker to your AI app's personal folder.

4
🔄 Restart your app

Close and reopen the AI coding app, and the new feature wakes up.

5
📊 See the filling bar

A colorful progress bar appears in the status line, like ████████░░ 78%, updating live after every action to show memory use.

6
💡 Manage chats wisely

Watch the bar fill and choose the perfect moment to summarize or start fresh, keeping everything smooth.

🎉 Endless smooth sessions

Now your long AI conversations stay sharp and productive without surprise forgetfulness.

Sign up to see the full architecture

5 more

Sign Up Free

Star Growth

See how this repo grew from 14 to 14 stars Sign Up Free
Repurpose This Repo

Repurpose is a Pro feature

Generate ready-to-use prompts for X threads, LinkedIn posts, blog posts, YouTube scripts, and more -- with full repo context baked in.

Unlock Repurpose
AI-Generated Review

What is headroom?

Headroom is a Shell-based tool that adds a live progress bar to your Claude Code statusline, showing real-time context window usage as a simple bar like "████████░░ 78.3%". It solves the blind spot where Claude drops earlier context or compacts mid-session without warning, by reading your actual session data per project directory. Install via a one-liner curl bash script, and it hooks into Claude Code's post-tool events for Bash, Agent, or Write calls—no estimates, just precise tracking that adjusts for model switches like Sonnet 4.6's 200k or 1M limits.

Why is it gaining traction?

Unlike vague env var guesses or manual checks, headroom pulls exact token counts from session JSONL files, stays accurate across model changes via /model commands, and works per-directory to avoid bleed between projects. Developers try it for the instant visibility that lets you pace sessions, compact proactively, or restart before losing work—headroom meaning that crucial buffer space before overflow. With 14 stars, it's niche but hooks Claude Code power users tired of surprises.

Who should use this?

Claude Code users running long AI-assisted coding sessions in Bash-heavy workflows, especially those switching models mid-project or juggling multiple directories. Ideal for backend devs building tools where context buildup kills momentum, or anyone evaluating must-know GitHub repos like this to get to know GitHub's hidden gems for AI dev.

Verdict

Grab it if you're deep in Claude Code—simple install, solid docs, and it just works for visibility you didn't know you needed. Low 1.0% credibility score and 14 stars signal early maturity with no tests, so test in a side project first; uninstall is a quick rm if it doesn't fit.

(178 words)

Sign up to read the full AI review Sign Up Free

Similar repos coming soon.