GoKawiilCodeAlmanac
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+.
Quickstart
uv tool install codealmanac@latest codealmanac setup
See Setup for configuration options.
Once CodeAlmanac is set up:
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
... continue reading