uloop-cli 0.67.2 → 0.67.3

package/README.md

@@ -1,3 +1,5 @@
+[日本語](README_ja.md)
+
 # uloop-cli
 
 [![npm version](https://img.shields.io/npm/v/uloop-cli.svg)](https://www.npmjs.com/package/uloop-cli)
@@ -66,58 +68,287 @@ Skills are dynamically loaded from the uLoopMCP package in your Unity project. T
 
 Custom skills defined in your project are also automatically detected.
 
-## Direct CLI Usage
+## CLI Command Reference
+
+You can also call the CLI directly without using Skills.
+
+### Project Path / Port Specification
+
+If `--project-path` / `--port` is omitted, the port is automatically selected from the Unity project detected in the current directory.
 
-You can also call the CLI directly without using Skills:
+To operate multiple Unity instances from a single LLM tool, explicitly specify a project path or port:
 
 ```bash
-# List available tools
-uloop list
+# Specify by project path (absolute or relative)
+uloop compile --project-path /Users/foo/my-unity-project
+uloop compile --project-path ../other-project
 
-# Sync tool definitions from Unity to local cache
-uloop sync
+# Specify by port number
+uloop compile --port {target-port}
+```
 
-# Execute compilation
-uloop compile
+> [!NOTE]
+> - `--project-path` and `--port` cannot be used together.
+> - You can find the port number in each Unity's uLoopMCP Window.
+
+### Chaining Commands
 
-# Force recompile and wait for domain reload completion
+Chain commands with `&&` to automate a sequence of operations:
+
+```bash
+# Compile → wait for Domain Reload → play → focus Unity
+uloop compile --wait-for-domain-reload true && uloop control-play-mode --action Play && uloop focus-window
+```
+
+### Utility Commands
+
+```bash
+uloop list           # List available tools from Unity
+uloop sync           # Sync tool definitions from Unity to local cache
+uloop completion     # Setup shell completion
+```
+
+### compile
+
+Execute Unity project compilation.
+
+| Flag | Type | Default | Description |
+|------|------|---------|-------------|
+| `--force-recompile` | boolean | `false` | Force full recompilation |
+| `--wait-for-domain-reload` | boolean | `false` | Wait for Domain Reload completion |
+
+```bash
+uloop compile
 uloop compile --force-recompile true --wait-for-domain-reload true
+```
+
+### get-logs
 
-# Get logs
-uloop get-logs --max-count 10
+Retrieve logs from Unity Console.
 
-# Run tests
-uloop run-tests --filter-type all
+| Flag | Type | Default | Description |
+|------|------|---------|-------------|
+| `--log-type` | enum | `All` | Log type filter: `Error`, `Warning`, `Log`, `All` |
+| `--max-count` | integer | `100` | Maximum number of logs to retrieve |
+| `--search-text` | string | | Text to search within logs |
+| `--include-stack-trace` | boolean | `false` | Include stack trace in output |
+| `--use-regex` | boolean | `false` | Use regex for search |
+| `--search-in-stack-trace` | boolean | `false` | Search within stack trace |
 
-# Execute dynamic code
-uloop execute-dynamic-code --code 'using UnityEngine; Debug.Log("Hello from CLI!");'
+```bash
+uloop get-logs
+uloop get-logs --log-type Error --max-count 10
+uloop get-logs --search-text "NullReference" --include-stack-trace true
 ```
 
-## Shell Completion
+### run-tests
 
-Install Bash/Zsh/PowerShell completion for tab-completion support:
+Execute Unity Test Runner.
+
+| Flag | Type | Default | Description |
+|------|------|---------|-------------|
+| `--test-mode` | enum | `EditMode` | Test mode: `EditMode`, `PlayMode` |
+| `--filter-type` | enum | `all` | Filter type: `all`, `exact`, `regex`, `assembly` |
+| `--filter-value` | string | | Filter value (used when filter-type is not `all`) |
 
 ```bash
-# Auto-detect shell and install
-uloop completion --install
+uloop run-tests
+uloop run-tests --test-mode EditMode --filter-type regex --filter-value "MyTests"
+uloop run-tests --filter-type assembly --filter-value "MyApp.Tests.Editor"
+```
 
-# Explicitly specify shell
-uloop completion --shell bash --install        # Git Bash / MINGW64
-uloop completion --shell powershell --install  # PowerShell
+### clear-console
+
+Clear Unity console logs.
+
+| Flag | Type | Default | Description |
+|------|------|---------|-------------|
+| `--add-confirmation-message` | boolean | `true` | Add confirmation message after clearing |
+
+```bash
+uloop clear-console
+```
+
+### focus-window
+
+Bring Unity Editor window to front.
+
+No parameters.
+
+```bash
+uloop focus-window
+```
+
+### get-hierarchy
+
+Get Unity Hierarchy structure.
+
+| Flag | Type | Default | Description |
+|------|------|---------|-------------|
+| `--root-path` | string | | Root GameObject path to start from |
+| `--max-depth` | integer | `-1` | Maximum depth (-1 for unlimited) |
+| `--include-components` | boolean | `true` | Include component information |
+| `--include-inactive` | boolean | `true` | Include inactive GameObjects |
+| `--include-paths` | boolean | `false` | Include path information |
+| `--use-components-lut` | string | `auto` | Use LUT for components: `auto`, `true`, `false` |
+| `--use-selection` | boolean | `false` | Use selected GameObject(s) as root(s) |
+
+```bash
+uloop get-hierarchy
+uloop get-hierarchy --root-path "Canvas" --max-depth 3
+uloop get-hierarchy --use-selection true
+```
+
+### unity-search
+
+Search Unity project.
+
+| Flag | Type | Default | Description |
+|------|------|---------|-------------|
+| `--search-query` | string | | Search query (Unity Search syntax) |
+| `--providers` | array | | Search providers (e.g., `asset`, `scene`, `menu`) |
+| `--max-results` | integer | `50` | Maximum number of results |
+| `--include-description` | boolean | `true` | Include detailed descriptions in results |
+| `--include-metadata` | boolean | `false` | Include file metadata (size, modified date) |
+| `--search-flags` | enum | `Default` | Search flags: `Default`, `Synchronous`, `WantsMore`, `Packages`, `Sorted` |
+| `--save-to-file` | boolean | `false` | Save results to file |
+| `--output-format` | enum | `JSON` | Output format when saving: `JSON`, `CSV`, `TSV` |
+| `--auto-save-threshold` | integer | `100` | Auto-save threshold (0 to disable) |
+| `--file-extensions` | array | | Filter by file extension (e.g., `cs`, `prefab`, `mat`) |
+| `--asset-types` | array | | Filter by asset type (e.g., `Texture2D`, `GameObject`) |
+| `--path-filter` | string | | Filter by path pattern (supports wildcards) |
+
+```bash
+uloop unity-search --search-query "*.prefab"
+uloop unity-search --search-query "t:Texture2D" --max-results 10
+uloop unity-search --search-query "t:MonoScript *.cs" --save-to-file true
+```
+
+### get-menu-items
+
+Retrieve Unity MenuItems.
+
+| Flag | Type | Default | Description |
+|------|------|---------|-------------|
+| `--filter-text` | string | | Text to filter MenuItem paths |
+| `--filter-type` | enum | `contains` | Filter type: `contains`, `exact`, `startswith` |
+| `--max-count` | integer | `200` | Maximum number of items |
+| `--include-validation` | boolean | `false` | Include validation functions |
+
+```bash
+uloop get-menu-items
+uloop get-menu-items --filter-text "GameObject" --filter-type startswith
+```
+
+### execute-menu-item
+
+Execute Unity MenuItem by path.
+
+| Flag | Type | Default | Description |
+|------|------|---------|-------------|
+| `--menu-item-path` | string | | Menu item path (e.g., "GameObject/Create Empty") |
+| `--use-reflection-fallback` | boolean | `true` | Use reflection fallback if direct execution fails |
+
+```bash
+uloop execute-menu-item --menu-item-path "File/Save"
+uloop execute-menu-item --menu-item-path "GameObject/Create Empty"
+```
+
+### find-game-objects
+
+Find GameObjects with search criteria.
+
+| Flag | Type | Default | Description |
+|------|------|---------|-------------|
+| `--name-pattern` | string | | Name pattern to search |
+| `--search-mode` | enum | `Exact` | Search mode: `Exact`, `Path`, `Regex`, `Contains`, `Selected` |
+| `--required-components` | array | | Required component type names |
+| `--tag` | string | | Tag filter |
+| `--layer` | integer | | Layer filter |
+| `--max-results` | integer | `20` | Maximum number of results |
+| `--include-inactive` | boolean | `false` | Include inactive GameObjects |
+| `--include-inherited-properties` | boolean | `false` | Include inherited properties |
+
+```bash
+uloop find-game-objects --name-pattern "Player"
+uloop find-game-objects --required-components "Camera" --include-inactive true
+uloop find-game-objects --tag "Enemy" --max-results 50
+```
+
+### capture-window
+
+Capture Unity EditorWindow and save as PNG.
+
+| Flag | Type | Default | Description |
+|------|------|---------|-------------|
+| `--window-name` | string | `Game` | Window name (e.g., "Game", "Scene", "Console", "Inspector") |
+| `--resolution-scale` | number | `1` | Resolution scale (0.1 to 1.0) |
+| `--match-mode` | enum | `exact` | Matching mode: `exact`, `prefix`, `contains` (case-insensitive) |
+
+```bash
+uloop capture-window
+uloop capture-window --window-name Scene
+uloop capture-window --window-name Project --match-mode prefix
 ```
 
-## Port Specification
+### execute-dynamic-code
+
+Execute C# code in Unity Editor.
 
-You can operate multiple Unity instances by specifying the `--port` option:
+| Flag | Type | Default | Description |
+|------|------|---------|-------------|
+| `--code` | string | | C# code to execute |
+| `--parameters` | object | | Runtime parameters for execution |
+| `--compile-only` | boolean | `false` | Compile only without execution |
 
 ```bash
-uloop compile --port 8700
-uloop compile --port 8701
+uloop execute-dynamic-code --code 'using UnityEngine; Debug.Log("Hello!");'
+uloop execute-dynamic-code --code 'Selection.activeGameObject.name' --compile-only true
 ```
 
-If `--port` is omitted, the port configured for the current project is automatically used.
+### get-provider-details
+
+Get Unity Search provider details.
+
+| Flag | Type | Default | Description |
+|------|------|---------|-------------|
+| `--provider-id` | string | | Specific provider ID (e.g., "asset", "scene") |
+| `--active-only` | boolean | `false` | Only active providers |
+| `--include-descriptions` | boolean | `true` | Include descriptions |
+| `--sort-by-priority` | boolean | `true` | Sort by priority |
+
+```bash
+uloop get-provider-details
+uloop get-provider-details --provider-id asset
+uloop get-provider-details --active-only true
+```
+
+### control-play-mode
+
+Control Unity Editor play mode.
+
+| Flag | Type | Default | Description |
+|------|------|---------|-------------|
+| `--action` | enum | `Play` | Action: `Play`, `Stop`, `Pause` |
+
+```bash
+uloop control-play-mode --action Play
+uloop control-play-mode --action Stop
+uloop control-play-mode --action Pause
+```
 
-You can find the port number in each Unity's uLoopMCP Window.
+## Shell Completion
+
+Install Bash/Zsh/PowerShell completion for tab-completion support:
+
+```bash
+# Auto-detect shell and install
+uloop completion --install
+
+# Explicitly specify shell
+uloop completion --shell bash --install        # Git Bash / MINGW64
+uloop completion --shell powershell --install  # PowerShell
+```
 
 ## Requirements
 
@@ -128,7 +359,7 @@ You can find the port number in each Unity's uLoopMCP Window.
 ## Links
 
 - [uLoopMCP Repository](https://github.com/hatayama/uLoopMCP) - Main package and documentation
-- [Tool Reference](https://github.com/hatayama/uLoopMCP/blob/main/Packages/src/TOOL_REFERENCE.md) - Detailed tool specifications
+- [Tool Reference](https://github.com/hatayama/uLoopMCP/blob/main/Packages/src/TOOL_REFERENCE.md) - Detailed API specifications and response schemas
 
 ## License
 

package/README_ja.md

@@ -0,0 +1,366 @@
+[English](README.md)
+
+# uloop-cli
+
+[![npm version](https://img.shields.io/npm/v/uloop-cli.svg)](https://www.npmjs.com/package/uloop-cli)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![Node.js](https://img.shields.io/badge/Node.js-20+-green.svg)](https://nodejs.org/)
+
+**[uLoopMCP](https://github.com/hatayama/uLoopMCP) の CLI コンパニオン** - AIエージェントにUnityプロジェクトのコンパイル、テスト、操作を任せましょう。
+
+> **前提条件**: このCLIを使用するには、Unityプロジェクトに [uLoopMCP](https://github.com/hatayama/uLoopMCP) がインストールされ、サーバーが起動している必要があります。セットアップ手順は [メインリポジトリ](https://github.com/hatayama/uLoopMCP) を参照してください。
+
+## インストール
+
+```bash
+npm install -g uloop-cli
+```
+
+## クイックスタート
+
+### ステップ 1: Skills のインストール
+
+Skills を使うと、LLMツール（Claude Code、Cursor など）がUnity操作を自動的に呼び出せるようになります。
+
+```bash
+# Claude Code 用にインストール（プロジェクトレベル）
+uloop skills install --claude
+
+# OpenAI Codex 用にインストール（プロジェクトレベル）
+uloop skills install --codex
+
+# グローバルにインストールすることも可能
+uloop skills install --claude --global
+uloop skills install --codex --global
+```
+
+### ステップ 2: LLM ツールで使う
+
+Skills をインストールすると、LLMツールが以下のような指示を自動的に処理できるようになります：
+
+| あなたの指示 | 使用される Skill |
+|---|---|
+| 「コンパイルエラーを直して」 | `/uloop-compile` |
+| 「テストを実行して、失敗の原因を教えて」 | `/uloop-run-tests` |
+| 「シーンの階層構造を確認して」 | `/uloop-get-hierarchy` |
+| 「プレハブを検索して」 | `/uloop-unity-search` |
+
+> **MCP の設定は不要です！** uLoopMCP Window でサーバーが起動していれば、LLMツールは Skills を通じてUnityと直接通信します。
+
+## 利用可能な Skills
+
+Skills はUnityプロジェクト内の uLoopMCP パッケージから動的に読み込まれます。以下は uLoopMCP が提供するデフォルトの Skills です：
+
+- `/uloop-compile` - コンパイルの実行
+- `/uloop-get-logs` - コンソールログの取得
+- `/uloop-run-tests` - テストの実行
+- `/uloop-clear-console` - コンソールのクリア
+- `/uloop-focus-window` - Unity Editor を前面に表示
+- `/uloop-get-hierarchy` - シーン階層の取得
+- `/uloop-unity-search` - Unity 検索
+- `/uloop-get-menu-items` - メニューアイテムの取得
+- `/uloop-execute-menu-item` - メニューアイテムの実行
+- `/uloop-find-game-objects` - GameObject の検索
+- `/uloop-capture-window` - EditorWindow のキャプチャ
+- `/uloop-control-play-mode` - Play Mode の制御
+- `/uloop-execute-dynamic-code` - 動的 C# コードの実行
+- `/uloop-get-provider-details` - 検索プロバイダー詳細の取得
+
+プロジェクトで定義したカスタム Skills も自動的に検出されます。
+
+## CLI コマンドリファレンス
+
+Skills を使わずに、CLI を直接呼び出すこともできます。
+
+### プロジェクトパス指定 / ポート指定
+
+`--project-path` / `--port` を省略した場合は、カレントディレクトリの Unity プロジェクトで設定されたポートが自動選択されます。
+
+一つのLLMツールから複数のUnityインスタンスを操作したい場合、プロジェクトパスまたはポートを明示的に指定します：
+
+```bash
+# プロジェクトパスで指定（絶対パス・相対パスどちらも可）
+uloop compile --project-path /Users/foo/my-unity-project
+uloop compile --project-path ../other-project
+
+# ポート番号で指定
+uloop compile --port {target-port}
+```
+
+> [!NOTE]
+> - `--project-path` と `--port` は同時に指定できません。
+> - ポート番号は各Unityの uLoopMCP Window で確認できます。
+
+### コマンドの連携
+
+`&&` でコマンドを連結することで、一連の操作を自動化できます：
+
+```bash
+# コンパイル → Domain Reload 待機 → 再生 → Unity にフォーカス
+uloop compile --wait-for-domain-reload true && uloop control-play-mode --action Play && uloop focus-window
+```
+
+### ユーティリティコマンド
+
+```bash
+uloop list           # Unity から利用可能なツールを一覧表示
+uloop sync           # Unity からツール定義をローカルキャッシュに同期
+uloop completion     # シェル補完のセットアップ
+```
+
+### compile
+
+Unity プロジェクトのコンパイルを実行します。
+
+| フラグ | 型 | デフォルト | 説明 |
+|--------|------|---------|-------------|
+| `--force-recompile` | boolean | `false` | 強制再コンパイルを実行 |
+| `--wait-for-domain-reload` | boolean | `false` | Domain Reload 完了まで待機 |
+
+```bash
+uloop compile
+uloop compile --force-recompile true --wait-for-domain-reload true
+```
+
+### get-logs
+
+Unity コンソールからログを取得します。
+
+| フラグ | 型 | デフォルト | 説明 |
+|--------|------|---------|-------------|
+| `--log-type` | enum | `All` | ログタイプフィルタ: `Error`, `Warning`, `Log`, `All` |
+| `--max-count` | integer | `100` | 取得するログの最大数 |
+| `--search-text` | string | | ログ内で検索するテキスト |
+| `--include-stack-trace` | boolean | `false` | スタックトレースを含める |
+| `--use-regex` | boolean | `false` | 正規表現で検索 |
+| `--search-in-stack-trace` | boolean | `false` | スタックトレース内も検索 |
+
+```bash
+uloop get-logs
+uloop get-logs --log-type Error --max-count 10
+uloop get-logs --search-text "NullReference" --include-stack-trace true
+```
+
+### run-tests
+
+Unity Test Runner を実行します。
+
+| フラグ | 型 | デフォルト | 説明 |
+|--------|------|---------|-------------|
+| `--test-mode` | enum | `EditMode` | テストモード: `EditMode`, `PlayMode` |
+| `--filter-type` | enum | `all` | フィルタタイプ: `all`, `exact`, `regex`, `assembly` |
+| `--filter-value` | string | | フィルタ値（filter-type が `all` 以外の場合に使用） |
+
+```bash
+uloop run-tests
+uloop run-tests --test-mode EditMode --filter-type regex --filter-value "MyTests"
+uloop run-tests --filter-type assembly --filter-value "MyApp.Tests.Editor"
+```
+
+### clear-console
+
+Unity コンソールログをクリアします。
+
+| フラグ | 型 | デフォルト | 説明 |
+|--------|------|---------|-------------|
+| `--add-confirmation-message` | boolean | `true` | クリア後に確認メッセージを追加 |
+
+```bash
+uloop clear-console
+```
+
+### focus-window
+
+Unity Editor ウィンドウを前面に表示します。
+
+パラメータなし。
+
+```bash
+uloop focus-window
+```
+
+### get-hierarchy
+
+Unity Hierarchy 構造を取得します。
+
+| フラグ | 型 | デフォルト | 説明 |
+|--------|------|---------|-------------|
+| `--root-path` | string | | 開始するルート GameObject パス |
+| `--max-depth` | integer | `-1` | 最大深度（-1 で無制限） |
+| `--include-components` | boolean | `true` | コンポーネント情報を含める |
+| `--include-inactive` | boolean | `true` | 非アクティブな GameObject を含める |
+| `--include-paths` | boolean | `false` | パス情報を含める |
+| `--use-components-lut` | string | `auto` | コンポーネント用 LUT の使用: `auto`, `true`, `false` |
+| `--use-selection` | boolean | `false` | 選択中の GameObject をルートとして使用 |
+
+```bash
+uloop get-hierarchy
+uloop get-hierarchy --root-path "Canvas" --max-depth 3
+uloop get-hierarchy --use-selection true
+```
+
+### unity-search
+
+Unity プロジェクトを検索します。
+
+| フラグ | 型 | デフォルト | 説明 |
+|--------|------|---------|-------------|
+| `--search-query` | string | | 検索クエリ（Unity Search 構文） |
+| `--providers` | array | | 検索プロバイダー（例: `asset`, `scene`, `menu`） |
+| `--max-results` | integer | `50` | 結果の最大数 |
+| `--include-description` | boolean | `true` | 結果に詳細な説明を含める |
+| `--include-metadata` | boolean | `false` | ファイルメタデータ（サイズ、更新日）を含める |
+| `--search-flags` | enum | `Default` | 検索フラグ: `Default`, `Synchronous`, `WantsMore`, `Packages`, `Sorted` |
+| `--save-to-file` | boolean | `false` | 結果をファイルに保存 |
+| `--output-format` | enum | `JSON` | 保存時の出力形式: `JSON`, `CSV`, `TSV` |
+| `--auto-save-threshold` | integer | `100` | 自動保存の閾値（0 で無効化） |
+| `--file-extensions` | array | | ファイル拡張子でフィルタ（例: `cs`, `prefab`, `mat`） |
+| `--asset-types` | array | | アセットタイプでフィルタ（例: `Texture2D`, `GameObject`） |
+| `--path-filter` | string | | パスパターンでフィルタ（ワイルドカード対応） |
+
+```bash
+uloop unity-search --search-query "*.prefab"
+uloop unity-search --search-query "t:Texture2D" --max-results 10
+uloop unity-search --search-query "t:MonoScript *.cs" --save-to-file true
+```
+
+### get-menu-items
+
+Unity MenuItem を取得します。
+
+| フラグ | 型 | デフォルト | 説明 |
+|--------|------|---------|-------------|
+| `--filter-text` | string | | MenuItem パスのフィルタテキスト |
+| `--filter-type` | enum | `contains` | フィルタタイプ: `contains`, `exact`, `startswith` |
+| `--max-count` | integer | `200` | アイテムの最大数 |
+| `--include-validation` | boolean | `false` | 検証関数を含める |
+
+```bash
+uloop get-menu-items
+uloop get-menu-items --filter-text "GameObject" --filter-type startswith
+```
+
+### execute-menu-item
+
+パスを指定して Unity MenuItem を実行します。
+
+| フラグ | 型 | デフォルト | 説明 |
+|--------|------|---------|-------------|
+| `--menu-item-path` | string | | メニューアイテムパス（例: "GameObject/Create Empty"） |
+| `--use-reflection-fallback` | boolean | `true` | 直接実行が失敗した場合にリフレクションを使用 |
+
+```bash
+uloop execute-menu-item --menu-item-path "File/Save"
+uloop execute-menu-item --menu-item-path "GameObject/Create Empty"
+```
+
+### find-game-objects
+
+検索条件で GameObject を検索します。
+
+| フラグ | 型 | デフォルト | 説明 |
+|--------|------|---------|-------------|
+| `--name-pattern` | string | | 検索する名前パターン |
+| `--search-mode` | enum | `Exact` | 検索モード: `Exact`, `Path`, `Regex`, `Contains`, `Selected` |
+| `--required-components` | array | | 必須コンポーネントタイプ名 |
+| `--tag` | string | | タグフィルター |
+| `--layer` | integer | | レイヤーフィルター |
+| `--max-results` | integer | `20` | 結果の最大数 |
+| `--include-inactive` | boolean | `false` | 非アクティブな GameObject を含める |
+| `--include-inherited-properties` | boolean | `false` | 継承プロパティを含める |
+
+```bash
+uloop find-game-objects --name-pattern "Player"
+uloop find-game-objects --required-components "Camera" --include-inactive true
+uloop find-game-objects --tag "Enemy" --max-results 50
+```
+
+### capture-window
+
+Unity EditorWindow をキャプチャして PNG として保存します。
+
+| フラグ | 型 | デフォルト | 説明 |
+|--------|------|---------|-------------|
+| `--window-name` | string | `Game` | ウィンドウ名（例: "Game", "Scene", "Console", "Inspector"） |
+| `--resolution-scale` | number | `1` | 解像度スケール（0.1〜1.0） |
+| `--match-mode` | enum | `exact` | マッチングモード: `exact`, `prefix`, `contains`（大文字小文字区別なし） |
+
+```bash
+uloop capture-window
+uloop capture-window --window-name Scene
+uloop capture-window --window-name Project --match-mode prefix
+```
+
+### execute-dynamic-code
+
+Unity Editor 内で C# コードを実行します。
+
+| フラグ | 型 | デフォルト | 説明 |
+|--------|------|---------|-------------|
+| `--code` | string | | 実行する C# コード |
+| `--parameters` | object | | 実行時パラメータ |
+| `--compile-only` | boolean | `false` | コンパイルのみ（実行はしない） |
+
+```bash
+uloop execute-dynamic-code --code 'using UnityEngine; Debug.Log("Hello!");'
+uloop execute-dynamic-code --code 'Selection.activeGameObject.name' --compile-only true
+```
+
+### get-provider-details
+
+Unity Search プロバイダーの詳細を取得します。
+
+| フラグ | 型 | デフォルト | 説明 |
+|--------|------|---------|-------------|
+| `--provider-id` | string | | 特定のプロバイダー ID（例: "asset", "scene"） |
+| `--active-only` | boolean | `false` | アクティブなプロバイダーのみ |
+| `--include-descriptions` | boolean | `true` | 説明を含める |
+| `--sort-by-priority` | boolean | `true` | 優先度でソート |
+
+```bash
+uloop get-provider-details
+uloop get-provider-details --provider-id asset
+uloop get-provider-details --active-only true
+```
+
+### control-play-mode
+
+Unity Editor のプレイモードを制御します。
+
+| フラグ | 型 | デフォルト | 説明 |
+|--------|------|---------|-------------|
+| `--action` | enum | `Play` | アクション: `Play`, `Stop`, `Pause` |
+
+```bash
+uloop control-play-mode --action Play
+uloop control-play-mode --action Stop
+uloop control-play-mode --action Pause
+```
+
+## シェル補完
+
+Bash/Zsh/PowerShell のタブ補完をインストールできます：
+
+```bash
+# シェルを自動検出してインストール
+uloop completion --install
+
+# シェルを明示的に指定
+uloop completion --shell bash --install        # Git Bash / MINGW64
+uloop completion --shell powershell --install  # PowerShell
+```
+
+## 動作要件
+
+- **Node.js 20.0 以降**
+- **Unity 2022.3 以降**（[uLoopMCP](https://github.com/hatayama/uLoopMCP) がインストール済みであること）
+- uLoopMCP サーバーが起動していること（Window > uLoopMCP > Start Server）
+
+## リンク
+
+- [uLoopMCP リポジトリ](https://github.com/hatayama/uLoopMCP) - メインパッケージとドキュメント
+- [ツールリファレンス](https://github.com/hatayama/uLoopMCP/blob/main/Packages/src/TOOL_REFERENCE.md) - 詳細な API 仕様とレスポンススキーマ
+
+## ライセンス
+
+MIT License