
Open-source, self-updating wiki for your codebase
I got tired of re-explaining the same codebase context to coding agents.
Stuff like: “we tried moving auth into middleware, but backed it out because it broke OAuth callbacks,” or “that weird retry logic exists because Stripe webhooks arrive out of order.”
So I built Almanac.
It gives your coding agent a self-updating wiki for the codebase. It updates from your repo, and conversations you havewith Claude Code/Codex.
The wiki lives locally in your repo as markdown. You can read it yourself, but the main consumer is the agent.
It’s free and open source. Currently only MacOS (would add a windows support if people find it useful)
GitHub: https://github.com/AlmanacCode/codealmanac
Curious how other people are handling project context for long-running AI coding work.