when

@whenlabs/when

六种工具，一次安装。

一套可安装的工具包，将 WhenLabs 的六种开发工具集成到你的 Claude Code 工作流中。安装后，这些工具会通过单个 MCP 服务提供，Claude 会在相关时自动调用它们。

安装

npx @whenlabs/when install

一次性设置。安装程序会：

1. 在你的 Claude Code 配置中注册一个 MCP 服务（whenlabs）
2. 注入一个 CLAUDE.md 区块，让 Claude 知道何时使用每种工具
3. 清理任何旧版 velocity-mcp 注册（velocity 现已打包在内）

六种工具

工具	用途
aware	自动检测技术栈并生成 AI 上下文文件（CLAUDE.md、.cursorrules、……）
berth	在启动开发服务之前检测端口冲突
envalid	根据架构验证 .env 文件
stale	检测文档与代码之间的偏差
vow	扫描依赖项许可证并根据策略进行验证
velocity	为编码任务计时，并从历史数据中学习

MCP 工具

六种工具提供八个端点：

端点	功能
aware_sync	检测技术栈并重新生成 AI 上下文文件
berth_check	扫描项目中的端口冲突
envalid_validate	根据架构验证 .env 文件
stale_scan	检测文档偏差
vow_scan	扫描许可证并根据策略进行验证
velocity_start_task	开始为编码任务计时
velocity_end_task	结束计时并记录结果
whenlabs_summary	一次调用汇总全部五种扫描工具的结果

八个端点均由单个 whenlabs MCP 服务提供（stdio，Node 20+）。修复、初始化和辅助命令仍可通过各工具的 CLI 使用（npx @whenlabs/<tool> --help）。

CLI

when init       # Onboard a project — detect stack, bootstrap configs, run all checks
when doctor     # Run all six tools and show a unified health report
when install    # Register MCP server in Claude Code
when uninstall  # Remove MCP server

如需执行单个工具的操作，请直接使用该工具：

npx @whenlabs/stale scan
npx @whenlabs/envalid validate
npx @whenlabs/berth check
npx @whenlabs/aware sync
npx @whenlabs/vow scan

手动配置 MCP

如果不使用 install 命令，请将以下内容添加到 Claude Code 的 MCP 配置中：

{
  "mcpServers": {
    "whenlabs": {
      "command": "npx",
      "args": ["@whenlabs/when", "when-mcp"]
    }
  }
}

许可证

MIT — 请参阅 LICENSE

---

由 Siddharth 在 WhenLabs 构建