CodeAlmanac - Karpathy-style codebase wiki from AI conversations
Show HN: CodeAlmanac – Karpathy-style codebase wiki from your conversations
CodeAlmanac은 AI 코딩 에이전트가 코드만으로는 알 수 없는 맥락(의사결정, 워크플로우, 불변 조건, 함정 등)을 포착하여 저장소에 마크다운 위키로 자동 생성·유지보수하는 도구입니다. Codex나 Claude Code와의 대화를 스캔하고, 로컬에서 실행되는 예약 작업(sync, garden, update)을 통해 위키를 최신 상태로 가꿔줍니다. 위키는 일반 마크다운으로 저장되어 Git으로 검토할 수 있으며, 검색·탐색·로컬 웹 뷰어를 제공합니다. macOS에서 Python 3.12+와 함께 사용할 수 있습니다.
CodeAlmanac은 코드가 말할 수 없는 것, 즉 시스템이 왜 그렇게 설계되었는지, 무엇이 이전에 고장났는지, 어떤 불변 조건이 중요한지, 워크플로우가 파일과 서비스를 어떻게 넘나드는지에 대한 맥락을 AI 에이전트에게 제공합니다.