{
  "markdown": "# @whenlabs/when\n\n**Six tools. One install.**\n\nA 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.\n\n<p align=\"center\">\n  <img src=\"demos/hero.gif\" alt=\"when doctor — six tools, one unified health report\" width=\"820\" />\n</p>\n\n## Install\n\n```bash\nnpx @whenlabs/when install\n```\n\nOne-time setup. The installer:\n\n1. Registers a single MCP server (`whenlabs`) in your Claude Code configuration\n2. Injects a CLAUDE.md block so Claude knows when to use each tool\n3. Cleans up any legacy `velocity-mcp` registration (velocity is now bundled)\n\n## The six tools\n\n| Tool | Purpose |\n|---|---|\n| **aware** | Auto-detect stack and generate AI context files (CLAUDE.md, `.cursorrules`, …) |\n| **berth** | Detect port conflicts before starting dev servers |\n| **envalid** | Validate `.env` files against a schema |\n| **stale** | Detect documentation drift between docs and code |\n| **vow** | Scan dependency licenses and validate against policy |\n| **velocity** | Time coding tasks and learn from historical data |\n\n## MCP tools\n\nEight endpoints across the six tools:\n\n| Endpoint | What it does |\n|---|---|\n| `aware_sync` | Detect stack and regenerate AI context files |\n| `berth_check` | Scan project for port conflicts |\n| `envalid_validate` | Validate `.env` files against schema |\n| `stale_scan` | Detect documentation drift |\n| `vow_scan` | Scan licenses and validate against policy |\n| `velocity_start_task` | Start timing a coding task |\n| `velocity_end_task` | End timing and record results |\n| `whenlabs_summary` | Unified rollup across all five scanners in one call |\n\nAll eight 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`).\n\n## CLI\n\n```bash\nwhen init       # Onboard a project — detect stack, bootstrap configs, run all checks\nwhen doctor     # Run all six tools and show a unified health report\nwhen install    # Register MCP server in Claude Code\nwhen uninstall  # Remove MCP server\n```\n\nFor per-tool operations, use the tool directly:\n\n```bash\nnpx @whenlabs/stale scan\nnpx @whenlabs/envalid validate\nnpx @whenlabs/berth check\nnpx @whenlabs/aware sync\nnpx @whenlabs/vow scan\n```\n\n## Manual MCP configuration\n\nIf you're not using the `install` command, add this to your Claude Code MCP config:\n\n```json\n{\n  \"mcpServers\": {\n    \"whenlabs\": {\n      \"command\": \"npx\",\n      \"args\": [\"@whenlabs/when\", \"when-mcp\"]\n    }\n  }\n}\n```\n\n## License\n\nMIT — see [LICENSE](./LICENSE)\n\n---\n\nBuilt by [Siddharth](https://github.com/Caissaisdead) at [WhenLabs](https://github.com/WhenLabs-org)\n",
  "bytes": 2755,
  "sha": "78ac4c685a83d78cd07a3f7b4073932384773b3bee651a5019a4f6497f7841c9",
  "repo_slug": "whenlabs-org/when",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_whenlabs_org_when_6af17c8a/readme"
}