uloop-cli 0.68.2 → 0.68.3

package/README.md

@@ -64,11 +64,12 @@ Skills are dynamically loaded from the uLoopMCP package in your Unity project. T
 - `/uloop-screenshot` - Take a screenshot of EditorWindow
 - `/uloop-control-play-mode` - Control Play Mode
 - `/uloop-execute-dynamic-code` - Execute dynamic C# code
-- `/uloop-get-provider-details` - Get search provider details
+- `/uloop-launch` - Launch Unity project with matching Editor version
 
 Custom skills defined in your project are also automatically detected.
 
-## CLI Command Reference
+## CLI Command Reference  
+([日本語](README_ja.md#cli-コマンドリファレンス))
 
 You can also call the CLI directly without using Skills.
 
@@ -122,6 +123,11 @@ uloop compile
 uloop compile --force-recompile true --wait-for-domain-reload true
 ```
 
+**Output:**
+- `Success` (boolean | null) - Compilation succeeded (`null` when `--force-recompile` is used)
+- `ErrorCount` / `WarningCount` (integer | null) - Number of errors/warnings (`null` when `--force-recompile` is used)
+- `Errors` / `Warnings` (array | null) - Issues with `Message`, `File`, `Line` fields (`null` when `--force-recompile` is used)
+
 ### get-logs
 
 Retrieve logs from Unity Console.
@@ -141,6 +147,11 @@ uloop get-logs --log-type Error --max-count 10
 uloop get-logs --search-text "NullReference" --include-stack-trace true
 ```
 
+**Output:**
+- `TotalCount` (integer) - Total available logs matching filter
+- `DisplayedCount` (integer) - Number of logs returned
+- `Logs` (array) - Log entries with `Type` (Error/Warning/Log), `Message`, `StackTrace` fields
+
 ### run-tests
 
 Execute Unity Test Runner.
@@ -157,6 +168,11 @@ uloop run-tests --test-mode EditMode --filter-type regex --filter-value "MyTests
 uloop run-tests --filter-type assembly --filter-value "MyApp.Tests.Editor"
 ```
 
+**Output:**
+- `Success` (boolean) - All tests passed
+- `TestCount` / `PassedCount` / `FailedCount` / `SkippedCount` (integer) - Test result counts
+- `XmlPath` (string) - Path to NUnit XML result file (saved on failure)
+
 ### clear-console
 
 Clear Unity console logs.
@@ -169,6 +185,10 @@ Clear Unity console logs.
 uloop clear-console
 ```
 
+**Output:**
+- `Success` (boolean) - Operation succeeded
+- `ClearedLogCount` (integer) - Number of logs cleared
+
 ### focus-window
 
 Bring Unity Editor window to front.
@@ -179,6 +199,10 @@ No parameters.
 uloop focus-window
 ```
 
+**Output:**
+- `Success` (boolean) - Operation succeeded
+- `Message` (string) - Result message
+
 ### get-hierarchy
 
 Get Unity Hierarchy structure.
@@ -199,6 +223,9 @@ uloop get-hierarchy --root-path "Canvas" --max-depth 3
 uloop get-hierarchy --use-selection true
 ```
 
+**Output:**
+- `hierarchyFilePath` (string) - Path to saved JSON file containing hierarchy data
+
 ### unity-search
 
 Search Unity project.
@@ -224,6 +251,13 @@ uloop unity-search --search-query "t:Texture2D" --max-results 10
 uloop unity-search --search-query "t:MonoScript *.cs" --save-to-file true
 ```
 
+**Output:**
+- `TotalCount` (integer) - Total results found
+- `DisplayedCount` (integer) - Results returned
+- `Results` (array) - Search result items
+- `SearchDurationMs` (integer) - Search time in milliseconds
+- `ResultsFilePath` (string) - File path when results are saved to file
+
 ### get-menu-items
 
 Retrieve Unity MenuItems.
@@ -240,6 +274,11 @@ uloop get-menu-items
 uloop get-menu-items --filter-text "GameObject" --filter-type startswith
 ```
 
+**Output:**
+- `TotalCount` (integer) - Total MenuItems before filtering
+- `FilteredCount` (integer) - MenuItems after filtering
+- `MenuItems` (array) - Items with `Path`, `Priority`, `MethodName` fields
+
 ### execute-menu-item
 
 Execute Unity MenuItem by path.
@@ -254,6 +293,11 @@ uloop execute-menu-item --menu-item-path "File/Save"
 uloop execute-menu-item --menu-item-path "GameObject/Create Empty"
 ```
 
+**Output:**
+- `Success` (boolean) - Execution succeeded
+- `MenuItemPath` (string) - Executed menu path
+- `ExecutionMethod` (string) - Method used (EditorApplication or Reflection)
+
 ### find-game-objects
 
 Find GameObjects with search criteria.
@@ -275,15 +319,20 @@ uloop find-game-objects --required-components "Camera" --include-inactive true
 uloop find-game-objects --tag "Enemy" --max-results 50
 ```
 
+**Output:**
+- `totalFound` (integer) - Total GameObjects found
+- `results` (array) - GameObjects with `name`, `path`, `isActive`, `tag`, `layer`, `components` fields
+
 ### screenshot
 
 Take a screenshot of Unity EditorWindow and save as PNG.
 
 | Flag | Type | Default | Description |
 |------|------|---------|-------------|
-| `--window-name` | string | `Game` | Window name (e.g., "Game", "Scene", "Console", "Inspector") |
+| `--window-name` | string | `Game` | Window name (e.g., "Game", "Scene", "Console", "Inspector", "Project", "Hierarchy") |
 | `--resolution-scale` | number | `1` | Resolution scale (0.1 to 1.0) |
 | `--match-mode` | enum | `exact` | Matching mode: `exact`, `prefix`, `contains` (case-insensitive) |
+| `--output-directory` | string | | Output directory path (uses .uloop/outputs/Screenshots/ when empty) |
 
 ```bash
 uloop screenshot
@@ -291,6 +340,10 @@ uloop screenshot --window-name Scene
 uloop screenshot --window-name Project --match-mode prefix
 ```
 
+**Output:**
+- `ScreenshotCount` (integer) - Number of windows captured
+- `Screenshots` (array) - Items with `ImagePath`, `Width`, `Height`, `FileSizeBytes` fields
+
 ### execute-dynamic-code
 
 Execute C# code in Unity Editor.
@@ -306,35 +359,51 @@ uloop execute-dynamic-code --code 'using UnityEngine; Debug.Log("Hello!");'
 uloop execute-dynamic-code --code 'Selection.activeGameObject.name' --compile-only true
 ```
 
-### get-provider-details
+**Output:**
+- `Success` (boolean) - Execution succeeded
+- `Result` (string) - Return value of executed code
+- `Logs` (array) - Log messages emitted during execution
+- `CompilationErrors` (array) - Errors with `Message`, `Line`, `Column`, `Hint` fields
 
-Get Unity Search provider details.
+### control-play-mode
+
+Control Unity Editor play mode.
 
 | 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 |
+| `--action` | enum | `Play` | Action: `Play`, `Stop`, `Pause` |
 
 ```bash
-uloop get-provider-details
-uloop get-provider-details --provider-id asset
-uloop get-provider-details --active-only true
+uloop control-play-mode --action Play
+uloop control-play-mode --action Stop
+uloop control-play-mode --action Pause
 ```
 
-### control-play-mode
+**Output:**
+- `IsPlaying` (boolean) - Currently in play mode
+- `IsPaused` (boolean) - Currently paused
+- `Message` (string) - Action description
 
-Control Unity Editor play mode.
+### launch
+
+Open a Unity project with the matching Editor version.
 
 | Flag | Type | Default | Description |
 |------|------|---------|-------------|
-| `--action` | enum | `Play` | Action: `Play`, `Stop`, `Pause` |
+| `[project-path]` | string | | Path to Unity project (searches current directory if omitted) |
+| `-r, --restart` | flag | | Kill running Unity and restart |
+| `-q, --quit` | flag | | Gracefully quit running Unity |
+| `-d, --delete-recovery` | flag | | Delete Assets/_Recovery before launch |
+| `-p, --platform <platform>` | string | | Build target (e.g., Android, iOS, StandaloneOSX) |
+| `--max-depth <n>` | number | `3` | Search depth when project-path is omitted (-1 for unlimited) |
+| `-a, --add-unity-hub` | flag | | Add to Unity Hub only (does not launch) |
+| `-f, --favorite` | flag | | Add to Unity Hub as favorite (does not launch) |
 
 ```bash
-uloop control-play-mode --action Play
-uloop control-play-mode --action Stop
-uloop control-play-mode --action Pause
+uloop launch
+uloop launch /path/to/project
+uloop launch -r
+uloop launch -p Android
 ```
 
 ## Shell Completion

package/README_ja.md

@@ -64,11 +64,12 @@ Skills はUnityプロジェクト内の uLoopMCP パッケージから動的に
 - `/uloop-screenshot` - EditorWindow のスクリーンショット
 - `/uloop-control-play-mode` - Play Mode の制御
 - `/uloop-execute-dynamic-code` - 動的 C# コードの実行
-- `/uloop-get-provider-details` - 検索プロバイダー詳細の取得
+- `/uloop-launch` - Unity プロジェクトを対応する Editor バージョンで起動
 
 プロジェクトで定義したカスタム Skills も自動的に検出されます。
 
-## CLI コマンドリファレンス
+## CLI コマンドリファレンス  
+([English](README.md#cli-command-reference))
 
 Skills を使わずに、CLI を直接呼び出すこともできます。
 
@@ -122,6 +123,11 @@ uloop compile
 uloop compile --force-recompile true --wait-for-domain-reload true
 ```
 
+**Output:**
+- `Success` (boolean) - コンパイル成功（`--force-recompile` 使用時は `null`）
+- `ErrorCount` / `WarningCount` (integer) - エラー数/警告数
+- `Errors` / `Warnings` (array) - `Message`, `File`, `Line` フィールドを含む問題一覧
+
 ### get-logs
 
 Unity コンソールからログを取得します。
@@ -141,6 +147,11 @@ uloop get-logs --log-type Error --max-count 10
 uloop get-logs --search-text "NullReference" --include-stack-trace true
 ```
 
+**Output:**
+- `TotalCount` (integer) - フィルタに一致するログの総数
+- `DisplayedCount` (integer) - 返されたログ数
+- `Logs` (array) - `Type` (Error/Warning/Log), `Message`, `StackTrace` フィールドを含むログエントリ
+
 ### run-tests
 
 Unity Test Runner を実行します。
@@ -157,6 +168,11 @@ uloop run-tests --test-mode EditMode --filter-type regex --filter-value "MyTests
 uloop run-tests --filter-type assembly --filter-value "MyApp.Tests.Editor"
 ```
 
+**Output:**
+- `Success` (boolean) - 全テスト合格
+- `TestCount` / `PassedCount` / `FailedCount` / `SkippedCount` (integer) - テスト結果の件数
+- `XmlPath` (string) - NUnit XML 結果ファイルのパス（失敗時に保存）
+
 ### clear-console
 
 Unity コンソールログをクリアします。
@@ -169,6 +185,10 @@ Unity コンソールログをクリアします。
 uloop clear-console
 ```
 
+**Output:**
+- `Success` (boolean) - 操作成功
+- `ClearedLogCount` (integer) - クリアされたログ数
+
 ### focus-window
 
 Unity Editor ウィンドウを前面に表示します。
@@ -179,6 +199,10 @@ Unity Editor ウィンドウを前面に表示します。
 uloop focus-window
 ```
 
+**Output:**
+- `Success` (boolean) - 操作成功
+- `Message` (string) - 結果メッセージ
+
 ### get-hierarchy
 
 Unity Hierarchy 構造を取得します。
@@ -199,6 +223,9 @@ uloop get-hierarchy --root-path "Canvas" --max-depth 3
 uloop get-hierarchy --use-selection true
 ```
 
+**Output:**
+- `hierarchyFilePath` (string) - 階層データを含む JSON ファイルのパス
+
 ### unity-search
 
 Unity プロジェクトを検索します。
@@ -224,6 +251,13 @@ uloop unity-search --search-query "t:Texture2D" --max-results 10
 uloop unity-search --search-query "t:MonoScript *.cs" --save-to-file true
 ```
 
+**Output:**
+- `TotalCount` (integer) - 見つかった結果の総数
+- `DisplayedCount` (integer) - 返された結果数
+- `Results` (array) - 検索結果アイテム
+- `SearchDurationMs` (integer) - 検索時間（ミリ秒）
+- `ResultsFilePath` (string) - ファイル保存時のファイルパス
+
 ### get-menu-items
 
 Unity MenuItem を取得します。
@@ -240,6 +274,11 @@ uloop get-menu-items
 uloop get-menu-items --filter-text "GameObject" --filter-type startswith
 ```
 
+**Output:**
+- `TotalCount` (integer) - フィルタ前の MenuItem 総数
+- `FilteredCount` (integer) - フィルタ後の MenuItem 数
+- `MenuItems` (array) - `Path`, `Priority`, `MethodName` フィールドを含むアイテム
+
 ### execute-menu-item
 
 パスを指定して Unity MenuItem を実行します。
@@ -254,6 +293,11 @@ uloop execute-menu-item --menu-item-path "File/Save"
 uloop execute-menu-item --menu-item-path "GameObject/Create Empty"
 ```
 
+**Output:**
+- `Success` (boolean) - 実行成功
+- `MenuItemPath` (string) - 実行されたメニューパス
+- `ExecutionMethod` (string) - 実行方式（EditorApplication または Reflection）
+
 ### find-game-objects
 
 検索条件で GameObject を検索します。
@@ -275,15 +319,20 @@ uloop find-game-objects --required-components "Camera" --include-inactive true
 uloop find-game-objects --tag "Enemy" --max-results 50
 ```
 
+**Output:**
+- `totalFound` (integer) - 見つかった GameObject の総数
+- `results` (array) - `name`, `path`, `isActive`, `tag`, `layer`, `components` フィールドを含む GameObject
+
 ### screenshot
 
 Unity EditorWindow のスクリーンショットを撮影して PNG として保存します。
 
 | フラグ | 型 | デフォルト | 説明 |
 |--------|------|---------|-------------|
-| `--window-name` | string | `Game` | ウィンドウ名（例: "Game", "Scene", "Console", "Inspector"） |
+| `--window-name` | string | `Game` | ウィンドウ名（例: "Game", "Scene", "Console", "Inspector", "Project", "Hierarchy"） |
 | `--resolution-scale` | number | `1` | 解像度スケール（0.1〜1.0） |
 | `--match-mode` | enum | `exact` | マッチングモード: `exact`, `prefix`, `contains`（大文字小文字区別なし） |
+| `--output-directory` | string | | 出力ディレクトリパス（空の場合 .uloop/outputs/Screenshots/ を使用） |
 
 ```bash
 uloop screenshot
@@ -291,6 +340,10 @@ uloop screenshot --window-name Scene
 uloop screenshot --window-name Project --match-mode prefix
 ```
 
+**Output:**
+- `ScreenshotCount` (integer) - キャプチャされたウィンドウ数
+- `Screenshots` (array) - `ImagePath`, `Width`, `Height`, `FileSizeBytes` フィールドを含むアイテム
+
 ### execute-dynamic-code
 
 Unity Editor 内で C# コードを実行します。
@@ -306,35 +359,51 @@ uloop execute-dynamic-code --code 'using UnityEngine; Debug.Log("Hello!");'
 uloop execute-dynamic-code --code 'Selection.activeGameObject.name' --compile-only true
 ```
 
-### get-provider-details
+**Output:**
+- `Success` (boolean) - 実行成功
+- `Result` (string) - 実行コードの戻り値
+- `Logs` (array) - 実行中に出力されたログメッセージ
+- `CompilationErrors` (array) - `Message`, `Line`, `Column`, `Hint` フィールドを含むエラー
 
-Unity Search プロバイダーの詳細を取得します。
+### control-play-mode
+
+Unity Editor のプレイモードを制御します。
 
 | フラグ | 型 | デフォルト | 説明 |
 |--------|------|---------|-------------|
-| `--provider-id` | string | | 特定のプロバイダー ID（例: "asset", "scene"） |
-| `--active-only` | boolean | `false` | アクティブなプロバイダーのみ |
-| `--include-descriptions` | boolean | `true` | 説明を含める |
-| `--sort-by-priority` | boolean | `true` | 優先度でソート |
+| `--action` | enum | `Play` | アクション: `Play`, `Stop`, `Pause` |
 
 ```bash
-uloop get-provider-details
-uloop get-provider-details --provider-id asset
-uloop get-provider-details --active-only true
+uloop control-play-mode --action Play
+uloop control-play-mode --action Stop
+uloop control-play-mode --action Pause
 ```
 
-### control-play-mode
+**Output:**
+- `IsPlaying` (boolean) - プレイモード中
+- `IsPaused` (boolean) - 一時停止中
+- `Message` (string) - アクション説明
 
-Unity Editor のプレイモードを制御します。
+### launch
+
+Unity プロジェクトを対応する Editor バージョンで起動します。
 
 | フラグ | 型 | デフォルト | 説明 |
 |--------|------|---------|-------------|
-| `--action` | enum | `Play` | アクション: `Play`, `Stop`, `Pause` |
+| `[project-path]` | string | | Unity プロジェクトのパス（省略時はカレントディレクトリを検索） |
+| `-r, --restart` | flag | | 実行中の Unity を終了して再起動 |
+| `-q, --quit` | flag | | 実行中の Unity を正常終了 |
+| `-d, --delete-recovery` | flag | | 起動前に Assets/_Recovery を削除 |
+| `-p, --platform <platform>` | string | | ビルドターゲット（例: Android, iOS, StandaloneOSX） |
+| `--max-depth <n>` | number | `3` | project-path 省略時の検索深度（-1 で無制限） |
+| `-a, --add-unity-hub` | flag | | Unity Hub に追加のみ（起動しない） |
+| `-f, --favorite` | flag | | Unity Hub にお気に入りとして追加（起動しない） |
 
 ```bash
-uloop control-play-mode --action Play
-uloop control-play-mode --action Stop
-uloop control-play-mode --action Pause
+uloop launch
+uloop launch /path/to/project
+uloop launch -r
+uloop launch -p Android
 ```
 
 ## シェル補完