QUICKSTART · NODE 22+ · LOCAL FIRST

把现有仓库变成
Agent 能读懂的上下文。

无需全局安装。初始化图谱、查看状态，再把同一个本地 MCP 服务接入你的编码工具。

terminal

$ npx -y github:yubinbin32-ops/Mdflow-Canvas init --scan
✓ created .mdflow/project.json
✓ created .mdflow/graph.json

$ npx -y github:yubinbin32-ops/Mdflow-Canvas status
graph valid · ready for MCP

01THREE COMMANDS

先在一个真实项目里试。

mdflow 把架构事实写入项目自己的 `.mdflow` 目录。源码、图谱和 Git 历史保持在一起，换分支或撤回时不会留下另一份过期文档。

01init --scan

建立图谱

扫描项目结构，生成项目描述和可追踪的 graph.json。

02status

确认事实

查看 Block、Link、Chain、Plan 和 Checkpoint 的状态。

03setup

连接 Agent

写入 Cursor、Claude Desktop 或其他 stdio MCP 客户端配置。

02WORKS WHERE YOU CODE

同一套上下文，多个客户端。

桌面端提供 Canvas 总览；CLI 和 MCP 服务可以在 macOS、Linux、Windows、CI 或远程开发机运行。

macOS 14+原生 Canvas、Inspector、路径与证据

Node.js 22+跨平台 CLI 和本地 stdio MCP 服务