一个由 AI 编程助手维护的动态维基。CodeAlmanac 为 AI 助手提供了代码所无法单独包含的上下文：为什么系统是这样的结构，以前出现了什么故障，哪些不变量很重要，工作流程是如何跨文件和服务的。维基以简单的 markdown 格式存储在你的代码库中，本地索引，并且像任何其他代码更改一样在 Git 中进行审核。今天支持：使用 Codex 或 Claude Code 的 macOS。要求 Python 3.12+。快速入门 uv 工具安装 codealmanac@latest codealmanac setup 查看配置选项的设置。一旦设置完 CodeAlmanac：cd your-repo codealmanac init # 创建你的维基，如果你还没有的话 codealmanac search "入门指南" # 显示匹配的维基页面。 codealmanac show getting-started # 在终端中打开一页 codealmanac serve # 在本地网页查看器中显示维基。 设置为你使用的本地工具安装全局代理说明：# 交互式设置 codealmanac setup # 使用推荐的默认设置快速安装；使用 Codex 作为 AI 运行器 codealmanac setup --yes # 使用 Claude 作为 AI 运行器快速安装 codealmanac setup --yes --runner claude 设置安装你选择的工具的代理说明以及三个本地 macOS launchd 作业。作业和所有维基工作在本地运行。作业 默认计划 它的作用 同步 每 5 小时 扫描最近的 Codex 和 Claude 对话并排队有用的知识进入相关的注册维基。整理 每 24 小时 审查每个注册的维基，以查找过时、重复或连接不良的知识。更新 每 24 小时 检查并在安全的情况下安装 CodeAlmanac CLI 更新。这些计划在本地后台运行。使用 codealmanac automation status 查看已安装的内容。最后的设置步骤询问关于匿名遥测，并推荐选择是，以便我们能看到哪些命令有效以及 CLI 出现问题的地方。它会发送受控的命令和生命周期结果以及经过清理的未处理崩溃信息，采用随机安装 UUID。它永远不会发送代码、路径、参数、查询、提示、记录、仓库/运行 ID、本地变量或凭据；GeoIP 功能被禁用。在设置中选择否，传递 setup --no-telemetry，设置 telemetry.enabled 为 false，或者随时使用 DO_NOT_TRACK=1。没有未来的登录，UUID 配置文件没有姓名或电子邮件。如果你没有 Codex 或更喜欢 Claude，使用 --runner claude。--target 只选择要安装的全局代理说明文件；它不选择 AI 运行器：codealmanac setup --yes --target codex codealmanac setup --yes --target claude 自定义设置期间的自动工作：# 更改最近代理对话的扫描频率 codealmanac setup --yes --sync-every 5h # 不安装自动转录同步 codealmanac setup --yes --sync-off # 不安装自动维基清理 codealmanac setup --yes --garden-off # 不安装自动 CodeAlmanac 更新 codealmanac setup --yes --no-auto-update 要卸载 CodeAlmanac 拥有的本地文件：codealmanac uninstall --yes 每日阅读 表面代理和人类使用相同的本地读取命令：codealmanac search "checkout timeout" codealmanac search --mentions src/checkout/ codealmanac show checkout-flow codealmanac topics codealmanac health codealmanac validate 使用 --wiki <name> 阅读另一个注册的本地维基。默认情况下，命令针对确切的当前目录，当它是注册的仓库根目录时。 更新 维基生命周期命令通过公共 Yoke SDK 运行三个明确的代理——构建、摄取或整理。现有的打包提示文件仍然是完整的任务指令，并直接指示代理在 almanac/ 下编辑维基。生命周期代理是值得信赖的本地编程代理。它们以 CodeAlmanac 历史上提供的相同广泛的非交互式文件系统权限运行，因此 almanac/ 边界是一个指令和提交策略，而不是一个操作系统沙箱。仅在你接受该信任模型的仓库中运行生命周期命令，并在禁用自动提交时查看 resulting Git diff。codealmanac ingest README.md --using codex codealmanac ingest github:pr:123 --using claude codealmanac garden --using codex 摄取将选定的本地材料合并到维基中。输入可以包括文件、目录、Git diff、提交范围、GitHub PR 或问题、URL 和本地代理记录。garden 改进现有的维基图：过时的页面、链接、主题、弱指引、重复页面和不支持的声明。无操作是有效的。如果材料没有添加持久的维基知识，工具应保持维基不变。init、ingest 和 garden 创建排队运行并启动本地工作者。要可视化跟随它们，运行 codealmanac serve 并选择侧边栏中的作业。要留在终端中，使用 codealmanac jobs attach <run-id>。同步与自动化 CodeAlmanac 可以保持注册的维基最新，而无需你记住维护命令。同步扫描本地 Codex 和 Claude 转录存储，查找自上一次完成的同步以来活跃的对话。会话一