CodeAlmanac: A codebase wiki for AI coding agents
- source_url: https://github.com/AlmanacCode/codealmanac
- source_type: github
- platform: github
- author: AlmanacCode
- original_date: 2026-07-22
- added_date: 2026-07-22
- category: coding
- tags: codealmanac, wiki, agent-memory, codex, claude-code, devtools
- quality_score: 4
- pypi: https://pypi.org/project/codealmanac/
摘要（中文）
仓库内 Markdown 活 wiki，记录代码说不清的决策、流程、不变量与坑。本地索引，经 Git review；支持 search/show/topics/health/validate 与本地 web viewer。当前支持 macOS 上 Codex 或 Claude Code，Python 3.12+。自动化可扫描本地会话沉淀长期知识。信任边界重要：lifecycle agent 有广泛本地文件权限，almanac/ 边界靠指令与提交策略而非 OS sandbox。把 agent 上下文从一次性 prompt 迁到可 review 的仓库知识层。
Summary (English)
CodeAlmanac is a living in-repo Markdown wiki for what code cannot say: decisions, flows, invariants, and gotchas. Indexed locally, reviewed in Git, with search/show/serve tooling. Supports macOS with Codex or Claude Code (Python 3.12+). Agents can maintain the wiki; lifecycle agents have broad local file permissions—the almanac/ boundary is instructional and review-based, not an OS sandbox. Moves durable agent context from one-shot prompts into a reviewable repository knowledge layer.
One-liner
给 coding agent 一份可 Git review 的仓库 wiki：决策、不变量与坑。
Source body / metadata
Fetched via opencli web read / official docs during evening intake. Key claims are grounded in the source page and same-day Obsidian digest notes.
CodeAlmanac is a living in-repo Markdown wiki for what code cannot say: decisions, flows, invariants, and gotchas. Indexed locally, reviewed in Git, with search/show/serve tooling. Supports macOS with Codex or Claude Code (Python 3.12+). Agents can maintain the wiki; lifecycle agents have broad local file permissions—the almanac/ boundary is instructional and review-based, not an OS sandbox. Moves durable agent context from one-shot prompts into a reviewable repository knowledge layer.
Obsidian evidence
- local_note: OpenClaw定时任务/ClawFeed24小时高价值一览/2026-07-22-ClawFeed24小时高价值一览.md
- intake_run: daily-intake-evening 2026-07-22