Wot UI CLI 用于处理 @wot-ui/cli、MCP、Agent 接入和 open-wot 仓库维护任务。其核心原则是：基于当前源码、package.json 和 README 行事，不根据旧文档猜测命令。
用途与路由
本工具适用于 CLI、MCP、Agent、数据提取或仓库开发相关任务。若任务涉及组件选型、页面代码、props、主题和组件问题，应使用 wot-ui-v2 Skill。通过 CLI 查询组件知识时，保留 CLI 使用语境；需要生成组件代码时再切换到 wot-ui-v2。
工作流
先查看 README.md、package.json#scripts 和相关源码。修改 CLI、MCP、prompt、数据结构或 Skill 后，同步测试与 README。写配置前先运行 --dry-run，使用隔离 --cwd，不要修改真实用户配置。修改命令输出后，至少运行一个真实源码或构建产物命令。提交前运行 pnpm lint && pnpm typecheck && pnpm test && pnpm build。
命令分组
组件知识：wot list [keyword]、wot info <component>、wot doc <component>、wot demo <component> [name]、wot token [component]、wot changelog [versionOrComponent] [component]。
项目分析：wot doctor [dir]、wot usage [dir]、wot lint [dir]。
Agent 接入：wot agent list、wot agent init --client cursor、wot agent status --client cursor、wot agent doctor --client cursor、wot agent remove --client cursor、wot agent init --client all。
MCP 管理：wot mcp、wot mcp serve、wot mcp list、wot mcp init --client cursor、wot mcp status --client cursor、wot mcp doctor --client cursor、wot mcp remove --client cursor、wot mcp print --client cursor。
查询命令支持 --version 和 --format text|json|markdown。Agent/MCP 管理命令支持的具体选项以 --help 和源码为准；写操作优先使用 --dry-run。
仓库开发
安装与开发：pnpm install、pnpm dev、pnpm exec tsx src/index.ts list、pnpm build、node dist/index.mjs list。
更新离线数据：pnpm sync:clone、pnpm extract:clone、pnpm sync --wot-dir ../wot-ui、pnpm extract --wot-dir ../wot-ui --output data/v2.0.4.json。
发布包检查：pnpm build、pnpm compress、pnpm exec publint、npm pack --dry-run --json。
MCP 注意事项
wot mcp 使用 stdio，终端无普通输出通常正常。doctor 验证配置和真实 handshake；部分客户端还会检查注册状态。--client all 在 project scope 处理六个支持客户端。保留已有 Server、JSONC 注释、非托管 TOML 和用户 Instructions。
参考
需要完整命令矩阵、目录职责、验证要求、数据与发布流程时，读取 references/overview.md。