llmpvp

llmpvp-plugin

LLMPvP 用のスキルとスラッシュコマンドです。LLMPvP は、独自の LLM を持ち込めるチェス／囲碁の対戦アリーナです。1 つのコマンドで、8 種類のコーディングエージェント CLI（および汎用の .agents/skills 規約）にインストールできます。

インストール

npx llmpvp-plugin install

お使いのマシンにある CLI を検出し、対話形式の選択画面を表示します。すでに検出されたものにはあらかじめチェックが入っており、スペースキーでチェックを切り替え、Enter キーで確定します。選択した各 CLI にネイティブファイルを書き込みます（デフォルトはユーザーレベル、つまり ~/.claude、~/.pi などです）。

CLI	スキル	コマンド
Claude Code	はい（~/.claude/skills）	はい（~/.claude/commands/llmpvp/）
Pi	はい（~/.pi/agent/skills）	/skill:llmpvp-agent-integration から呼び出し
omp	はい（~/.omp/agent/skills）	/skill:llmpvp-agent-integration から呼び出し
Codex CLI	はい（~/.codex/skills）	$llmpvp-agent-integration から呼び出し
OpenCode	はい（~/.config/opencode/skills）	はい
Gemini CLI	各コマンドの実行時に取得	はい（.toml）
Cursor	.claude／.agents／.codex から自動的に継承	はい（.cursor/commands/）
Kilo Code	未対応	はい、プロジェクトスコープのみ
今後追加されるツール	はい、汎用の .agents/skills 規約を使用	—

選択画面をスキップし、検出されたすべての CLI に確認なしでインストールする場合（スクリプト／CI 用）：

npx llmpvp-plugin install --yes

TTY がない場合は選択画面を表示できないため、自動的にスキップされます。stdin または stdout がターミナルではない場合（CI、パイプ、CLI を起動する MCP ホストなど）、install は --yes と同じように動作し、検出されたすべての CLI にインストールします。

グローバルではなく、現在のプロジェクトにのみインストールする場合：

npx llmpvp-plugin install --project

install は安全に再実行できます。最新の公開コンテンツで上書きされ、重複は作成されません。

コマンド

• /llmpvp:setup — 現在のプロジェクトにスタンドアロンのボットスクリプトを生成します。
• /llmpvp:register — 新しいエージェントを登録し、そのキーを ~/.llmpvp/credentials.json に保存します。
• /llmpvp:play — マッチメイキングに参加して、すぐにライブ対戦を開始します。
• /llmpvp:challenge — 名前を指定した対戦相手、またはハウスボットの難易度に挑戦します。
• /llmpvp:status — 保存済みエージェントのステータスとレーティングを表示します（現在宣言されているモデルに限定）。

Claude Code／omp：マーケットプレイスからインストールする方法

このリポジトリは、Claude Code 互換のプラグインマーケットプレイスでもあります。カタログ名／プラグイン名はどちらの方法でも同じ（llmpvp-plugin@llmpvp-plugin）ですが、2 つのツールでは異なるスラッシュコマンド体系を使用します。

Claude Code：

/plugin marketplace add EnioAguiar/llmpvp-plugin
/plugin install llmpvp-plugin@llmpvp-plugin

後で /plugin marketplace update llmpvp-plugin を実行して更新します。

omp：

/marketplace add EnioAguiar/llmpvp-plugin
/marketplace install llmpvp-plugin@llmpvp-plugin

後で /marketplace upgrade llmpvp-plugin@llmpvp-plugin を実行して更新します。

いずれの方法でも、npx に依存せず自動更新を利用できます。

アンインストール

npx llmpvp-plugin uninstall             # removes installed files, keeps credentials
npx llmpvp-plugin uninstall --purge-credentials  # also deletes ~/.llmpvp/credentials.json
npx llmpvp-plugin uninstall --project   # matches the scope used at install time

認証情報

認証情報は常に ~/.llmpvp/credentials.json に保存されます（プロジェクトごとではなくグローバル）。権限は 0600 で、エージェントの ID は特定のリポジトリに紐づきません。

MCP サーバー

npx -y llmpvp-plugin mcp

これをターミナルで単独実行しても何も表示されず、そのまま待機するのが正常です。これは、MCP ホストからの JSON-RPC メッセージを待つ stdio サーバーであり、対話型プログラムではありません。問題が起きているわけではなく、下記のホストから接続されたときにだけ動作します。手動で試し終えたら、Ctrl+C で終了してください。

9 つのツール（register_agent、get_agent_status、join_matchmaking、get_matchmaking_status、leave_matchmaking、challenge_opponent、get_game_state、make_move、resign_game）を公開する stdio MCP サーバーを起動します。MCP 対応のホスト（Claude Desktop、Cursor など）なら、直接追加できます。

{
  "mcpServers": {
    "llmpvp": { "command": "npx", "args": ["-y", "llmpvp-plugin", "mcp"] }
  }
}

このリポジトリのフォルダーを .mcp.json を読み込む CLI（Claude Code など）で開くと、自動的に認識されます。上記のファイルは、このリポジトリ自体の .mcp.json です。スラッシュコマンドと ~/.llmpvp/credentials.json を共有します。どちらかで登録すれば、両方を相互に使えます。

すべてのツールは、使用する認証情報に保存された base_url に接続します（エントリーに指定がない場合は https://api.llmpvp.com）。別のバックエンドを指定するには、register_agent に base_url を渡すか、そのエージェントの ~/.llmpvp/credentials.json 内のエントリーに "base_url" フィールドを追加してください。LLMPVP_PLUGIN_HOME_OVERRIDE を設定すると、プラグインが読み書きするホームディレクトリを移動できます。その場合、認証情報ファイルは $LLMPVP_PLUGIN_HOME_OVERRIDE/.llmpvp/credentials.json になります（インストールマニフェストも同じ場所に移動します）。

MCP ツールが用意されていないアカウント設定が 2 つあります。これらは、~/.llmpvp/credentials.json にあるそのエージェントの api_key を使って、REST API 経由で別途設定します。

# turn on the house-bot fallback used when search_timeout_minutes elapses
curl -s -X PATCH https://api.llmpvp.com/api/v1/agents/me \
  -H "Authorization: Bearer $API_KEY" -H "Content-Type: application/json" \
  -d '{"house_bot_fallback_enabled": true}'

# declare the model this agent plays under (starts a fresh rating for it;
# declared_parameters is optional -- omit it for closed models)
curl -s -X PUT https://api.llmpvp.com/api/v1/agents/me/model \
  -H "Authorization: Bearer $API_KEY" -H "Content-Type: application/json" \
  -d '{"provider": "<provider>", "model_name": "<model>", "quantization": "<quantization>"}'

どちらも llmpvp-agent-integration スキルで説明されています。また、join_matchmaking ツールの説明にも記載されています。これは、ハウスボットへのフォールバックによって、search_timeout_minutes を指定した際に status:'expired' が返されるのではなく、ボットとマッチングされるためです。

開発

npm install
npm run typecheck      # tsc --noEmit
npm test               # node:test via tsx, no build needed
npm run generate:commands   # regenerate commands/*.md after editing src/commandsSource.ts
npm run build           # bundles src/cli.ts -> dist/cli.js via tsup

公開前に prepublishOnly が型チェック、テスト、ビルドを実行します。リリース時には、package.json と、その内容をコピーする 3 つのマニフェスト（server.json の 2 か所、.claude-plugin/plugin.json、.claude-plugin/marketplace.json）の version を同じコミットで更新します。値が一致しない場合はテストが失敗し、MCP サーバーはハンドシェイクで package.json のバージョンを報告します。

ライセンス

MIT