mcpField
W
wot-ui-cli

wot-ui-cli

github.com/wot-uiDevelopment39857 installsUpdated 2d ago
Repository

About wot-ui-cli

A skill for open-wot maintenance and tasks involving @wot-ui/cli, MCP, and Agent integration. It guides CLI development and repository work using current source and covers component queries, project analysis, client configuration, and release checks.

Key features

  1. 01Component knowledge query commands
  2. 02Project usage and code analysis
  3. 03Agent client configuration management
  4. 04MCP client configuration management
  5. 05Repository testing and release checks

Use cases

  1. 01Looking up wot-ui component docs and examples
  2. 02Checking component usage in a project
  3. 03Initializing or diagnosing Agent client configuration
  4. 04Validating MCP configuration and handshake

MCP support

The skill documents wot mcp management commands and stdio usage for initializing, inspecting, diagnosing, printing, or removing client MCP configuration, including validation of a real handshake.

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/wot-ui/open-wot --skill wot-ui-cli

After installing, type/wot-ui-cliin Claude Code to confirm it loaded.

Bundled filesreferences/overview.md

Details

From the project README

Wot UI CLI

处理 @wot-ui/cli、MCP、Agent 接入和 open-wot 仓库维护任务时，基于当前源码、package.json 和 README 行事，不根据旧文档猜测命令。

路由

  • CLI、MCP、Agent、数据提取或仓库开发：使用本 Skill。
  • 组件选型、页面代码、props、主题和组件问题：使用 wot-ui-v2 Skill。
  • 通过 CLI 查询组件知识时，保留 CLI 使用语境；需要生成组件代码时再切换到 wot-ui-v2。

工作流

  1. 先查看 README.md、package.json#scripts 和相关源码。
  2. 修改 CLI、MCP、prompt、数据结构或 Skill 后，同步测试与 README。
  3. 写配置前先运行 --dry-run，使用隔离 --cwd，不要修改真实用户配置。
  4. 修改命令输出后，至少运行一个真实源码或构建产物命令。
  5. 提交前运行 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。

Comments

Markdown supported