Headroom Desktop

기능: 코드 생성 도구(Claude Code, OpenAI Codex, OpenCode AI, Grok Build)와 해당 도구가 호출하는 LLM API 사이에 위치하는 크로스 플랫폼 데스크톱 트레이 앱입니다. 로컬 최적화 파이프라인을 실행하여 프롬프트, 도구 출력 및 로그를 압축함으로써, 동일한 결과를 유지하면서 모델로 전송되는 토큰 수를 약 절반으로 줄입니다.

중요성: 토큰 사용량은 LLM 기반 코딩 어시스턴트의 주요 비용 발생 원인입니다. 요청이 모델에 도달하기 전에 상용구 코드, 중복된 JSON, 이전 대화 기록을 제거함으로써, Headroom은 워크플로우를 변경하지 않고도 Claude Code나 Codex 사용 비용을 절반으로 줄일 수 있습니다.

작동 방식:

• Tauri 기반의 Rust 트레이 앱이 127.0.0.1:6767에서 로컬 HTTP 프록시를 실행합니다.
• 코딩 클라이언트는 (작은 훅이나 환경 변수를 통해) 해당 프록시를 가리키도록 자동으로 재설정됩니다.
• 프록시는 요청을 두 번째 로컬 포트에서 관리되는 Python 런타임(headroom + 선택적 도구)으로 전달하여 최적화한 뒤, 실제 Anthropic 또는 OpenAI 엔드포인트로 전송합니다.
• 응답은 동일한 경로로 돌아오며, 필요에 따라 원본 콘텐츠가 복원됩니다.
• UI는 토큰 절감량, 클라이언트별 통계 및 선택적 추가 도구에 대한 실시간 대시보드를 제공합니다.

기술적 세부 사항:

• 호스트 오염 없음 – Headroom은 앱 데이터 폴더 내에 자체적인 독립형 Python(약 3GB)을 설치하며, 시스템 Python이나 전역 PATH를 전혀 건드리지 않습니다.
• 크로스 플랫폼 – macOS(universal), Windows 10+, Linux(preview) 빌드가 단일 태그에서 제공됩니다.
• 확장성 – 선택적 애드온(rtk, markitdown, serena 등)을 UI에서 활성화할 수 있으며, 모두 로컬에서 실행됩니다.
• 오픈 소스 셸 – 데스크톱 UI와 프록시 코드는 MIT 라이선스이며, 구독 서비스와 백엔드는 비공개입니다.
• 안전성 – 설정 변경 사항은 백업되며, 종료나 제거 시 모든 리다이렉트가 삭제되어 클라이언트가 이전과 동일하게 작동합니다.

사용 권장 대상: 이미 Claude Code, Codex, OpenCode 또는 Grok Build를 사용 중이며, 도구를 다시 작성하지 않고 토큰 비용을 절감하려는 개발자. 또한 예측 가능하고 로컬에서 호스팅되는 최적화 계층이 필요한 AI 에이전트 개발자에게도 적합합니다.

설치: macOS는 Homebrew cask를 사용하거나, GitHub 릴리스 페이지에서 DMG/EXE/AppImage를 직접 다운로드하십시오. 앱은 macOS에서 서명/공증되었으며 내장 업데이트 기능을 포함합니다.

라이선스: 데스크톱 셸(src/ 및 src-tauri/)은 MIT 라이선스입니다. 앱을 실행하려면 유료 Headroom 계정이 필요합니다(7일 무료 체험 제공).