한줄 요약
Headroom은 AI 에이전트가 읽는 모든 컨텍스트를 LLM에 전달하기 전에 압축하여 토큰 비용을 획기적으로 줄이는 오픈소스 도구다.
핵심 기능
라이브러리: Python/TypeScript에서 compress(messages) 호출로 인라인 압축
프록시: headroom proxy --port 8787로 코드 변경 없이 모든 언어에서 사용
에이전트 래퍼: headroom wrap claude|codex|cursor|aider|copilot 한 줄 명령으로 주요 AI 에이전트와 통합
MCP 서버: headroom_compress, headroom_retrieve, headroom_stats 도구 제공
크로스 에이전트 메모리: Claude, Codex, Gemini 간 공유 저장소, 자동 중복 제거
headroom learn: 실패한 세션을 분석하여 CLAUDE.md/AGENTS.md에 수정 사항 기록
역압축(CCR): 원본을 삭제하지 않고 필요시 LLM이 검색 가능
언제 쓰나
AI 에이전트(Claude Code, Cursor, Codex 등)의 컨텍스트 윈도우를 절약하고 비용을 줄이고자 할 때
RAG 시스템에서 검색된 청크를 압축하여 LLM 호출 비용을 낮추고자 할 때
로그, 도구 출력, 파일 등 대량의 텍스트를 LLM에 전달해야 하는 모든 상황
코드 변경 없이 기존 에이전트 워크플로에 투명하게 압축 계층을 추가하고자 할 때