Repolode
yvgude

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. 1

    README에 나열된 패키지 관리자(npm, crates.io 또는 AUR)에서 LeanCTX를 설치합니다

  2. 2

    지원되는 AI 도구 연동을 구성합니다

    lean-ctx setup
  3. 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 통계는 매일 갱신됩니다.

관련 프로젝트