lean-ctx

lean-ctx: 무엇인지, 어떤 문제를 해결하는지 & 왜 인기를 얻고 있는지

해결하는 문제

LeanCTX는 AI 에이전트의 토큰 낭비와 API 비용을 줄이기 위해 설계된 컨텍스트 엔지니어링 레이어입니다. 에이전트가 동일한 파일을 반복해서 읽거나 모델에 중복된 데이터를 보내는 것을 방지하여, 컨텍스트 윈도우 고갈 및 비용 상승 문제를 해결합니다. 또한 AI 에이전트가 서로 다른 채팅 세션 사이에서 메모리와 상태를 잃어버리는 "콜드 스타트" 문제도 해결합니다.

작동 방식

LeanCTX는 AI 에이전트와 그 환경(코드, 셸, 모델) 사이에 위치하는 로컬 Rust 바이너리로 작동합니다. 두 가지 주요 경로를 통해 컨텍스트를 관리합니다:

  • Read Path: MCP 서버와 셸 후크를 사용하여 에이전트가 데이터를 보기 전에 파일 읽기( map 또는 signatures와 같은 10가지 모드 사용) 및 셸 출력(git, npm 등의 패턴 압축)을 압축합니다.
  • Wire Path: 선택 사항인 로컬 프록시가 시스템 프롬프트와 히스토리를 포함하여 모델로 전송되는 모든 요청을 프롬프트 캐시를 유지하면서 압축합니다.

18개 언어의 구조적 이해를 위해 Tree-sitter AST를 활용하며, 영향 분석 및 검색 순위 산정을 위해 멀티 엣지 속성 그래프를 사용합니다. 모든 압축은 가역적(reversible)이므로, 모델이 콘텐츠 주소 지정 저장소(content-addressed storage)를 통해 원래의 바이트를 다시 가져올 수 있습니다.

대상 사용자

Cursor, Claude Code, Copilot, Windsurf, Gemini와 같은 AI 에이전트를 사용하는 개발자 중 API 비용을 낮추고, 코딩 세션을 연장하며, 채팅 간에 지속적인 메모리를 유지하고자 하는 사용자입니다.

주요 특징

  • 토큰 감소: 읽기 및 셸 출력에서 60–90% 더 적은 토큰 사용을 주장합니다.
  • 가역적 압축: 가지치기된 콘텐츠는 로컬에 저장되며 모델이 필요할 때 다시 불러올 수 있습니다.
  • 지속적 메모리: 세션 메모리와 지식 그래프를 통해 사실과 결정 사항이 서로 다른 채팅 세션 간에 유지됩니다.
  • 제로 설정 온보딩: 단일 lean-ctx onboard 명령어로 대부분의 인기 있는 AI 도구를 자동으로 감지하고 설정합니다.
  • 관측 가능성: 실시간 토큰 추적을 위한 브라우저 대시보드와 검증 가능한 절약 내역을 포함합니다.
  • 멀티 에이전트 지원: 에이전트 간의 핸드오프 및 공유 상태 관리를 위한 도구를 제공합니다.

Sources