TESIGN
SAVED

EN · KO

  1. TESIGN / RADAR
  2. Headroom

Headroom

Compress what your agent reads

WHO USES ITDeveloper · Infra owner · RAG developer

For developers

Compresses tool output, logs and files before they reach the model.

★ 72.3k▲ +185 / 7dDaily star increases over 14 days. Hollow bars mean no data. The last day may be partial.2026-09-03 no data2026-09-04 +362026-09-05 +352026-09-06 +332026-09-07 +242026-09-08 no data2026-09-09 +92026-09-10 +172026-09-11 +602026-09-12 +422026-09-13 +182026-09-14 +112026-09-15 +272026-09-16 +6largest one-day increase in the 14 days+60last 14 days · stars per dayhollow = no data

72,323 stars · checked on GitHub GitHub check 30 h late · incl. +6 observed via GH Archive since then · 7-day +185 observed via GH Archive (as of )

RANKS All-time #77

Headroom docs introduction page: a table of contents at left, intro text and a TypeScript code preview calling compress.

TESIGN TAKE

It drops in as a proxy without touching agent code, so you can measure savings on your own traffic first.

USE PACKAGE

AT A GLANCE

LICENSE
Apache-2.0
USAGE
Commercial use, redistribution OK. Keep notices; mark changes.
LANGUAGE
Python
PLATFORM
windows · macos · linux · cli
ACTIVITY
last commit 1 day ago () · latest release v0.37.0 () · 169 releases
COMMUNITY
265 contributors · 654 open issues (incl. PRs) · made by: an organization
SOURCES
GitHub
OPEN SOURCE
YES
FIRST SEEN
CATEGORY
AI · LIBRARY

A summary, not legal advice.

WHY IT MATTERS

Tool output and logs usually reach the model untouched, pushing the context that matters out of the window. headroom sits in front of that path and compresses tool output, logs, files and RAG chunks before they are sent. It attaches as a library, a proxy or an MCP server and is published under Apache-2.0. The repository claims 20% fewer tokens for coding agents and 60-95% for JSON; those figures are its own.

BUILD FROM THIS

  • A proxy in front of the agent that shrinks long logs on the way through
  • An internal RAG preprocessing step that lowers token cost

WHO IT'S FOR

Developer
long logs and tool output keep crowding the context
Infra owner
cuts team-wide token cost at the proxy layer
RAG developer
shrinks retrieved chunks before they reach the model

START IN 5 MINUTES

$ pip install "headroom-ai[all]"
$ headroom wrap claude
$ headroom doctor
# Proxy mode with no code changes:
$ headroom proxy --port 8787

CAVEATS

  • headroom wrap also installs Serena at user scope (skip with --code-memory none)
  • Intel Macs have no native wheel; the README points to the Docker install
  • Savings are the repository's own benchmark and grow with repetitive data

RECEIPT

FIRST SEEN
AT SOURCE
KEPT
STAR DELTA
+6 ★ / 24h
CREATED → FIRST SEEN
248d
WHEN FIRST SEEN
71,807 ★
SOURCES
GitHub

The same facts in machine-readable form — View as Markdown · JSON

SIMILAR TOOLS

Up to five from AI by ★ total: edited entries first, then repository cards; this entry is highlighted. Drawn from the same stored snapshot as the rankings — a comparison, not a recommendation.

IMAGENAME★ TOTAL▲ 7dLICENSEPLATFORMLAST PUSH
ECC README banner: headline 'The operating system for AI agent harnesses', harness chips, and skill, agent and command lists.
eccSkills, memory and security for agents★ 259k▲ +832MITpermissivewindows · macos · linux · cli
Hermes Agent landing: blue background, the headline 'The agent that grows with you' and an engraving-style winged figure.
Hermes AgentSelf-improving personal agent★ 246k▲ +375MITpermissivelinux · macos · windows · android · cli
DeepSeek Harness landing: blue background, the headline 'Everything is a plugin' and a quick-start box with the npx command.
DeepSeek HarnessPlugin agent harness for developers★ 225k▲ +1,356MITpermissiveweb · cli
Headroom docs introduction page: a table of contents at left, intro text and a TypeScript code preview calling compress.
HeadroomCompress what your agent readsTHIS ENTRY★ 72.3k▲ +185Apache-2.0permissivewindows · macos · linux · cli
mattpocock/skillsCARD★ 261k▲ +872MITpermissive—

ALSO WORTH SEEING

OpenHunterAILocal AI red-team workspaceOpenHunterAI's homepage, labelled "AUTHORIZED EXTERNAL SECURITY TESTING," listing its five-stage process from scope verification to reporting.Self-host
★ 165▲ +15 / 7d
An alpha-stage local workspace that runs attacker-style security assessments — strictly against public targets you own or are authorized to test.MartinLoopExecution-control CLI for coding agentsMartinLoop's homepage headline: "Watch your AI burn $5.20. Then watch MartinLoop close the loop for $2.30."
★ 130▲ +21 / 7d
Wraps a coding agent with a spend cap and a verifier, so "I'm done" comes with an evidence-backed receipt instead of just a claim.Spec KitSpec-first process for coding agentsSpec Kit docs landing page — the headline 'Build with a spec, fix a bug, or assess an idea' and the uv tool install specify-cli commandInstall to use
★ 137k▲ +560 / 7d
Makes your coding agent write the spec first, then plan, build and verify against it.HindsightNarrative map for YouTube viewersHindsight landing page: thousands of video dots grouped into issue clusters, with a central search box for a topic, creator or YouTube link.Use in the browser
★ 0▲ 1 HN
Remembers 49,411 videos, maps 22,904 by issue, traces how a YouTuber's argument changed.

TIMELINE

  1. Repository created
  2. FIRST SEEN BY TESIGN