egent-code-plexus은(는) 무엇을 하나요?
LLM과 AI 에이전트를 위한 고성능 코드 인텔리전스 그래프입니다. 1초 미만의 구조적 쿼리, 영향 분석, 자율 코딩 워크플로우를 위한 교차 저장소 API 계약을 제공합니다.
개요
egent-code-plexus는 코드베이스의 구조적 관계를 실시간으로 분석하고 쿼리할 수 있는 인텔리전스 계층입니다. AI 에이전트가 대규모 코드베이스에서도 빠르게 컨텍스트를 파악하고, 안전하게 변경을 수행할 수 있도록 지원합니다.
주요 기능
- 1초 미만 구조적 쿼리: 심볼, 함수, 클래스, 파일 간의 관계를 밀리초 단위로 조회합니다.
- 영향 분석: 특정 코드 조각을 수정할 때 영향을 받는 모든 의존성을 자동으로 탐지합니다.
- 교차 저장소 API 계약: 여러 저장소 간의 API 시그니처, 타입, 호출 패턴을 추적합니다.
- 자율 워크플로우 통합: Claude Code, Cursor, Codex 등과 같은 AI 코딩 에이전트와 원활하게 통합됩니다.
사용 방법
설치
npm install -g egent-code-plexus
또는 프로젝트 내에서:
npm install --save-dev egent-code-plexus
초기화
plexus init
이 명령어는 현재 디렉토리와 그 하위 디렉토리(최대 3단계 깊이)의 코드 구조를 분석하여 인텔리전스 그래프를 생성합니다.
쿼리 예제
plexus query "getUser"
특정 함수의 모든 정의, 호출자, 의존성을 반환합니다.
plexus impact --file src/userService.ts --line 42
해당 파일 42번 줄의 변경이 전체 시스템에 미치는 영향을 분석합니다.
plexus contracts --repo api-gateway
api-gateway 저장소가 의존하는 모든 외부 API 계약을 나열합니다.
AI 에이전트 통합
Claude Code와 같은 AI 에이전트에서 다음 도구로 사용할 수 있습니다:
<use_mcp_tool>
<server_name>egent-code-plexus</server_name>
<tool_name>query_structure</tool_name>
<arguments>
{
"symbol": "processOrder",
"depth": 2
}
</arguments>
</use_mcp_tool>
지원되는 도구:
query_structure: 심볼이나 파일의 구조적 정보를 조회합니다.impact_analysis: 변경 사항의 영향을 분석합니다.get_contracts: 저장소 간 API 계약 정보를 가져옵니다.
환경 변수
| 변수 | 설명 | 기본값 |
|---|---|---|
PLEXUS_DATA_DIR | 인텔리전스 그래프 데이터 저장 경로 | ./.plexus |
PLEXUS_MAX_DEPTH | 쿼리 시 최대 재귀 깊이 | 5 |
PLEXUS_LOG_LEVEL | 로깅 레벨 (debug, info, warn, error) | info |
제한 사항
- 동적 언어(JavaScript, Python)의 경우, 정적 분석만으로 모든 런타임 관계를 포착하지 못할 수 있습니다.
- 매우 큰 모노레포(100만 줄 이상)의 경우 초기 그래프 생성에 몇 초가 소요될 수 있습니다.
- 교차 저장소 분석은 미리 설정된
plexus.config.json에 등록된 저장소에 대해서만 작동합니다.
라이선스
MIT