About CodeAlmanac
CodeAlmanac is a living wiki for a codebase, written and kept up to date by AI coding agents. It aims to capture what code alone cannot say, such as why a system is shaped as it is, what broke before, which invariants matter and how workflows cross files and services. The pages are plain markdown stored in your repository, indexed locally and reviewed in Git like any other change.
Setup installs instructions for the agent tools you choose and three local macOS launchd jobs. One syncs recent Codex and Claude conversations into the relevant wiki every five hours, one reviews the wiki daily for stale or duplicated knowledge, and one installs CLI updates daily. The README says the jobs and all wiki work run locally. Today it supports macOS with Codex or Claude Code.
Setup asks about anonymous telemetry, which can be refused in setup, through a flag, a config option or the DO NOT TRACK variable, and the README says it never sends code, paths, prompts or credentials. The project is written in TypeScript and licensed under Apache-2.0.
Key features
- Markdown codebase wiki stored in your repo
- Maintained by AI coding agents
- Local indexing and Git-based review
- Scheduled sync, garden and update jobs
- Support for Codex and Claude Code
- Opt-out anonymous telemetry
Good fit for
- Giving coding agents durable project context
- Documenting design decisions and gotchas as you work
CodeAlmanac: questions and answers
- What is CodeAlmanac used for?
- CodeAlmanac is a command-line tool that keeps a markdown wiki of a codebase's decisions, flows and gotchas, maintained by AI coding agents such as Codex and Claude Code. It is a good fit for giving coding agents durable project context, and documenting design decisions and gotchas as you work.
- Is CodeAlmanac open source?
- Yes. CodeAlmanac is open source under the Apache-2.0 licence. Its source code is on GitHub at AlmanacCode/codealmanac and is written mainly in TypeScript.
- Is CodeAlmanac free?
- Yes. CodeAlmanac is open source, so the software itself is free to use.
- What is CodeAlmanac an alternative to?
- CodeAlmanac is an open-source alternative to Swimm. Other open-source alternatives to Swimm include GitBook, Sphinx and Docfx.
- Is CodeAlmanac actively maintained?
- The most recent commit to CodeAlmanac was on 25 July 2026, and the latest release is v0.4.4, published on 11 July 2026. The project has 962 stars on GitHub.
Open-source alternatives to CodeAlmanac
See all
GitBook
Docs & Wikis
The open source frontend for GitBook doc sites
GPL-3.0vs GitBook★ 29k
Sphinx
Docs & Wikis
The Sphinx documentation generator
OSSvs Document360★ 8.1k
Docfx
Docs & Wikis
Static site generator for .NET API documentation.
MITvs Bump.sh★ 4.5k
DeepWiki-Open
AI Tools
Grok-Wiki is a local-first desktop workspace for repository wikis, Ask sessions, generated
MITvs Swimm★ 18k
Backstage
CI/CD & DevOps
Backstage is an open framework for building developer portals
Apache-2.0vs Port★ 35k
mdBook
Open source
Create book from markdown files. Like Gitbook but implemented in Rust
MPL-2.0vs GitBook★ 22k
SaaS alternatives to CodeAlmanac
See all
Swimm
Docs & Wikis
Code documentation that stays linked to the source it describes
SaaS
ShipDocs
Docs & Wikis
Connect a repo or upload a zip to get generated docs, AI chat and architecture diagrams
SaaS
Almanac
Docs & Wikis
Team wiki with document branching, approvals and workflow templates
SaaS
Document360
Docs & Wikis
Knowledge base software for product documentation and self-service
SaaS
Papyrs
Docs & Wikis
Cloud intranet and company wiki builder for internal portals
SaaS
ProProfs Knowledge Base
Docs & Wikis
Knowledge base software for help centers, internal wikis and user manuals
SaaS

