--- title: GitHub - AlmanacCode/codealmanac: A codebase wiki for AI... description: CodeAlmanac is a Python CLI tool that creates and maintains a living wiki for your codebase, designed specifically for AI coding agents. It captures context... canonical: https://daily.dev/posts/github---almanaccode-codealmanac-a-codebase-wiki-for-ai-coding-agents-captures-what-the-code-can-t-gbyg8d3wz twitter:card: summary_large_image twitter:site: @dailydotdev og:type: website og:site_name: daily.dev og:title: GitHub - AlmanacCode/codealmanac: A codebase wiki for AI coding agents. Captures what the code can't say: decisions, flows, invariants, gotchas. | daily.dev og:description: CodeAlmanac is a Python CLI tool that creates and maintains a living wiki for your codebase, designed specifically for AI coding agents. It captures context... og:url: https://daily.dev/posts/github---almanaccode-codealmanac-a-codebase-wiki-for-ai-coding-agents-captures-what-the-code-can-t-gbyg8d3wz og:image: https://api.daily.dev/og/posts/gbyG8D3Wz.png og:image:alt: GitHub - AlmanacCode/codealmanac: A codebase wiki for AI coding agents. Captures what the code can't say: decisions, flows, invariants, gotchas. og:image:width: 1200 og:image:height: 630 og:locale: en --- > ## Documentation Index > Fetch the complete documentation index at: https://daily.dev/llms.txt > Use this file to discover all available pages before exploring further. # GitHub - AlmanacCode/codealmanac: A codebase wiki for AI coding agents. Captures what the code can't say: decisions, flows, invariants, gotchas. **[Hacker News](https://daily.dev/sources/hn)** · 11 min read · 0 upvotes · 0 comments ## Summary CodeAlmanac is a Python CLI tool that creates and maintains a living wiki for your codebase, designed specifically for AI coding agents. It captures context that code alone cannot express — architectural decisions, invariants, past failures, and cross-service workflows — stored as plain markdown in your repo under an `almanac/` directory. The tool integrates with Codex and Claude Code, running background jobs (sync, garden, update) via macOS launchd to automatically extract knowledge from agent conversations and keep the wiki current. Key commands include `init`, `ingest`, `search`, `show`, and `serve` for a local web viewer. It is distributed via PyPI, requires Python 3.12+, and is currently macOS-only with local-first, no-cloud architecture. ## Full article daily.dev links to this article rather than hosting it. Read it at the original source: ## Similar posts on daily.dev - [OpenAI Codex rivals Claude Code](https://daily.dev/posts/openai-codex-rivals-claude-code-pecr3wida) · InfoWorld · 0 upvotes · 0 comments - [Codex CLI: OpenAI's Open Agent Harness — Installation, Commands, and CI Integration](https://daily.dev/posts/codex-cli-openai-s-open-agent-harness-installation-commands-and-ci-integration-sl98jxtwh) · SitePoint · 1 upvotes · 0 comments --- Tags: [#ai](https://daily.dev/tags/ai), [#typescript](https://daily.dev/tags/typescript), [#cli](https://daily.dev/tags/cli), [#claude](https://daily.dev/tags/claude) [View this post on daily.dev](https://daily.dev/posts/github---almanaccode-codealmanac-a-codebase-wiki-for-ai-coding-agents-captures-what-the-code-can-t-gbyg8d3wz) ```json {"@context":"https://schema.org","@graph":[{"@type":"Organization","@id":"https://daily.dev/#organization","name":"daily.dev","url":"https://daily.dev","logo":{"@type":"ImageObject","url":"https://daily.dev/apple-touch-icon.png","width":180,"height":180},"sameAs":["https://twitter.com/dailydotdev","https://github.com/dailydotdev","https://www.linkedin.com/company/daily-dev-ltd"]},{"@type":"WebSite","@id":"https://daily.dev/#website","url":"https://daily.dev","name":"daily.dev","publisher":{"@id":"https://daily.dev/#organization"},"potentialAction":{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https://daily.dev/search?q={search_term_string}"},"query-input":"required name=search_term_string"}}]} {"@context":"https://schema.org","@type":"TechArticle","headline":"GitHub - AlmanacCode/codealmanac: A codebase wiki for AI coding agents. Captures what the code can't say: decisions, flows, invariants, gotchas.","url":"https://daily.dev/posts/github---almanaccode-codealmanac-a-codebase-wiki-for-ai-coding-agents-captures-what-the-code-can-t-gbyg8d3wz","mainEntityOfPage":{"@type":"WebPage","@id":"https://daily.dev/posts/github---almanaccode-codealmanac-a-codebase-wiki-for-ai-coding-agents-captures-what-the-code-can-t-gbyg8d3wz"},"datePublished":"2026-07-21T20:42:59.853Z","dateModified":"2026-07-21T20:43:23.940Z","description":"CodeAlmanac is a Python CLI tool that creates and maintains a living wiki for your codebase, designed specifically for AI coding agents. It captures context...","image":"https://media.daily.dev/image/upload/f_auto,q_auto/v1/posts/5dc46640b687a8918fd9f1582ca643ed?_a=AQAEuop","thumbnailUrl":"https://media.daily.dev/image/upload/f_auto,q_auto/v1/posts/5dc46640b687a8918fd9f1582ca643ed?_a=AQAEuop","isAccessibleForFree":true,"articleSection":"Hacker News","inLanguage":"en","publisher":{"@type":"Organization","name":"daily.dev","url":"https://daily.dev","logo":{"@type":"ImageObject","url":"https://daily.dev/apple-touch-icon.png","width":180,"height":180}},"author":{"@type":"Organization","name":"Hacker News","logo":"https://media.daily.dev/image/upload/t_logo,f_auto/v1/logos/hn","url":"https://daily.dev/sources/hn"},"commentCount":0,"discussionUrl":"https://daily.dev/posts/github---almanaccode-codealmanac-a-codebase-wiki-for-ai-coding-agents-captures-what-the-code-can-t-gbyg8d3wz","interactionStatistic":[{"@type":"InteractionCounter","interactionType":{"@type":"LikeAction"},"userInteractionCount":0},{"@type":"InteractionCounter","interactionType":{"@type":"CommentAction"},"userInteractionCount":0}],"keywords":"ai,typescript,cli,claude","timeRequired":"PT11M"} {"@context":"https://schema.org","@type":"BreadcrumbList","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https://daily.dev"},{"@type":"ListItem","position":2,"name":"Hacker News","item":"https://daily.dev/sources/hn"},{"@type":"ListItem","position":3,"name":"GitHub - AlmanacCode/codealmanac: A codebase wiki for AI coding agents. Captures what the code can't say: decisions, flows, invariants, gotchas."}]} ```