Show HN: CodeAlmanac – Karpathy-style codebase wiki from your conversations

Summary

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. 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. Install global agent instructions for the local tools you use: # Interactive setup codealmanac setup # Quick install with recommended defaults; uses Codex as the AI runner codealmanac setup --yes # Quick install using Claude as the AI runner codealmanac setup --yes --runner claude Setup installs agent instructions for your chosen tools and three local macOS launchd jobs. The jobs and all wiki work run locally. Job Default schedule What it does Sync Every 5 hours Scans recent Codex and Claude conversations and queues useful knowledge for the relevant registered wiki. Garden Every 24 hours Reviews every registered wiki for stale, duplicated, or poorly connected knowledge. Update Every 24 hours Checks for and installs CodeAlmanac CLI updates when it is safe to do so. These schedules run locally in the background. Use codealmanac automation status to see what is installed. The final setup step asks about anonymous telemetry and recommends Yes so we can see which commands work and where the CLI breaks. It sends controlled command and lifecycle outcomes plus sanitized unhandled crashes under a random install UUID. It never sends code, paths, arguments, queries, prompts, transc...