lean-ctx은(는) 무엇을 하나요?
LeanCTX (Lean Context) — AI 에이전트를 위한 컨텍스트 인텔리전스입니다. 하나의 로컬 바이너리로 에이전트가 읽을 내용을 결정하고, 학습한 내용을 기억하며, 접근하는 데이터를 보호하고, 저장한 내용을 증명합니다. 결과적으로 토큰 사용량을 60~90% 절감합니다. 30개 이상의 도구, Rust 기반, 로컬 우선.
개요
LeanCTX는 AI 코딩 에이전트(예: Claude Code, Cursor, Codex)가 작업하는 동안 컨텍스트를 지능적으로 관리하도록 돕는 로컬 CLI 도구입니다.
주요 기능
- 컨텍스트 결정: 에이전트가 프로젝트 파일을 읽을 때 중요도와 관련성에 따라 무엇을 읽을지 결정합니다.
- 메모리 관리: 에이전트가 이전에 학습한 내용을 저장하고 필요할 때 검색합니다.
- 접근 제어: 민감한 파일이나 디렉토리에 대한 접근을 차단하거나 경고합니다.
- 변경 증명: 파일 변경 사항을 검증 가능한 해시와 함께 저장하여 추적 가능하게 합니다.
- 토큰 최적화: 불필요한 컨텍스트를 제거하여 토큰 사용량을 최대 90%까지 절감합니다.
설치 방법
# Homebrew (macOS/Linux)
brew install yvgude/tap/lean-ctx
# 직접 다운로드 (릴리즈 페이지 참조)
curl -fsSL https://github.com/yvgude/lean-ctx/releases/latest/download/lean-ctx-$(uname -s)-$(uname -m).tar.gz | tar xz
sudo mv lean-ctx /usr/local/bin/
사용 방법
초기화
프로젝트에서 LeanCTX를 초기화합니다:
cd your-project
touch .leanctx/config.yaml
설정 예시
.leanctx/config.yaml 파일:
# 컨텍스트 규칙
context:
include:
- "src/**/*.ts"
- "README.md"
exclude:
- "node_modules/**"
- "dist/**"
- "*.log"
# 접근 제어
guard:
sensitive:
- ".env"
- "config/credentials.*"
# 메모리 저장
memory:
enabled: true
max_entries: 100
에이전트와 통합
Claude Code와 함께 사용하려면:
eval "$(lean-ctx init --shell zsh)"
이 명령어는 LeanCTX의 도구와 명령어를 현재 셸 세션에서 사용할 수 있게 합니다.
주요 명령어
| 명령어 | 설명 |
|---|---|
lean-ctx analyze <file> | 파일의 컨텍스트 중요도 분석 |
lean-ctx remember <key> <value> | 특정 키에 값 저장 |
lean-ctx recall <key> | 저장된 값 검색 |
lean-ctx guard <path> | 경로에 접근 제어 설정 |
lean-ctx prove <file> | 파일의 변경 증명 생성 |
lean-ctx status | 현재 컨텍스트 상태 보기 |
상세 문서
더 자세한 내용은 GitHub 저장소를 참조하세요.
라이선스
MIT