← back to writing
Github Repositories

Headroom - my latest discovery

Alright, I'm certainly not the fastest when it comes to discovering GitHub repositories, but I really liked this one.

Yann Kost May 6, 2026 · 4min read

So, first things first. What is headroom?

Basically it's a wrapper around Claude Code (or some other AI harnesses) and allows you to save some tokens using compression.

Personally I managed to make this work fairly well after some starting troubles, knowing that I'm working in WSL most of the time (darn you Microsoft!).

There were basically only two problems that I encountered:

  1. Headroom telemetry did slow the whole Claude Code system down
  2. Claude Code didn't handle file reads well when not using Headroom's MCP tools

The first problem I could quickly circumvent with the following command:

HEADROOM_TELEMETRY=off headroom wrap claude

The second one was more annoying: basically you either tell Claude Code directly to create a memory to use those MCP tools when it encounters trouble listing or reading files, or you create a custom hook that forces Claude Code to do so. Whatever you choose, it doesn't really matter. But once installed and correctly set up, I have to say I was impressed. The use of Claude Code itself hasn't changed, but its limits were effectively pushed back.

Anyway, I suggest you give it a shot. On my side I have been able to push my max subscription even further (x5, not the x20). So I'm honestly pretty happy with it.

https://github.com/headroomlabs-ai/headroom

Keep reading