도구 출력과 로그는 대개 그대로 모델에 들어가서, 정작 중요한 맥락이 창 밖으로 밀려납니다. headroom은 그 앞단에 붙어 도구 출력·로그·파일·RAG 청크를 줄인 다음 넘깁니다. 라이브러리·프록시·MCP 서버 세 가지 형태로 붙일 수 있고 Apache-2.0으로 공개돼 있습니다. 저장소 설명은 코딩 에이전트 20%, JSON 60~95% 절감을 내걸지만 이는 저장소 쪽 수치입니다.
이걸로 무엇을 만들 수 있나
긴 로그를 줄여 넘기는 에이전트 앞단 프록시
토큰 비용을 낮추는 사내 RAG 전처리 단계
누구에게 맞나
개발자
긴 로그·도구 출력이 컨텍스트를 밀어낼 때
인프라 담당자
팀 전체 토큰 비용을 앞단에서 줄일 때
RAG 개발자
검색 청크를 모델에 넣기 전에 줄일 때
5분 안에 시작하기
$ pip install "headroom-ai[all]"$ headroom wrap claude$ headroom doctor# 코드 수정 없는 프록시 모드:$ headroom proxy --port 8787
주의할 점
wrap 명령은 Serena를 사용자 범위에 함께 설치합니다(--code-memory none으로 생략)
