CodeLens MCP 문서 | CodeLens MCP

CodeLens MCP는 코딩 에이전트를 위한 살아 있는 코드 인덱스입니다. MCP host가 대화를 소유하는 동안 CodeLens는 저장소 구조를 인덱싱하고, 필요한 맥락을 제한된 크기로 제공하며, 안전한 변경을 위한 session·mutation·검증 경계를 관리합니다.

_{English: CodeLens is a live code index for coding agents. It provides bounded retrieval, verifiable structure, host-neutral workflows, single-writer sessions, and mutation gates without taking over the host conversation.}

목적	기본 경로
저장소 파악	`prepare_harness_session` → `overview` / `search`
호출·의존 흐름 추적	`graph(mode="callers")` / `graph(mode="callees")` / `graph(mode="trace")`
아키텍처·변경 검토	`review(mode="architecture")` / `review(mode="changes")`
진단·검증	`diagnose` → `verify_change_readiness`

최근 하이라이트 (v1.13.34 이후 main)

Host-neutral 실행 계약 — Codex, Claude Code, Cursor 등 host가 대화를 소유하고 CodeLens는 공통 MCP code-intelligence·검증 계층으로 동작합니다. 상세: ADR-0015.
Single-writer project runtime — shared consumption daemon은 :7838, repo-local development daemon은 :7736을 사용하며 readonly/review/builder는 endpoint가 아니라 session profile로 분리됩니다. 상세: HTTP daemon operations, ADR-0017.
Session identity hardening — session binding과 coordination 경계를 명시해 동시 작업에서 잘못된 project context와 stale claim을 줄입니다. 상세: ADR-0018.
Verb facade 표면 — 읽기 계열 도구를 6개 mode-routed verb(search/graph/review/overview/diagnose/analyze) 뒤로 통합, 부트스트랩 노출을 ~9개로 축소. 기존 도구 ID는 전부 유지·호출 가능 (#377).
순환 의존 검출 정밀화 — #[cfg(test)] 전용 import가 유령 순환을 만들던 오탐을 3값 cfg 평가 + 소비자단 정제 패스로 봉합. dead-code/blast-radius/PageRank는 전체 그래프를 그대로 유지.
Stage-5 압축이 오류 대신 요약으로 강등 — output_schema 없는 도구(verb facade 포함)도 data_preview + 보정된 recovery_hint를 text 채널로 수신. 호스트 25K-char truncated 상한과 프리뷰 상한을 공유 상수로 조정. 상세: Response envelope.
데몬 드리프트 신호 정밀화 — hooks/docs만 바뀐 binary-equivalent lag에는 재시작 경고를 억제(fail-open 유지). 상세: HTTP daemon operations.
refresh_symbol_index background 모드 — 대량 리인덱스를 job-handle(get_analysis_job 폴링)로 수행해 MCP 타임아웃 회피.
Claude 클라이언트 패리티 — 기본 budget 6000 + lean tool contract로 tools/list 토큰 대폭 절감 (#377).

릴리스

먼저 볼 문서

README — 제품 소개, 설치, 기본 설정
Platform setup — Claude Code, Cursor, VS Code, Codex, Windsurf 연결
Harness modes — 역할 기반 profile과 preset
Multi-agent integration — HTTP daemon, coordination, delegation
Architecture overview — 한글 아키텍처 요약, Mermaid 다이어그램, 요청 처리 흐름, 핵심 코드 지도
Release verification — 릴리스 검증 절차

Operations

Response envelope & compression — effort level, 5-stage 적응 압축(stage-5 요약 강등), lean contract, doom-loop 보호, index 신선도 신호
HTTP daemon operations — launchd 데몬 배포/재배포, 드리프트 신호 의미론, exit-78 웨지 복구, codesigning
Runtime knobs — semantic edit backend, 분석 캐시, 백업 회전
Tool routing matrix — CodeLens vs grep 시나리오 매트릭스, 규모 의존성 측정

Reference

Benchmarks

Decision Records

Release Notes

Per-release notes remain available in the GitHub release-notes directory. Changelog history in ../CHANGELOG.md.

Current Release

Archived

Historical plans, superseded audits, and completed decomposition work remain available in the GitHub archive directory.