Codebase intelligence for AI and humans: code health scores, auto-generated docs, git analytics, dead code detection, and architectural decisions via MCP.

Repowise – 로컬, 자체 호스팅 코드베이스 인텔리전스

개요

Repowise는 리포지토리의 호출 그래프, Git 기록, 테스트, 문서 및 설계 결정에 대한 단일 로컬 인덱스를 구축하는 Python 기반 도구입니다. 인덱스는 온프레미스에 저장되며(API 키나 클라우드 서비스 불필요), 개발자나 MCP 호환 코딩 어시스턴트(Claude Code, Cursor, VS Code 확장 등)가 쿼리할 수 있습니다.

핵심 기능

영역	인덱스에 물어볼 수 있는 것	Repowise가 답하는 방법
코드 이해	"이 함수를 호출하는 것은?" "이 기능은 어디에 구현되어 있나?" "이 모듈은 왜 만들어졌나?"	호출 그래프(26개 언어)와 생성된 wiki에서 구축된 인용된 답변. 결정은 ADR, `# WHY:` 주석, 커밋 및 PR에 연결됩니다.
안전한 변경 관리	"`auth.py`를 수정하면 무엇이 깨지나?" "이 diff에 대해 어떤 테스트를 실행해야 하나?" "이 PR은 위험한가?"	그래프, 공동 변경 기록, 테스트 영향 추론 및 리포지토리 자체 최근 커밋과 비교한 0-10 위험 점수에서 기호 수준의 폭발 반경을 계산.
코드 건강 및 부채	"먼저 무엇을 수정해야 하나?" "죽은 코드는 어디에 있나?" "성능 핫스팟은 무엇인가?"	53개의 결정적 감지기가 파일별 건강 점수, 우선순위 수정 큐, 죽은 코드 신뢰도 수준 및 리팩토링 제안(메서드/클래스 추출, 파일 분할 등)을 생성.
문서	"이 모듈에 대한 문서를 알려줘." "어떤 문서가 오래되었나?"	자동 생성된 wiki(LLM 불필요)와 선택적 모델 작성 산문. 문서 드리프트 감지는 코드와 더 이상 일치하지 않는 markdown을 플래그합니다.
리포지토리 간 계약	"이 API 변경이 다른 서비스를 깨뜨릴까?"	HTTP, gRPC, OpenAPI, 토픽의 계약을 리포지토리 간에 매칭. 파괴적 변경 가드가 워크스페이스에 표시됩니다.
보안	"방금 비밀을 커밋했나?"	작업 트리와 전체 Git 기록에서 키, 토큰 및 위험한 호출을 스캔하고 pre-commit 및 CI 게이트를 제공.

사용 방법

설치 – uv tool install repowise(또는 pipx / pip).
초기화 – repowise init --yes --no-prose는 인덱스(그래프, Git, 건강, 죽은 코드, 문서)를 외부 API 키 없이 생성합니다.
서빙 – repowise serve는 로컬 대시보드와 MCP 서버를 실행하며 코딩 에이전트가 호출할 수 있습니다.
쿼리 – 에이전트는 get_overview, risk, distill과 같은 내장 도구를 호출하거나 CLI를 직접 사용할 수 있습니다(repowise risk main..HEAD, repowise distill pytest).

MCP 지원 에이전트에 한 줄 프롬프트를 보낼 수도 있습니다:

Read https://docs.repowise.dev/setup.md and set up Repowise in this repository.

에이전트가 자동으로 Repowise를 설치, 인덱싱 및 연결합니다.

증거 및 성능

‑31.6 % 43개 질문 벤치마크에서 에이전트 출력 감소(p < 0.0001).
2.3× CodeScene보다 더 많은 결함 발견(p = 0.003).
노트북에서 58,924개 파일을 약 2시간에 인덱싱.
Go 및 TypeScript에서 호출 그래프 정밀도 0.976‑0.995. 7개 데이터 세트에서 다른 6개 도구보다 우수.
모든 분석은 로컬에서 실행되며 핵심 계층에 LLM 호출이 필요 없습니다.

배포 옵션

자체 호스팅 – 대시보드와 MCP 서버를 온프레미스에서 실행(AGPL‑3.0).
호스팅 SaaS – repowise.dev는 동일한 기능에 더해 곧 출시될 Foresight 기능(실제 코드 변경 패턴으로 훈련된 모델)과 팀 워크스페이스를 제공.
엔터프라이즈 – 다중 리포지토리 워크스페이스, 규정 준수 보고, 크기 조정 지침 및 선택적 상용 라이선스를 지원.

대상 사용자

코딩 어시스턴트에 즉각적이고 정확한 컨텍스트를 제공하려는 개발자.
더 안전한 pull‑request, 테스트 선택 인텔리전스 및 위험 점수를 원하는 팀.
규정 준수를 위해 자체 호스팅, 제로 API 키 코드베이스 인텔리전스가 필요한 조직.
데이터 기반 순위로 기술 부채를 우선순위화하려는 모든 사람.

위의 모든 세부 사항은 리포지토리의 README에서 직접 가져온 것입니다. 외부 주장은 추가되지 않았습니다.

repowise-dev/repowise