Show HN: CodeAlmanac – Karpathy-style codebase wiki from your conversations
CodeAlmanac is a new tool that creates a living, AI-maintained wiki for codebases based on developer conversations. It stores documentation as markdown files within the repository, allowing AI agents to better understand system context and history.
Why it matters
It addresses the 'context gap' in AI-assisted coding, potentially increasing developer productivity by providing AI agents with institutional knowledge.
A living wiki for your codebase, maintained by AI coding agents.
CodeAlmanac gives AI agents the context code alone cannot hold: why a system is shaped the way it is, what broke before, which invariants matter, and how workflows cross files and services. The wiki is plain markdown in your repo, indexed locally, and reviewed in Git like any other code change.
Supported today: macOS with Codex or Claude Code. Requires Python 3.12+.
uv tool install codealmanac@latest codealmanac setup See Setup for configuration options.
cd your-repo codealmanac init # Makes your wiki, if you don't have one codealmanac search " getting started " # Shows matching wiki pages. codealmanac show getting-started # Opens one page in the terminal codealmanac serve # Shows the wiki in local web viewer. Setup Install global agent instructions for the local tools you use:
Get smarter about the news
Sign up free for a feed built around what you actually care about, Dive Deeper research on any story, and the full text of every article.
Create free accountAlready have an account? Sign in