Repolode
hystax

hystax/optscale-kompressor

코딩 에이전트의 프롬프트와 도구 출력을 결정론적으로 압축하고, 제거된 콘텐츠를 필요할 때 다시 가져올 수 있는 Rust 바이너리입니다.

스타
21
포크
6
열린 이슈
13
마지막 커밋
17시간 전

어떤 프로젝트인가요?

OptScale Kompressor는 Codex, Claude Code, Aider 같은 코딩 에이전트가 매 단계마다 모델에 다시 보내는 작업 기록의 크기를 줄입니다. 주로 긴 빌드 로그, 컴파일러 출력, 목록을 압축합니다. 결정론을 핵심으로 설계되어 같은 입력에는 매번 같은 바이트가 생성되므로 provider의 프롬프트 캐시가 계속 적중합니다. 제거된 각 조각은 콘텐츠 주소 지정 핸들에 저장되며, 모델은 retrieve 도구를 통해 해당 조각을 다시 가져올 수 있습니다.

이 프로젝트는 CLI, HTTP API, MCP 서버, 그리고 OpenAI Chat Completions, OpenAI Responses, Anthropic Messages용 LLM 프록시로 작동하는 단일 바이너리로 제공됩니다. `kompressor wrap codex` 명령은 프록시를 시작하고 에이전트가 프록시를 사용하도록 설정한 뒤 종료 시 정리합니다. 압축은 모델을 다운로드하지 않고 로컬에서 실행되며, 순서가 지정된 콘텐츠 감지와 소스 코드용 tree-sitter 문법을 사용합니다. 세 가지 모드를 제공합니다. aggressive(손실 압축), lossless(무손실), recoverable(기본값)입니다.

저장소에 따르면 Terminal-Bench 2.1의 89개 작업 실행에서 압축하지 않은 경우보다 비용이 22.7% 절감되었습니다. 이 수치는 프롬프트 캐시 할인을 포함한 provider 청구액을 기준으로 측정했습니다.

핵심 기능

  • 01결정론적 출력을 제공해 턴이 바뀌어도 프롬프트 캐시 적중률을 유지합니다.
  • 02핸들과 내장 retrieve 도구를 통해 제거된 콘텐츠를 다시 가져올 수 있습니다.
  • 03Codex, Claude, Aider, OpenCode, Cursor를 래핑하거나 모든 클라이언트용 프록시로 실행할 수 있습니다.
  • 04모델을 다운로드하지 않고 로컬에서 실행되며, 규칙 기반 감지와 코드용 tree-sitter를 사용합니다.
  • 05하나의 바이너리에서 CLI, HTTP API, MCP 서버, Rust 라이브러리를 제공합니다.

활용 사례

  • 빌드나 테스트 출력이 방대한 장시간 코딩 에이전트 세션의 토큰 비용 절감.
  • 도구 결과를 압축하는 공용 로컬 프록시를 통해 팀의 LLM 트래픽 라우팅.
  • MCP 서버를 지원하는 에이전트에 MCP 기반 압축 및 검색 기능 추가.

빠른 시작

  1. 1

    Cargo로 설치 (Rust 1.90 이상)

    cargo install --locked --git https://github.com/hystax/optscale-kompressor kompressor-cli
  2. 2

    compressor proxy를 통해 Codex 실행

    kompressor wrap codex

사용 전 알아둘 점

  • 자동 래핑은 Codex만 지원합니다. Claude Code는 압축 없이 그대로 전달됩니다.
  • 프록시가 프로토콜을 읽을 수 없어 Cursor-agent 요청은 거부됩니다.
  • 벤치마크 결과는 프로젝트 벤더인 OptScale AI가 자체 보고한 내용입니다.

토픽

자주 묻는 질문

optscale-kompressor은(는) 무엇인가요?
코딩 에이전트의 프롬프트와 도구 출력을 결정론적으로 압축하고, 제거된 콘텐츠를 필요할 때 다시 가져올 수 있는 Rust 바이너리입니다. OptScale Kompressor는 Codex, Claude Code, Aider 같은 코딩 에이전트가 매 단계마다 모델에 다시 보내는 작업 기록의 크기를 줄입니다. 주로 긴 빌드 로그, 컴파일러 출력, 목록을 압축합니다. 결정론을 핵심으로 설계되어 같은 입력에는 매번 같은 바이트가 생성되므로 provider의 프롬프트 캐시가 계속 적중합니다. 제거된 각 조각은 콘텐츠 주소 지정 핸들에 저장되며, 모델은 retrieve 도구를 통해 해당 조각을 다시 가져올 수 있습니다.
optscale-kompressor은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?
optscale-kompressor은(는) MIT 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.
optscale-kompressor은(는) 아직 유지보수되고 있나요?
활발히 유지보수 중. optscale-kompressor의 마지막 커밋은 2026년 10월 20일입니다.
optscale-kompressor은(는) 어디에 사용할 수 있나요?
빌드나 테스트 출력이 방대한 장시간 코딩 에이전트 세션의 토큰 비용 절감. 도구 결과를 압축하는 공용 로컬 프록시를 통해 팀의 LLM 트래픽 라우팅. MCP 서버를 지원하는 에이전트에 MCP 기반 압축 및 검색 기능 추가.
optscale-kompressor는 어떻게 설치하나요?
Cargo로 설치 (Rust 1.90 이상): cargo install --locked --git https://github.com/hystax/optscale-kompressor kompressor-cli compressor proxy를 통해 Codex 실행: kompressor wrap codex
optscale-kompressor은(는) 어디서 받을 수 있나요?
소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/hystax/optscale-kompressor

요약은 프로젝트 README를 바탕으로 AI가 작성했습니다. GitHub 통계는 매일 갱신됩니다.

관련 프로젝트