코드베이스를 위한 Karpathy 스타일 LLM 위키
Karpathy LLM Wiki for your Codebase
핵심 요약
대화 내용을 분석해 코드베이스 위키를 자동으로 업데이트하고 검색 가능하게 만드는 오픈소스 도구입니다.
- 자동 위키 생성 — CLI를 통해 코드베이스를 분석하고 대화 내용을 바탕으로 위키를 자동 업데이트함
- 로컬 데이터 관리 — 모든 데이터가 로컬에 저장되며 마크다운 형식으로 에이전트가 쉽게 참조 가능함
- 효율적 검색 — 토픽별로 구조화된 위키를 SQLite DB에 저장하여 빠른 정보 검색을 지원함
- 오픈소스 프로젝트 — 사용자의 API 구독을 활용하며 외부 서버로 데이터가 유출되지 않음
r/ClaudeAI 여러분 안녕하세요,
CodeAlmanac을 소개하고 싶습니다. 이건 여러분의 코드베이스를 위한 자동 업데이트 위키입니다. 작동 방식은 다음과 같습니다:
- CLI를 설치합니다.
- 에이전트를 선택합니다.
- 코드베이스를 훑어서 초기 위키를 만듭니다.
- 그 후, Claude/Codex와 나눈 대화를 바탕으로 5시간마다 대화 내용을 확인하고 논의된 중요한 내용을 토대로 위키를 업데이트합니다.
완전히 로컬에서 작동하고 마크다운 형식이므로 에이전트들이 이를 참조할 수 있습니다. 프로젝트에 대한 중요한 컨텍스트 중 상당수가 사실 대화 속에 녹아 있는데, 이제 에이전트들이 쉽게 쿼리할 수 있게 되었습니다.
이 위키는 구조화되어 토픽별로 정리되고 SQLite DB에 저장됩니다. 그래서 다음과 같은 쿼리가 가능합니다:
codealmanac search --topic auth
그러면 짜잔, 에이전트가 인증(auth)과 관련된 모든 페이지를 가져옵니다.
오픈소스이며 본인의 구독을 사용합니다. 데이터는 절대 컴퓨터 밖으로 나가지 않습니다.

