Skip to main content
Glama

@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:

  1. Registers a single MCP server (whenlabs) in your Claude Code configuration

  2. Injects a CLAUDE.md block so Claude knows when to use each tool

  3. 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": ["@whenlabs/when", "when-mcp"]
    }
  }
}

License

MIT — see LICENSE


Built by Siddharth at WhenLabs

Install Server
A
security – no known vulnerabilities
A
license - permissive license
A
quality - A tier

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/WhenLabs-org/when'

If you have feedback or need assistance with the MCP directory API, please join our Discord server