uloop-cli 0.54.1 → 0.54.3

package/README.md

@@ -0,0 +1,132 @@
+# 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/)
+
+**CLI companion for [uLoopMCP](https://github.com/hatayama/uLoopMCP)** - Let AI agents compile, test, and operate your Unity project.
+
+> **Prerequisites**: This CLI requires [uLoopMCP](https://github.com/hatayama/uLoopMCP) to be installed in your Unity project and the server running. See the [main repository](https://github.com/hatayama/uLoopMCP) for setup instructions.
+
+## Installation
+
+```bash
+npm install -g uloop-cli
+```
+
+## Quick Start
+
+### Step 1: Install Skills
+
+Skills allow LLM tools (Claude Code, Cursor, etc.) to automatically invoke Unity operations.
+
+```bash
+# Install for Claude Code (project-level)
+uloop skills install --claude
+
+# Install for OpenAI Codex (project-level)
+uloop skills install --codex
+
+# Or install globally
+uloop skills install --claude --global
+uloop skills install --codex --global
+```
+
+### Step 2: Use with LLM Tools
+
+After installing Skills, LLM tools can automatically handle instructions like:
+
+| Your Instruction | Skill Used |
+|---|---|
+| "Fix the compile errors" | `/uloop-compile` |
+| "Run the tests and tell me why they failed" | `/uloop-run-tests` |
+| "Check the scene hierarchy" | `/uloop-get-hierarchy` |
+| "Search for prefabs" | `/uloop-unity-search` |
+
+> **No MCP configuration required!** As long as the server is running in the uLoopMCP Window, LLM tools communicate directly with Unity through Skills.
+
+## Available Skills
+
+Skills are dynamically loaded from the uLoopMCP package in your Unity project. These are the default skills provided by uLoopMCP:
+
+- `/uloop-compile` - Execute compilation
+- `/uloop-get-logs` - Get console logs
+- `/uloop-run-tests` - Run tests
+- `/uloop-clear-console` - Clear console
+- `/uloop-focus-window` - Bring Unity Editor to front
+- `/uloop-get-hierarchy` - Get scene hierarchy
+- `/uloop-unity-search` - Unity Search
+- `/uloop-get-menu-items` - Get menu items
+- `/uloop-execute-menu-item` - Execute menu item
+- `/uloop-find-game-objects` - Find GameObjects
+- `/uloop-capture-window` - Capture EditorWindow
+- `/uloop-control-play-mode` - Control Play Mode
+- `/uloop-execute-dynamic-code` - Execute dynamic C# code
+- `/uloop-get-provider-details` - Get search provider details
+
+Custom skills defined in your project are also automatically detected.
+
+## Direct CLI Usage
+
+You can also call the CLI directly without using Skills:
+
+```bash
+# List available tools
+uloop list
+
+# Sync tool definitions from Unity to local cache
+uloop sync
+
+# Execute compilation
+uloop compile
+
+# Get logs
+uloop get-logs --max-count 10
+
+# Run tests
+uloop run-tests --filter-type all
+
+# Execute dynamic code
+uloop execute-dynamic-code --code 'using UnityEngine; Debug.Log("Hello from CLI!");'
+```
+
+## 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
+```
+
+## Port Specification
+
+You can operate multiple Unity instances by specifying the `--port` option:
+
+```bash
+uloop compile --port 8700
+uloop compile --port 8701
+```
+
+If `--port` is omitted, the port configured for the current project is automatically used.
+
+You can find the port number in each Unity's uLoopMCP Window.
+
+## Requirements
+
+- **Node.js 20.0 or later**
+- **Unity 2022.3 or later** with [uLoopMCP](https://github.com/hatayama/uLoopMCP) installed
+- uLoopMCP server running (Window > uLoopMCP > Start Server)
+
+## 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
+
+## License
+
+MIT License

package/dist/cli.bundle.cjs

@@ -5759,7 +5759,7 @@ var import_path3 = require("path");
 
 // src/default-tools.json
 var default_tools_default = {
-  version: "0.54.1",
+  version: "0.54.3",
   tools: [
     {
       name: "compile",
@@ -6190,7 +6190,7 @@ function getCacheFilePath() {
 }
 
 // src/version.ts
-var VERSION = "0.54.1";
+var VERSION = "0.54.3";
 
 // src/spinner.ts
 var SPINNER_FRAMES = ["\u280B", "\u2819", "\u2839", "\u2838", "\u283C", "\u2834", "\u2826", "\u2827", "\u2807", "\u280F"];
@@ -6260,7 +6260,7 @@ function isRetryableError(error) {
     return false;
   }
   const message = error.message;
-  return message.includes("ECONNREFUSED") || message === "UNITY_NO_RESPONSE";
+  return message.includes("ECONNREFUSED") || message.includes("EADDRNOTAVAIL") || message === "UNITY_NO_RESPONSE";
 }
 function isVersionOlder(v1, v2) {
   const parsed1 = semver.valid(v1);
@@ -7328,6 +7328,15 @@ function extractGlobalOptions(options) {
     port: options["port"]
   };
 }
+function isConnectionError(message) {
+  return message.includes("ECONNREFUSED") || message.includes("EADDRNOTAVAIL");
+}
+function printConnectionError() {
+  console.error("\x1B[31mError: Cannot connect to Unity.\x1B[0m");
+  console.error("Make sure Unity Editor is open and uLoopMCP server is running.");
+  console.error("");
+  console.error("[For AI] Please report the above to the user.");
+}
 async function runWithErrorHandling(fn) {
   try {
     await fn();
@@ -7353,9 +7362,8 @@ async function runWithErrorHandling(fn) {
       console.error("Unity may be compiling, reloading, or starting. Please wait and try again.");
       process.exit(1);
     }
-    if (message.includes("ECONNREFUSED")) {
-      console.error("\x1B[31mError: Cannot connect to Unity.\x1B[0m");
-      console.error("Make sure Unity is running with uLoopMCP installed.");
+    if (isConnectionError(message)) {
+      printConnectionError();
       process.exit(1);
     }
     console.error(`\x1B[31mError: ${message}\x1B[0m`);
@@ -7659,7 +7667,11 @@ async function main() {
       }
     } catch (error) {
       const message = error instanceof Error ? error.message : String(error);
-      console.error(`\x1B[31mError: Failed to sync tools: ${message}\x1B[0m`);
+      if (isConnectionError(message)) {
+        printConnectionError();
+      } else {
+        console.error(`\x1B[31mError: Failed to sync tools: ${message}\x1B[0m`);
+      }
       process.exit(1);
     }
   }