InPlan（Interactive Planning Editor）是一款面向人类与编码智能体协作的 Markdown 编辑器，核心目标是让 AI 辅助软件开发在写代码之前先形成一份可协作、可版本化的规格文档。它提出“规划驱动开发（Planning-Driven Development，PDD）”理念，把需求变成一份随代码一起演进的活文档，从而减少实现漂移、让重构更安全、使意图与代码保持一致。
用途 InPlan 用于在编码智能体动手写代码之前，与它一起把模糊的需求打磨成真正的规格。传统 AI 编码工作流围绕线性对话展开，随着需求变化、上下文增长、决策累积，很难持续追踪需求、理由、实现状态与变更。InPlan 让需求成为一份人类与智能体共同维护的文档，把计划及其理由一起保存，并可在 Git 中审阅。
主要能力
- 人类与智能体共同编辑同一份 Markdown 计划，类似两人在同一份共享文档中协作。
- 智能体起草计划结构，并以行内评论的形式提出待决问题。
- 你可以针对具体句子发表评论，并在评论线程中与智能体讨论；智能体修订计划后，你审阅差异并像 PR 一样应用。
- 支持自动接受（Auto-accept）或逐条审核（Review）智能体的修改；支持轮流（Turn）或实时（Instant）两种协作节奏。
- 评论保存在文档自身中，因此计划与理由同行，并可在 Git 中保持可审阅。
- 计划为纯 Markdown 加一个尾部 HTML 注释块，可在任意 Markdown 查看器中渲染，并在代码评审中干净地做差异对比。
- 编辑器提供若干键盘快捷键（查找、撤销/重做、保存、添加评论）。
使用方式 需要 Node.js 22 或更高版本。通过 npm 安装 CLI，它会捆绑桌面编辑器与智能体技能：
npm install -g inplan
安装后 inplan 命令会加入 PATH，捆绑的桌面编辑器可通过 inplan open 启动，并会把智能体技能安装到检测到的编码智能体（Claude Code、Pi、Codex）中；设置 INPLAN_NO_SKILL_INSTALL=1 可跳过，或稍后运行 inplan install-skill。编码智能体也可以自行安装。
从源码安装（TypeScript monorepo，npm workspaces）用于开发。包包括：@inplan/core（纯的、可嵌入的编辑器与计划格式逻辑）、@inplan/cli（inplan 命令，即智能体一侧的循环）、@inplan/app（Electron 编辑器，即人类一侧）。
你不需要自己运行 inplan，而是由你的编码智能体来运行。两步：
-
安装（一次），同时会把智能体技能放入你的编码智能体（Claude Code、Pi、Codex）。
-
用自然语言让你的智能体去规划，例如：
Let's plan a tic-tac-toe game. Plan the auth rewrite with me.
该技能会在任何“plan X”请求上触发：智能体写入 <name>.plan.md，打开 inplan 编辑器，并以行内评论提出待决问题。你阅读草稿，在编辑器中回答（回复评论、选择选项芯片，或直接编辑文本），智能体据此修订并回复，如此往复，直到你结束会话。
智能体通过 CLI 驱动循环：inplan open <file>（打开编辑器并阻塞直到你操作）、inplan wait <file>（在下一个操作后恢复）、inplan signal <file> --done（提示计划可能已就绪，但最终仍由你决定）。从 npm 安装时，inplan open 会启动捆绑的桌面编辑器。
从源码检出运行时，设置 INPLAN_APP_CMD 指向你构建的 @inplan/app（否则 CLI 以无头模式运行）；可用 npm run dev -w @inplan/app 单独运行编辑器。
编辑器把其附属文件（控制日志、规范基线、备份）集中保存在 ~/.inplan/sidecars/<key> 下（<key> 由文档绝对路径派生；可用 INPLAN_HOME 或 INPLAN_SIDECAR_DIR 覆盖根目录），不要手动编辑这些文件。
文档格式 被评论的文本片段是一个行内 Markdown 链接，其 href 为评论 id；评论本身位于一个尾部 HTML 注释块中（一个 JSON 数组）：
- 片段评论：正文中恰好一个 text 链接。
- 回复：携带 parentId，无链接。
- 文档级评论："anchor": "doc"，无链接。
- 问题会添加 "question": { "multiSelect": <bool>, "choices": [...] }；人类通过选择选项来回答（答案记录 "selected": [...]）。
适用场景
- 在编码智能体写代码之前，把模糊需求转化为可协作的规格。
- 需要持续追踪需求、理由、实现状态与变更的 AI 辅助软件开发。
- 希望把需求更新与缺陷修复分开管理，并维护一份人类与 AI 智能体都无法稳定记住的可靠事实来源。
- 让开发者、产品经理、架构师在同一份计划上协作。
限制 InPlan 旨在支持所有组合：操作系统（macOS 与 Windows）、节奏（轮流与实时模式）、智能体（Claude Code、Codex、Pi），但目前主要在 macOS、轮流模式、Claude Code 上开发和测试。其他操作系统、模式与智能体虽已接通但测试较少，可能存在粗糙之处。
许可 InPlan 采用双许可：开源为 AGPL-3.0-or-later；商业使用需从 CrazyIdeaStudio, Inc. 获取单独许可，用于专有或 SaaS 用途且不受 AGPL 传染性约束，详见 LICENSING.md，联系 licensing@inplan.ai。贡献需要签署 CLA，详见 CONTRIBUTING.md。
托管版本位于 inplan.ai；本仓库是可自行运行的开源核心。
