{
 "schema_version": 1,
 "generated": "2026-10-20",
 "repo": "headroomlabs-ai/headroom",
 "name": "headroom",
 "owner": "headroomlabs-ai",
 "slug": "headroomlabs-ai-headroom",
 "github": "https://github.com/headroomlabs-ai/headroom",
 "what": "Headroom is an open-source tool that compresses tool outputs, logs, files, RAG chunks and chat history on your machine before they reach an LLM, available as a Python or TypeScript library, a local proxy, and an MCP server.",
 "why": "",
 "language": "Python",
 "requirements": [
  "Python 3.13 with uv, or pip, to install the headroom-ai package",
  "An account with an LLM provider such as Anthropic or OpenAI",
  "A coding agent or app that sends prompts through an API"
 ],
 "audience_note": "Developers and platform teams who run coding agents or LLM apps and want fewer tokens sent and billed per request.",
 "risk": "none",
 "section": "earlier",
 "weekly_rank": null,
 "category": "Software and DevOps",
 "url": "https://dedupedai.com/use-cases/headroomlabs-ai-headroom/",
 "use_case_count": 4,
 "use_cases": [
  {
   "id": "headroomlabs-ai-headroom--cut-token-spend-in-claude-code",
   "title": "Cut Claude Code token use with one wrap command",
   "best": true,
   "url": "https://dedupedai.com/use-cases/headroomlabs-ai-headroom/cut-token-spend-in-claude-code/",
   "json": "https://dedupedai.com/use-cases/u/headroomlabs-ai-headroom/cut-token-spend-in-claude-code.json"
  },
  {
   "id": "headroomlabs-ai-headroom--compress-llm-calls-in-python-app",
   "title": "Shrink messages in a Python app before each LLM call",
   "best": false,
   "url": "https://dedupedai.com/use-cases/headroomlabs-ai-headroom/compress-llm-calls-in-python-app/",
   "json": "https://dedupedai.com/use-cases/u/headroomlabs-ai-headroom/compress-llm-calls-in-python-app.json"
  },
  {
   "id": "headroomlabs-ai-headroom--route-any-openai-client-through-proxy",
   "title": "Route any OpenAI-compatible client through a local proxy",
   "best": false,
   "url": "https://dedupedai.com/use-cases/headroomlabs-ai-headroom/route-any-openai-client-through-proxy/",
   "json": "https://dedupedai.com/use-cases/u/headroomlabs-ai-headroom/route-any-openai-client-through-proxy.json"
  },
  {
   "id": "headroomlabs-ai-headroom--let-agents-retrieve-full-compressed-text",
   "title": "Give an MCP client on-demand access to full originals",
   "best": false,
   "url": "https://dedupedai.com/use-cases/headroomlabs-ai-headroom/let-agents-retrieve-full-compressed-text/",
   "json": "https://dedupedai.com/use-cases/u/headroomlabs-ai-headroom/let-agents-retrieve-full-compressed-text.json"
  }
 ],
 "disclaimer": "Third-party repos we don't own or vouch for. AI-generated use cases can be wrong: review everything and run at your own risk."
}