Framein：在本地为多个 AI 编码代理维护共享工作状态

Framein 是一款面向 AI 编码工作流的本地「工作帧」（work frame）工具，已在 Hacker News 以 Show HN 形式发布预发布版本 v0.0.6。它不替代 Claude Code、Codex 或 Gemini 等代理运行环境，而是在这些代理之下维护一份共享的任务状态，帮助开发者在多个模型之间切换时不丢失上下文。

核心思路：让代理共用一份「日志本」

Framein 的设计者将现有 AI 代理比作「引擎」，而 Framein 本身定位为「引擎写下的共享日志本」。它不收集 provider 凭证、不代理模型流量、不池化订阅，所有鉴权仍由各官方 CLI 处理。具体而言，Framein 在本地仓库中维护以下几类状态：

任务契约（task contract）：记录需求边界、约束与待办
决策轨迹（decision trail）：包括架构决策记录（ADR）与对话账本（ledger）
风险状态（risk state）：标记当前变更涉及的高风险区域
验证结果（validation results）：构建与测试的确定性结果
模型切换封装（capsule）：供下一个接手代理读取的最小上下文包

四个核心命令形成闭环

工具的典型使用流程由四个动词组成：

start：把请求转成共享任务契约，避免实现漂移
challenge：让另一个模型对方案给出结构化裁决，并生成决策简报
capsule：为下一个接手代理打包本地事实（契约、差异、验证、ADR、账本）
verify / ship：以确定性构建/测试与风险门禁收尾

示例会话展示了用 Claude 主导、为某次 OAuth 改动让 Codex 评审、最终用 Gemini 接手的过程。

部署与集成方式

安装：通过 npm 全局安装，要求 Node 22.5+，跨 Windows、macOS、Linux、WSL 均可运行；未来计划提供捆绑 Node 的独立可执行文件以规避 Windows 下 npm shim 问题
调用形式：
- Claude、Gemini 走斜杠命令 /fr:*
- Codex 走项目 skill 形式 $fr-*
- 同时提供 CLI、JSON 输出、CI 集成与 MCP 服务端
状态存储：仓库内的 git 友好 JSON 快照 + 本地 SQLite 缓存，SQLite 仅作缓存层，JSON 才是可版本化的源

与现有工具的关系

Framein 明确不替代任何代理框架，也不要求用户放弃既有的 prompt 框架、skill 包或角色设定。它强调「不接触 provider token、不代理 MCP 工具、不抓取终端 I/O」，只在你显式调用时本地执行官方 CLI。目前该项目仍处于预发布阶段，作者尚未公布后续路线图细节。