# CodeAlmanac 把你的 Claude Code 聊天记录自动整理成可查询的代码库维基

> 原标题：Show HN: CodeAlmanac – Karpathy-style codebase wiki from your conversations

- 来源：Hacker News 首页
- 发布时间：2026-07-21T17:12:01.000Z
- AX AI 日报：https://ai-daily.ax0x.ai/items/45713
- 原文：https://github.com/AlmanacCode/codealmanac/

## 摘要

CodeAlmanac 会在你的仓库里维护一个 almanac/ 文件夹，用 Markdown 页面记录代码本身说不清的决策和背景。它每五小时拉取一次新的 CC/Codex 对话，更新相关页面，再把这些页面索引到 SQLite 里，方便你用命令行查询。每个队友的编程 agent 在动手前会先搜这个维基，省得你反复解释设计意图。项目开源、本地运行、免费，...

## 推荐理由

CodeAlmanac 把 Karpathy 说的'代码库维基'自动化了：每五小时从 Claude Code 和 Codex 的对话里抓设计决策，写成 Markdown 存进仓库的 almanac/ 文件夹，再索引到 SQLite 让 agent 动手前先查。机制清楚，痛点真实——团队用 coding agent 时，设计意图全在聊天里，agent 不知道上下文就得人反复解释。我会先打个折：项目刚亮相，正文没披露实际使用数据或团队规模，稳定性、对话解析准确率都没验证。这点先别太激动，但思路确实省事，所以给到 72，刚好卡在 featured 门槛上。

## 锐评

CodeAlmanac 解决了一个很实际的痛点：你和编程 agent 聊出来的设计决策、背景信息，聊完就丢了，下次换个人或换个 agent 干活又得重新解释。它在仓库里维护一个 almanac/ 文件夹，用 Markdown 页面把这些“代码说不清的东西”存下来，再索引到 SQLite 里，队友的 agent 动手前会先搜一遍。

作者是 YC S26 的三人团队，他们选每五小时拉一次新对话而不是跟着 commit 走，理由是提交太频繁会烧 token。这个设计取舍说明他们在意成本，但正文完全没给任何数字——一次更新大概花多少 token、延迟多久、SQLite 索引多快，都没提。开源和本地运行是加分项，但“免费”的前提是你得用自己的 Codex/Claude Code 订阅额度，实际花销取决于你的聊天量。

团队场景比个人场景更有说服力：三个人各自用 agent，改完代码不用打电话解释为什么这么写，agent 自己会去读 wiki。这个“终于不用反复解释了”的解脱感是全文最实在的判断。还缺的是多 agent 并发写同一页面时的冲突处理逻辑，以及 wiki 质量随时间退化后怎么维护——这些正文都没交代。