AI 코딩 에이전트가 비즈니스를 모델링하고, 모델을 평가·수정한 뒤 타입이 지정된 애플리케이션을 생성하고 결과를 검증하도록 돕는 모델 중심 하네스입니다.
yvgude/lean-ctx
AI 코딩 도구가 읽는 컨텍스트를 필터링하고 압축하는 오픈소스 Rust 엔진으로, MCP 서버, 셸 훅, 로컬 감사 기록을 제공합니다.
- 스타
- 3,897
- 포크
- 356
- 열린 이슈
- 10
- 마지막 커밋
- 13시간 전
어떤 프로젝트인가요?
LeanCTX는 AI 도구를 위한 컨텍스트 게이트웨이입니다. AI 코딩 에이전트와 에이전트가 읽는 파일, 셸 출력, 도구 결과 사이에 위치해 작업에 필요한 내용을 선별하고 반복되거나 불필요한 입력을 줄여 컨텍스트 윈도우를 효율적으로 사용합니다.
오픈소스 Engine은 CLI, MCP 서버, 셸 훅, 선택형 요청 프록시를 통해 로컬에서 실행됩니다. 전체 보기, 맵, 시그니처, diff, 줄 범위 보기 등의 읽기 모드를 지원하며, git, npm, cargo, docker, kubectl 같은 도구의 셸 출력도 압축합니다. Tree-sitter 파싱은 27개 언어를 지원하고, 설정된 경로 권한, 콘텐츠 필터, 컨텍스트 예산은 지원되는 경로에 적용됩니다.
이 프로젝트는 로컬 세션 메모리와 영향 분석을 위한 코드 속성 그래프도 유지하며, 컨텍스트 작업 기록은 `lean-ctx inspect` 또는 브라우저 대시보드에서 확인할 수 있습니다. Cursor, Claude Code, Codex 같은 지원 에이전트는 `lean-ctx wrap`으로 설정합니다.
핵심 기능
- 01구조 맵, 시그니처, 줄 범위 등을 포함한 다양한 파일 읽기 모드를 제공하며, 캐시된 파일을 다시 읽을 때는 간결한 참조를 반환합니다.
- 02git, npm, cargo, docker, kubectl 같은 주요 도구의 셸 출력을 압축합니다.
- 0327개 언어를 대상으로 Tree-sitter 구조 파싱을 제공합니다.
- 04로컬 세션 메모리와 영향 분석용 코드 속성 그래프를 제공합니다.
- 05지원되는 경로에 설정된 경로 권한, 콘텐츠 필터, 컨텍스트 예산을 적용합니다.
- 06컨텍스트 활동을 확인할 수 있는 로컬 CLI, MCP 서버, 브라우저 대시보드를 제공합니다.
활용 사례
- 대규모 저장소에서 작업하는 AI 코딩 에이전트의 토큰 사용량을 줄입니다.
- 셸 작업이 많은 에이전트 세션에서 빌드 및 테스트 로그가 컨텍스트 윈도우를 가득 채우지 않도록 합니다.
- 작업 및 의사결정 기록을 보존해 여러 채팅 세션에 걸쳐 장기 프로젝트를 이어갑니다.
- AI 도구의 파일 시스템 접근을 설정된 프로젝트 범위로 제한합니다.
빠른 시작
- 1
README에 나열된 패키지 관리자(npm, crates.io 또는 AUR)에서 LeanCTX를 설치합니다
- 2
지원되는 AI 도구 연동을 구성합니다
lean-ctx setup - 3
한동안 사용한 후 로컬 토큰 절감량을 확인합니다
lean-ctx savings
사용 전 알아둘 점
- README에는 라이선스가 혼합되어 있다고 명시되어 있지만 메타데이터에는 Apache-2.0으로 기재되어 있으므로, 상업적으로 사용하기 전에 LICENSE.md를 확인하세요.
- 멀티 에이전트 핸드오프, 컨텍스트 패키지, 스냅샷, 애드온 등의 여러 기능은 실험적 Research로 표시되어 있습니다.
- Shadow Mode의 절감량은 측정 결과가 아닌 시뮬레이션 추정치이며, 답변 품질을 입증하지 않습니다.
포함된 컬렉션
토픽
자주 묻는 질문
- lean-ctx은(는) 무엇인가요?
- AI 코딩 도구가 읽는 컨텍스트를 필터링하고 압축하는 오픈소스 Rust 엔진으로, MCP 서버, 셸 훅, 로컬 감사 기록을 제공합니다. LeanCTX는 AI 도구를 위한 컨텍스트 게이트웨이입니다. AI 코딩 에이전트와 에이전트가 읽는 파일, 셸 출력, 도구 결과 사이에 위치해 작업에 필요한 내용을 선별하고 반복되거나 불필요한 입력을 줄여 컨텍스트 윈도우를 효율적으로 사용합니다.
- lean-ctx은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?
- lean-ctx은(는) Apache-2.0 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.
- lean-ctx은(는) 아직 유지보수되고 있나요?
- 활발히 유지보수 중. lean-ctx의 마지막 커밋은 2026년 10월 24일입니다.
- lean-ctx은(는) 어디에 사용할 수 있나요?
- 대규모 저장소에서 작업하는 AI 코딩 에이전트의 토큰 사용량을 줄입니다. 셸 작업이 많은 에이전트 세션에서 빌드 및 테스트 로그가 컨텍스트 윈도우를 가득 채우지 않도록 합니다. 작업 및 의사결정 기록을 보존해 여러 채팅 세션에 걸쳐 장기 프로젝트를 이어갑니다. AI 도구의 파일 시스템 접근을 설정된 프로젝트 범위로 제한합니다.
- lean-ctx는 어떻게 설치하나요?
- README에 나열된 패키지 관리자(npm, crates.io 또는 AUR)에서 LeanCTX를 설치합니다 지원되는 AI 도구 연동을 구성합니다: lean-ctx setup 한동안 사용한 후 로컬 토큰 절감량을 확인합니다: lean-ctx savings
- lean-ctx은(는) 어디서 받을 수 있나요?
- 소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/yvgude/lean-ctx
요약은 프로젝트 README를 바탕으로 AI가 작성했습니다. GitHub 통계는 매일 갱신됩니다.
관련 프로젝트
pi 기반 코딩 에이전트로, 권한 확인이나 컨텍스트 정리 같은 일상적인 판단을 소형 판정 모델에 맡겨 메인 모델이 코드에 집중하도록 합니다.
VS Code, JetBrains IDE 또는 터미널에서 실행되고 500개 이상의 모델을 이용할 수 있는 오픈소스 AI 코딩 에이전트입니다.
LLM을 실제 프로젝트 파일, 도구, 권한, 검증 및 컨텍스트에 연결하는 로컬 우선·근거 우선 AI 코딩 터미널입니다.
자가 교정 메모리와 영구 FTS5 리서치 위키를 제공하는 Claude Code 플러그인
코드베이스를 스캔해 AI 코딩 도우미가 프로젝트를 탐색하는 데 쓰는 토큰을 줄여 주는 간결한 컨텍스트 파일을 생성하는 CLI입니다.