@whenlabs/when

@whenlabs/when

Six tools. One install.

A single installable toolkit that brings six WhenLabs developer tools into your Claude Code workflow. After install, the tools are exposed over a single MCP server and Claude calls them automatically when relevant.

Install

npx @whenlabs/when install

One-time setup. The installer:

• Registers a single MCP server (whenlabs) in your Claude Code configuration
• Injects a CLAUDE.md block so Claude knows when to use each tool
• Cleans up any legacy velocity-mcp registration (velocity is now bundled)

The six tools

Tool	Purpose
aware	Auto-detect stack and generate AI context files (CLAUDE.md, .cursorrules, …)
berth	Detect port conflicts before starting dev servers
envalid	Validate .env files against a schema
stale	Detect documentation drift between docs and code
vow	Scan dependency licenses and validate against policy
velocity	Time coding tasks and learn from historical data

MCP tools

Seven endpoints across the six tools:

Endpoint	What it does
aware_sync	Detect stack and regenerate AI context files
berth_check	Scan project for port conflicts
envalid_validate	Validate .env files against schema
stale_scan	Detect documentation drift
vow_scan	Scan licenses and validate against policy
velocity_start_task	Start timing a coding task
velocity_end_task	End timing and record results

All seven are served by the single whenlabs MCP server (stdio, Node 20+). Fix/init/auxiliary commands remain available via each tool's 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

For per-tool operations, use the tool directly:

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

Manual MCP configuration

If you're not using the install command, add this to your Claude Code MCP config:

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

The -p flag is required — @whenlabs/when ships two bins (when and when-mcp), and npx @whenlabs/when when-mcp runs the default when bin with when-mcp as an unknown subcommand.

License

MIT — see LICENSE

Built by Siddharth at WhenLabs