when

@whenlabs/when

6 つのツール。インストールは 1 回。

WhenLabs の開発者向けツール 6 つを Claude Code のワークフローに導入する、1 つのインストール可能なツールキットです。インストールすると、ツールは 1 つの MCP サーバーを通じて公開され、Claude が必要に応じて自動的に呼び出します。

インストール

npx @whenlabs/when install

初回のみのセットアップです。インストーラーは次の処理を行います。

1. Claude Code の設定に単一の MCP サーバー（whenlabs）を登録します
2. Claude が各ツールをいつ使うべきか把握できるよう、CLAUDE.md ブロックを挿入します
3. 古い velocity-mcp の登録があれば削除します（velocity は現在バンドルされています）

6 つのツール

ツール	目的
aware	スタックを自動検出し、AI コンテキストファイル（CLAUDE.md、.cursorrules、…）を生成します
berth	開発サーバーの起動前にポートの競合を検出します
envalid	スキーマに照らして .env ファイルを検証します
stale	ドキュメントとコードの不整合を検出します
vow	依存関係のライセンスをスキャンし、ポリシーに照らして検証します
velocity	コーディングタスクの時間を計測し、過去のデータから学習します

MCP ツール

6 つのツールで 8 つのエンドポイントを利用できます。

エンドポイント	機能
aware_sync	スタックを検出し、AI コンテキストファイルを再生成します
berth_check	プロジェクト内のポート競合をスキャンします
envalid_validate	.env ファイルをスキーマに照らして検証します
stale_scan	ドキュメントの不整合を検出します
vow_scan	ライセンスをスキャンし、ポリシーに照らして検証します
velocity_start_task	コーディングタスクの時間計測を開始します
velocity_end_task	時間計測を終了し、結果を記録します
whenlabs_summary	1 回の呼び出しで、5 つすべてのスキャナーの結果を統合して表示します

8 つすべてが単一の 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 を参照してください。

---

WhenLabs の Siddharth が開発しました。