Greenrun

greenrun-cli

Claude Code 向けのブラウザーテスト管理ツールです。テストを平易な英語で記述すると、Claude が Playwright スクリプトを自動で生成して実行します。

Greenrun は、Claude Code を Greenrun API に接続する MCP サーバーです。テストしたい内容を説明するだけで、スクリプトの生成、並列実行、結果の追跡、必要なテストのみの再実行まで、Greenrun が処理します。

クイックスタート

npx greenrun-cli init

セットアップウィザードでは、次のことを行います。

1. Greenrun API トークンを検証します
2. Claude Code 用に Greenrun と Playwright の MCP サーバーを設定します
3. /greenrun と /greenrun-sweep のスラッシュコマンドをインストールします
4. プロジェクトの手順を CLAUDE.md に追加します
5. テストが確認プロンプトなしで実行されるよう、ツールの権限を設定します

app.greenrun.dev/tokens で API トークンを取得してください。

前提条件

• Node.js 18+
• Claude Code — インストールガイド
• Playwright MCP — init によって自動的に設定されます

仕組み

1. ダッシュボードまたは Claude Code から MCP ツールを使ってテストを定義します
2. /greenrun を実行します — Claude がテストを取得し、初回実行時に Playwright スクリプトを生成してから、ネイティブに実行します
3. スクリプトはキャッシュされます — 次回以降の実行では生成をスキップし、npx playwright test で即座に実行します
4. 結果が追跡されます — 合否、所要時間、概要が実行ごとに保存されます

スクリプトの生成

初回実行時、Claude はブラウザーで各テストの手順を確認し（調査パス）、UI の状態を観察して、実際のセレクターを使用した .spec.ts スクリプトを生成します。スクリプトは API に保存され、次回以降の実行で再利用されます。

キャッシュ済みのスクリプトが失敗した場合、AI エージェントがテストを手動で再実行し、スクリプトが古くなっているのか、それとも実際のバグなのかを判定します。古くなったスクリプトは、自動的に消去されて再生成の対象になります。

認証

プロジェクトでは、名前付きの認証情報セット（名前、メールアドレス、パスワード）を使用できます。各テストでは、credential_name を使って名前で認証情報を指定できます。実行時には、テストの実行前に該当する認証情報を使って認証します。

影響分析

コードを変更した後に /greenrun-sweep を実行すると、変更したページの影響を受けるテストを特定できます。関連するテストのみを再実行します。

スラッシュコマンド

/greenrun [filter]

現在のプロジェクトのテストを実行します。次のフィルターを使用できます。

• /greenrun — 有効なテストをすべて実行します
• /greenrun tag:smoke — 「smoke」タグが付いたテストを実行します
• /greenrun /checkout — 「/checkout」に一致するページに関連付けられたテストを実行します
• /greenrun login — 名前に「login」が含まれるテストを実行します

/greenrun-sweep

最近の git 変更の影響を受けるテストを特定し、実行するかどうかを確認します。

MCP ツール

ツール	説明
list_projects	すべてのプロジェクトを一覧表示します
create_project	プロジェクトを作成します（認証情報、認証設定を含む）
get_project	プロジェクトの詳細を取得します
update_project	プロジェクトの設定を更新します
list_pages	プロジェクト内のページを一覧表示します
create_page	ページの URL を登録します
list_tests	最新の実行ステータスとともにテストを一覧表示します
get_test	テストの詳細と手順をすべて取得します
create_test	テストを作成します（credential_name、タグ、ページを含む）
update_test	テストを更新します（内容が変更された場合、スクリプトを自動的に無効化します）
prepare_test_batch	テストのバッチを取得、絞り込み、実行開始します
export_test_script	テストのキャッシュ済み Playwright スクリプトをローカルファイルに書き込みます（スクリプトをコンテキストに含めずに済みます）
export_test_instructions	テストの手順をローカルファイルに書き込みます（手順をコンテキストに含めずに済みます）
sweep	特定のページの影響を受けるテストを検索します
start_run	テストの実行を開始します
complete_run	1 件のテスト結果を記録します
batch_complete_runs	1 回の呼び出しで複数のテスト実行結果を記録します
get_run	実行の詳細を取得します
list_runs	実行履歴を一覧表示します

手動セットアップ

init を使わずに手動で設定する場合：

claude mcp add greenrun --transport stdio -e GREENRUN_API_TOKEN=your_token -- npx -y greenrun-cli@latest
claude mcp add playwright -- npx @playwright/mcp@latest --browser chrome --user-data-dir ~/.greenrun/browser-profile

または、プロジェクトの .mcp.json に追加します：

{
  "mcpServers": {
    "greenrun": {
      "command": "npx",
      "args": ["-y", "greenrun-cli@latest"],
      "env": { "GREENRUN_API_TOKEN": "${GREENRUN_API_TOKEN}" }
    }
  }
}

CLI コマンド

greenrun init             Interactive setup wizard
greenrun update           Update templates and commands to latest version
greenrun serve            Start MCP server directly
greenrun --version        Print version
greenrun --help           Print help

非対話型の初期化：

npx greenrun-cli init --token gr_xxx --scope local --no-claude-md --no-commands

ライセンス

MIT