Apothem 文档
一份共享配置档案，物化到十七个工具中。从这里开始：安装、使用、工具覆盖、命令流水线，以及完整的参考手册。
Apothem 是一个与宿主无关的工具配置管理器。你在 ~/.config/apothem/profile.yaml
中编写一份共享配置档案，Apothem 会将其物化为十七个工具的原生配置面——
Claude Code、Cursor、Gemini CLI、GitHub Copilot、Codex、Windsurf、Zed，
以及已注册目录中的其余工具。
Apothem 同步的单元不止于规则：规则、技能、子代理、斜杠命令、钩子、输出样式、状态栏、模板、合规校验器、模式、按工具划分的指令模板，以及 Claude Code 设置模板，作为一套受治理的语料一并流转；在工具没有对应原语时，则物化为各工具的原生格式，或物化到 Apothem 自有的支持子树中。共享配置档案同时承载 MCP 服务器定义。
初次使用？两步即可开始
- 安装 —— 选择一条安装路径（工具原生插件与扩展、
npx，或一键脚本），运行有引导的第一步。每条路径都需要系统中的 Python 3.10 或更新版本（含click与rich）；npx与扩展渠道额外需要 Node.js 18 或更新版本。 - 完成你的首次可用运行 —— 编写一份共享 配置档案，从中物化某个工具的原生配置，并验证结果。从头到尾约十五分钟。
Apothem 的工作原理
- 一份配置档案，多种原生配置。 你只需编写一次意图，Apothem 便将其翻译为每个 工具的原生配置面——不做最小公分母式的拉平。参见 与宿主无关的姿态。
- 运行回路：规划 → 加固 → 发布。 规划流水线（
/plan）带着一项变更走过规格、 生成、复审与执行；加固流水线（/fortress）将该工作推进到受发布门控的状态； 发布门关闭回路。参见 命令流水线。 - 跨越边界依然延续的工作。 长时间运行的工作会将其完整状态外置到项目本地的
.apothem/plans/套件中，因此任何账户或机器上的新会话都能就地恢复它。参见 可恢复的规划。
从这里开始
- 安装 —— 各条安装路径（工具原生插件与扩展、
npx、一键脚本）以及一次有引导的首次运行。 - 使用 —— 编写你的配置档案、安装到各个工具、 验证并更新。
- 工具 —— 十七个工具的目录，附每个工具的原生配置面及其 转换行为。
- 命令流水线 ——
/plan与/research流水线的各个阶段、 审计评审序列，附封装它们的/audit与/fortress编排器。
深入了解
- 概念 —— 共享配置档案、工具适配器 以及物化模型。
- 架构 —— 源码布局、适配器抽象、自包含运行时，以及 CI/CD 流水线。
- 参考 —— CLI、配置档案模式、规则、技能、命令、钩子，以及 输出样式目录。
- Apothem 的对比 —— 一份诚实、点名竞品的差异化矩阵。