VibeFrame

为编程智能体设计的控制平面。 VibeFrame 在你的仓库中维护一份活模型，描述软件应该是什么——业务意图、系统设计和代码本身——并使其与实际状态进行确定性的同步，同时清楚展现两者在何处出现分歧。

编程智能体写代码的速度远快于任何人阅读的速度。而蒸发的正是 理论：存在什么，为什么存在，哪些决定在结构中承重，以及代码是否仍然符合已经做出的决策。VibeFrame 在最便宜的时机（规划阶段，通过智能体自己的 MCP 协议）捕获这套理论，把它以纯文本文件形式存进你的仓库，用机械方式永久校验，并通过任务范围的上下文简报回报智能体——这比重新 grep 代码库更有效。

• 三个平面，一张图 —— 能力与工作流（意图）、组件与约束（系统）、文件与符号（代码，100% 派生，从不猜测）。

• 每个事实都有可信层级 —— A 派生 / B 富集 / C 断言；过时可见，从不沉默。

• 带证据的漂移检测 —— 一个实时反射模型：分歧、缺失、绑定失败、孤立、循环、锁定决策被触碰。零 LLM 调用；框架是确定性的，而编码智能体才是智能所在。

• 仓库内模型 —— .vibeframe/ 下的 YAML/Markdown 由 git 版本化管理：分支安全、适合 PR 审查、不依赖任何工具。一个被 gitignore 的 SQLite 索引是可派生、可重建的。

• 每个项目一个守护进程 —— Streamable-HTTP MCP 端点、REST + SSE，以及实时浏览器 UI（Map、Focus、Inspector、Activity、Drift inbox、Decisions），全部在一个进程内。

• Claude Code 优先 —— 插件将 MCP server、确定性 hooks 和 skills 集成在一起；该模型通过 AGENTS.md 摘要为任何其他编码智能体提供服务。

安装（v0.1.0 — 暂无 npm 包）

直接从 GitHub 安装发布版 tarball 到项目中（需要 Node ≥ 22.12）：

npm i -D https://github.com/jubayertalha/vibeframe/releases/download/v0.1.0/vibeframe-0.1.0.tgz https://github.com/jubayertalha/vibeframe/releases/download/v0.1.0/vibeframe-core-0.1.0.tgz https://github.com/jubayertalha/vibeframe/releases/download/v0.1.0/vibeframe-store-0.1.0.tgz https://github.com/jubayertalha/vibeframe/releases/download/v0.1.0/vibeframe-indexer-0.1.0.tgz https://github.com/jubayertalha/vibeframe/releases/download/v0.1.0/vibeframe-engine-0.1.0.tgz https://github.com/jubayertalha/vibeframe/releases/download/v0.1.0/vibeframe-daemon-0.1.0.tgz

（也可以从某个克隆中获取：先运行 npm ci && npm run build && npm pack --workspaces，再对 tarballs 执行 npm i -D。不要执行 npm i vibeframe —— 该名称目前在 registry 上已被另一个无关包占用）。

Related MCP server: Paparats MCP

快速开始

npx vibeframe init                              # scaffold .vibeframe/ — commit it
claude mcp add vibeframe -- npx vibeframe mcp   # or install the Claude Code plugin (below)
npx vibeframe start                             # daemon + browser UI (prints the URL)

如果要体验完整的 Claude Code 体验（MCP 以及 确定性的 hooks 和多行 /vibeframe:* 命令），请在 Claude Code 内安装本仓库的插件：先运行 /plugin marketplace add jubayertalha/vibeframe，然后运行 /plugin install vibeframe——并跳过上面那行 claude mcp add（插件已经带来了 server）。

然后让智能体规划一个功能。它会通过一次 vibe_context 调用定向，在编码前声明工作流，在编码后绑定实现——而它遗漏的一切，都会被确定性层捕获：违反会以同轮警告的形式返回，未经解释的变更会被排队等待对账，而漂移收件箱会以 file:line 证据精确显示现实在哪些地方偏离了计划。完整演练请见：docs/getting-started.md。

文档

现状

v0.1.0 —— 针对全新的 TypeScript/JavaScript/Python 项目，完整闭环：init → declare → index → link → validate → reconcile，附守护进程、MCP 工具、hooks 与六个透视镜 UI。按设计略后：other-agent adapters、brownfield adopt-mode、symbol-level call graph、teams、anything hosted。

开发

npm ci && npm run build && npm run check   # lint + typecheck + unit tests
npm run test:dogfood                       # the full-loop acceptance suite

参见 docs/contributing/development.md 和 CLAUDE.md。

许可证

MIT