yvgude/lean-ctx

해결하는 문제

LeanCTX는 AI 코딩 에이전트의 토큰 낭비와 API 비용을 줄이기 위해 설계된 AI 밸류 게이트 및 컨텍스트 엔지니어링 계층입니다. 에이전트가 변경되지 않은 파일 내용이나 노이즈가 많은 쉘 출력을 반복적으로 모델에 전송하는 일반적인 문제를 방지하여 컨텍스트 창을 소모하고 비용이 증가하는 것을 막습니다.

작동 방식

LeanCTX는 정보 흐름을 최적화하기 위해 두 가지 영역에서 작동합니다:

1. 읽기 경로: MCP 서버 및 쉘 훅으로 작동하며, AST 서명이나 엔트로피 필터링된 뷰와 같은 전용 읽기 모드를 제공하고, 에이전트가 보는 전에 일반적인 CLI 출력(예: git, npm, docker)을 압축합니다.
2. 와이어 경로: 에이전트와 모델 제공자 사이에 선택적 로컬 프록시를 두어, 시스템 프롬프트와 기록을 포함한 모든 요청을 압축하면서 프롬프트 캐시 안전 상태를 유지합니다.

27개 언어의 구조적 이해를 위해 Tree-sitter AST를 사용하고, 코드 분석에는 속성 그래프를 사용합니다. 모든 압축은 역변환이 가능하며, 제거된 콘텐츠는 모델이 필요할 때마다 검색할 수 있는 콘텐츠 주소 기반 저장소에 저장됩니다.

대상 사용자

Cursor, Claude Code, Copilot, Windsurf, Gemini와 같은 AI 코딩 에이전트를 사용하여 API 비용을 낮추고, 유용한 코딩 세션의 길이를 연장하며, 프로젝트의 컨텍스트와 메모리를 로컬에서 소유하고 싶은 개발자에게 적합합니다.

주요 특징

• 컨텍스트 압축: 데이터 손실 없이 토큰 사용량을 줄이기 위해 10개의 읽기 모드와 95개 이상의 쉘 출력 패턴을 제공합니다.
• 세션 메모리: 다양한 채팅 세션 간에 사실과 결정을 지속적으로 유지하여 "콜드 스타트"를 방지합니다.
• AI 밸류 게이트: 실시간 대시보드를 통해 토큰 사용량, 달러 절감액, 그리고 "승인된 결과당 비용(CPAO)" 메트릭을 추적할 수 있습니다.
• 모델 독립성: OpenAI, Anthropic, Gemini 등 다양한 LLM 제공자와 호환되며, 공급업체의 블랙박스에 컨텍스트를 고정하지 않습니다.
• 포터블 컨텍스트: 지식과 세션 데이터를 .ctxpkg 파일로 내보낼 수 있습니다.
• CPAO 추적: "샤도우 모드"를 사용하여 LeanCTX의 최적화된 컨텍스트를 베이스라인과 비교하여 실제 절감 효과를 입증합니다.