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.

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 DeepWiki-Open.

Is CodeAlmanac actively maintained?

Yes. 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 997 stars on GitHub.

CodeAlmanac: open-source alternative to Swimm

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

Built with: TypeScript
Tags: ai-agents; codebase; wiki; documentation; cli; claude-code; codex; knowledge-base; typescript

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 DeepWiki-Open.
Is CodeAlmanac actively maintained?: Yes. 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 997 stars on GitHub.