@atelierai/uco 1.0.7 → 1.0.9

package/vendor/plugin/com.atelierai.unity.copilot/Editor/UI/uxml/CopilotToolsWindow.uxml

@@ -1,18 +1,18 @@
-<ui:UXML xmlns:ui="UnityEngine.UIElements" xmlns:uie="UnityEditor.UIElements" editor-extension-mode="False">
-    <ui:VisualElement class="root-container" style="min-width: 320px;">
-        <ui:VisualElement class="header-container">
-            <ui:Label text="Tools" class="header-title" tooltip="Browse and control all MCP tools. Each tool is exposed as a skill accessible from the command line and HTTP API. Disable unused tools to save LLM context — fewer active tools means more room for the AI to reason." />
-            <ui:VisualElement class="filter-row">
-                <ui:Label text="Filter:" class="filter-label" />
-                <ui:TextField name="filter-textfield" class="filter-textfield styled-text-field" />
-            </ui:VisualElement>
-            <ui:VisualElement class="filter-row">
-                <ui:Label text="Type:" class="filter-label" />
-                <ui:DropdownField name="type-dropdown" index="0" class="type-dropdown styled-dropdown" />
-                <ui:Label text="Filtered: 0, Total: 0" name="filter-stats-label" class="filter-stats-label" />
-            </ui:VisualElement>
-        </ui:VisualElement>
-        <ui:Label name="empty-list-label" text="No tools by current filter" class="empty-list-label" />
-        <ui:ListView name="mcp-list-view" class="mcp-list-view" />
-    </ui:VisualElement>
-</ui:UXML>
+<ui:UXML xmlns:ui="UnityEngine.UIElements" xmlns:uie="UnityEditor.UIElements" editor-extension-mode="False">
+    <ui:VisualElement class="root-container" style="min-width: 320px;">
+        <ui:VisualElement class="header-container">
+            <ui:Label text="Tools" class="header-title" tooltip="Browse and control all tools. Each tool is exposed as a skill accessible from the command line and HTTP API. Disable unused tools to save LLM context — fewer active tools means more room for the AI to reason." />
+            <ui:VisualElement class="filter-row">
+                <ui:Label text="Filter:" class="filter-label" />
+                <ui:TextField name="filter-textfield" class="filter-textfield styled-text-field" />
+            </ui:VisualElement>
+            <ui:VisualElement class="filter-row">
+                <ui:Label text="Type:" class="filter-label" />
+                <ui:DropdownField name="type-dropdown" index="0" class="type-dropdown styled-dropdown" />
+                <ui:Label text="Filtered: 0, Total: 0" name="filter-stats-label" class="filter-stats-label" />
+            </ui:VisualElement>
+        </ui:VisualElement>
+        <ui:Label name="empty-list-label" text="No tools by current filter" class="empty-list-label" />
+        <ui:ListView name="copilot-list-view" class="copilot-list-view" />
+    </ui:VisualElement>
+</ui:UXML>

package/vendor/plugin/com.atelierai.unity.copilot/Editor/UI/uxml/MainWindow.uxml

@@ -1,115 +1,115 @@
-<ui:UXML xmlns:ui="UnityEngine.UIElements" xmlns:uie="UnityEditor.UIElements" xsi="http://www.w3.org/2001/XMLSchema-instance" engine="UnityEngine.UIElements" editor="UnityEditor.UIElements" noNamespaceSchemaLocation="../../../../../UIElementsSchema/UIElements.xsd" editor-extension-mode="False">
-    <ui:ScrollView>
-        <ui:VisualElement class="container" style="min-width: 320px;">
-            <!-- Header Section -->
-            <ui:Box name="contHeader" style="background-color: rgba(222, 222, 222, 0); flex-direction: row; flex-shrink: 0;">
-                <ui:VisualElement style="flex-grow: 1; background-color: rgba(0, 0, 0, 0);">
-                    <ui:DropdownField label="Log Level" name="dropdownLogLevel" class="content-item styled-dropdown" />
-                    <ui:IntegerField label="Timeout (ms)" name="inputTimeoutMs" value="10000" class="content-item" />
-                    <ui:TextField picking-mode="Ignore" label="Version" value="0.0.0" readonly="true" name="currentVersion" focusable="false" class="content-item transparent-text-field" />
-                </ui:VisualElement>
-                <ui:VisualElement name="imgLogoPivot" class="animated-selectable" style="flex-grow: 0; height: 60px; width: 60px; right: 0; margin-left: 15px; flex-shrink: 0; margin-right: 0px; margin-top: 2px; flex-direction: row;">
-                    <ui:VisualElement name="imgLogo" style="flex-grow: 1; background-color: rgba(0, 0, 0, 0); background-image: url(&quot;project://database/Packages/com.atelierai.unity.copilot/Editor/Gizmos/logo_512.png?fileID=2800000&amp;guid=bbb0f64bd8f15164781e01168cd6fa4f&amp;type=3#logo_512&quot;); -unity-background-scale-mode: stretch-to-fill; align-self: stretch;" />
-                </ui:VisualElement>
-            </ui:Box>
-            <ui:VisualElement class="divider" />
-            <!-- Connection Section ============================== -->
-            <ui:VisualElement class="row" style="margin-top: 0; align-items: center;">
-                <ui:Label text="Connection" class="header" />
-                <ui:VisualElement name="segmentConnectionMode" style="flex-direction: row; flex-grow: 1; justify-content: flex-end; margin-right: 0;" />
-            </ui:VisualElement>
-            <ui:TextField picking-mode="Ignore" label="Server URL" value="http://localhost:8080" name="InputServerURL" class="content-item styled-text-field" />
-            <!-- Cloud Authorization (visible in Cloud mode only) -->
-            <ui:VisualElement name="cloudAuthSection" style="flex-direction: column; margin-bottom: 8px; display: none;">
-                <ui:VisualElement style="flex-direction: row; margin-top: 2px; align-items: center;">
-                    <ui:TextField name="inputCloudToken" label="" placeholder-text="Cloud Token" readonly="true" password="true" style="flex-grow: 1;" class="token-input" />
-                    <ui:Button name="btnCloudRevoke" text="Revoke" tooltip="Logout from the Cloud server. Clears the stored authentication token and disconnects Unity from the cloud." class="btn-compact btn-alert" style="display: none;" />
-                    <ui:Button name="btnCloudAuthorize" text="Authorize" tooltip="Authenticate with the Cloud server using device code flow. Opens a browser to complete authorization." class="btn-compact" />
-                </ui:VisualElement>
-                <ui:Label name="labelCloudAuthStatus" text="" class="section-desc" style="margin-top: 2px; display: none;" />
-            </ui:VisualElement>
-            <!-- Connection Auth Alert (visible in Cloud mode when not authorized) -->
-            <ui:VisualElement name="connectionAlertContainer" />
-            <!-- Connection Timeline -->
-            <ui:VisualElement name="ConnectionTimeline" class="connection-timeline">
-                <!-- Point 1: Unity -->
-                <ui:VisualElement name="TimelinePointUnity" class="timeline-point">
-                    <ui:VisualElement class="timeline-indicator">
-                        <ui:VisualElement name="connectionStatusCircle" class="status-indicator-circle status-indicator-circle-disconnected" />
-                        <ui:VisualElement class="timeline-line" style="margin-bottom: -4px;" />
-                    </ui:VisualElement>
-                    <ui:VisualElement class="timeline-content">
-                        <ui:Label text="Unity" name="connectionStatusText" class="timeline-label" />
-                        <ui:Button name="btnConnectOrDisconnect" text="Connect" class="btn-primary timeline-btn" />
-                    </ui:VisualElement>
-                </ui:VisualElement>
-                <!-- Point 2: MCP Server -->
-                <ui:VisualElement name="TimelinePointMcpServer" class="timeline-point frame-group frame-mcp-server">
-                    <ui:VisualElement class="timeline-indicator" style="justify-content: flex-start;">
-                        <ui:VisualElement name="mcpServerStatusCircle" class="status-indicator-circle status-indicator-circle-disconnected" style="margin-top: 13px;" />
-                        <ui:VisualElement class="timeline-line" style="top: 29px; margin-top: 0; margin-bottom: -4px;" />
-                    </ui:VisualElement>
-                    <ui:VisualElement style="flex-direction: column; flex-grow: 1;">
-                        <!-- Row 1: MCP Server label + Start/Stop button (fixed height, aligns with status circle) -->
-                        <ui:VisualElement name="mcpServerStatusControl" class="timeline-content" style="min-height: 40px;">
-                            <ui:Label text="Server" name="mcpServerLabel" class="timeline-label" />
-                            <ui:Button name="btnStartStopServer" text="Start" class="btn-secondary timeline-btn" />
-                        </ui:VisualElement>
-                        <!-- Row 2: Authorization -->
-                        <ui:VisualElement style="flex-direction: row; align-items: center; justify-content: space-between; margin-top: 2px; margin-bottom: 2px;">
-                            <ui:Label name="labelAuthorizationToken" text="Authorization Token" class="section-desc" style="margin-bottom: 0;" />
-                            <ui:VisualElement name="segmentAuthorization" />
-                        </ui:VisualElement>
-                        <!-- Row 3: Authorization Token -->
-                        <ui:VisualElement name="tokenSection" style="flex-direction: column; margin-top: 2px; margin-bottom: 2px;">
-                            <ui:VisualElement style="flex-direction: row;">
-                                <ui:TextField name="inputAuthorizationToken" label="" placeholder-text="Token" readonly="true" password="true" class="token-input" />
-                                <ui:Button name="btnGenerateToken" text="New" class="btn-compact" />
-                            </ui:VisualElement>
-                        </ui:VisualElement>
-                    </ui:VisualElement>
-                </ui:VisualElement>
-                <!-- Point 3: AI Agent -->
-                <ui:VisualElement name="TimelinePointAiAgent" class="timeline-point timeline-point-last" style="">
-                    <ui:VisualElement class="timeline-indicator">
-                        <ui:VisualElement name="aiAgentStatusCircle" class="status-indicator-circle status-indicator-circle-disconnected" />
-                    </ui:VisualElement>
-                    <ui:VisualElement class="timeline-content" style="align-items: flex-start; margin-top: -3px; min-height: 0;">
-                        <ui:VisualElement name="aiAgentLabelsContainer" />
-                    </ui:VisualElement>
-                </ui:VisualElement>
-            </ui:VisualElement>
-            <ui:VisualElement class="divider" />
-            <!-- Extensions Section ============================== (hidden: extension install flow pending; restore after packages ship) -->
-            <ui:Label text="Extensions" class="header" style="display: none;" />
-            <ui:VisualElement name="ExtensionsSection" style="display: none;" />
-            <ui:VisualElement class="divider" style="display: none;" />
-            <!-- Support Section ============================== (hidden: no MCP clients to configure; social links retained for reuse) -->
-            <ui:VisualElement style="display: none;">
-                <ui:VisualElement>
-                    <ui:Label text="Found an issue?" class="section-text" style="flex-grow: 1;" />
-                </ui:VisualElement>
-                <ui:VisualElement class="row-left-align">
-                    <ui:Button name="btnDiscordHelp" class="btn-secondary btn-with-icon">
-                        <ui:VisualElement name="btnDiscordHelpIcon" class="btn-icon" />
-                        <ui:Label text="Help / Talk" class="btn-label" />
-                    </ui:Button>
-                    <ui:Button name="btnGitHubIssue" class="btn-secondary btn-with-icon">
-                        <ui:VisualElement name="btnGitHubIssueIcon" class="btn-icon" />
-                        <ui:Label text="Bug Report" class="btn-label" />
-                    </ui:Button>
-                    <ui:Button name="btnCheckSerialization" text="Check" class="btn-secondary" />
-                </ui:VisualElement>
-            </ui:VisualElement>
-            <ui:VisualElement class="divider" style="display: none;" />
-            <!-- Thanks Section ============================== (hidden) -->
-            <ui:VisualElement style="display: none;">
-                <ui:Label text="Thanks for using &lt;b&gt;&lt;color=red&gt;AI&lt;/color&gt; Game Developer&lt;/b&gt;. If you like it, please give the project a star on GitHub.&#10;&#10;Sincerely,&#10;Ivan Murzak" class="section-text" />
-                <ui:Button name="btnGitHubStar" class="btn-secondary btn-with-icon btn-golden btn-floating">
-                    <ui:VisualElement name="btnGitHubStarIcon" class="btn-icon" />
-                    <ui:Label text="GitHub Star" class="btn-label" />
-                </ui:Button>
-            </ui:VisualElement>
-        </ui:VisualElement>
-    </ui:ScrollView>
-</ui:UXML>
+<ui:UXML xmlns:ui="UnityEngine.UIElements" xmlns:uie="UnityEditor.UIElements" xsi="http://www.w3.org/2001/XMLSchema-instance" engine="UnityEngine.UIElements" editor="UnityEditor.UIElements" noNamespaceSchemaLocation="../../../../../UIElementsSchema/UIElements.xsd" editor-extension-mode="False">
+    <ui:ScrollView>
+        <ui:VisualElement class="container" style="min-width: 320px;">
+            <!-- Header Section -->
+            <ui:Box name="contHeader" style="background-color: rgba(222, 222, 222, 0); flex-direction: row; flex-shrink: 0;">
+                <ui:VisualElement style="flex-grow: 1; background-color: rgba(0, 0, 0, 0);">
+                    <ui:DropdownField label="Log Level" name="dropdownLogLevel" class="content-item styled-dropdown" />
+                    <ui:IntegerField label="Timeout (ms)" name="inputTimeoutMs" value="10000" class="content-item" />
+                    <ui:TextField picking-mode="Ignore" label="Version" value="0.0.0" readonly="true" name="currentVersion" focusable="false" class="content-item transparent-text-field" />
+                </ui:VisualElement>
+                <ui:VisualElement name="imgLogoPivot" class="animated-selectable" style="flex-grow: 0; height: 60px; width: 60px; right: 0; margin-left: 15px; flex-shrink: 0; margin-right: 0px; margin-top: 2px; flex-direction: row;">
+                    <ui:VisualElement name="imgLogo" style="flex-grow: 1; background-color: rgba(0, 0, 0, 0); background-image: url(&quot;project://database/Packages/com.atelierai.unity.copilot/Editor/Gizmos/logo_512.png?fileID=2800000&amp;guid=bbb0f64bd8f15164781e01168cd6fa4f&amp;type=3#logo_512&quot;); -unity-background-scale-mode: stretch-to-fill; align-self: stretch;" />
+                </ui:VisualElement>
+            </ui:Box>
+            <ui:VisualElement class="divider" />
+            <!-- Connection Section ============================== -->
+            <ui:VisualElement class="row" style="margin-top: 0; align-items: center;">
+                <ui:Label text="Connection" class="header" />
+                <ui:VisualElement name="segmentConnectionMode" style="flex-direction: row; flex-grow: 1; justify-content: flex-end; margin-right: 0;" />
+            </ui:VisualElement>
+            <ui:TextField picking-mode="Ignore" label="Server URL" value="http://localhost:8080" name="InputServerURL" class="content-item styled-text-field" />
+            <!-- Cloud Authorization (visible in Cloud mode only) -->
+            <ui:VisualElement name="cloudAuthSection" style="flex-direction: column; margin-bottom: 8px; display: none;">
+                <ui:VisualElement style="flex-direction: row; margin-top: 2px; align-items: center;">
+                    <ui:TextField name="inputCloudToken" label="" placeholder-text="Cloud Token" readonly="true" password="true" style="flex-grow: 1;" class="token-input" />
+                    <ui:Button name="btnCloudRevoke" text="Revoke" tooltip="Logout from the Cloud server. Clears the stored authentication token and disconnects Unity from the cloud." class="btn-compact btn-alert" style="display: none;" />
+                    <ui:Button name="btnCloudAuthorize" text="Authorize" tooltip="Authenticate with the Cloud server using device code flow. Opens a browser to complete authorization." class="btn-compact" />
+                </ui:VisualElement>
+                <ui:Label name="labelCloudAuthStatus" text="" class="section-desc" style="margin-top: 2px; display: none;" />
+            </ui:VisualElement>
+            <!-- Connection Auth Alert (visible in Cloud mode when not authorized) -->
+            <ui:VisualElement name="connectionAlertContainer" />
+            <!-- Connection Timeline -->
+            <ui:VisualElement name="ConnectionTimeline" class="connection-timeline">
+                <!-- Point 1: Unity -->
+                <ui:VisualElement name="TimelinePointUnity" class="timeline-point">
+                    <ui:VisualElement class="timeline-indicator">
+                        <ui:VisualElement name="connectionStatusCircle" class="status-indicator-circle status-indicator-circle-disconnected" />
+                        <ui:VisualElement class="timeline-line" style="margin-bottom: -4px;" />
+                    </ui:VisualElement>
+                    <ui:VisualElement class="timeline-content">
+                        <ui:Label text="Unity" name="connectionStatusText" class="timeline-label" />
+                        <ui:Button name="btnConnectOrDisconnect" text="Connect" class="btn-primary timeline-btn" />
+                    </ui:VisualElement>
+                </ui:VisualElement>
+                <!-- Point 2: Server -->
+                <ui:VisualElement name="TimelinePointServer" class="timeline-point frame-group frame-server">
+                    <ui:VisualElement class="timeline-indicator" style="justify-content: flex-start;">
+                        <ui:VisualElement name="serverStatusCircle" class="status-indicator-circle status-indicator-circle-disconnected" style="margin-top: 13px;" />
+                        <ui:VisualElement class="timeline-line" style="top: 29px; margin-top: 0; margin-bottom: -4px;" />
+                    </ui:VisualElement>
+                    <ui:VisualElement style="flex-direction: column; flex-grow: 1;">
+                        <!-- Row 1: Server label + Start/Stop button (fixed height, aligns with status circle) -->
+                        <ui:VisualElement name="serverStatusControl" class="timeline-content" style="min-height: 40px;">
+                            <ui:Label text="Server" name="serverLabel" class="timeline-label" />
+                            <ui:Button name="btnStartStopServer" text="Start" class="btn-secondary timeline-btn" />
+                        </ui:VisualElement>
+                        <!-- Row 2: Authorization -->
+                        <ui:VisualElement style="flex-direction: row; align-items: center; justify-content: space-between; margin-top: 2px; margin-bottom: 2px;">
+                            <ui:Label name="labelAuthorizationToken" text="Authorization Token" class="section-desc" style="margin-bottom: 0;" />
+                            <ui:VisualElement name="segmentAuthorization" />
+                        </ui:VisualElement>
+                        <!-- Row 3: Authorization Token -->
+                        <ui:VisualElement name="tokenSection" style="flex-direction: column; margin-top: 2px; margin-bottom: 2px;">
+                            <ui:VisualElement style="flex-direction: row;">
+                                <ui:TextField name="inputAuthorizationToken" label="" placeholder-text="Token" readonly="true" password="true" class="token-input" />
+                                <ui:Button name="btnGenerateToken" text="New" class="btn-compact" />
+                            </ui:VisualElement>
+                        </ui:VisualElement>
+                    </ui:VisualElement>
+                </ui:VisualElement>
+                <!-- Point 3: AI Agent -->
+                <ui:VisualElement name="TimelinePointAiAgent" class="timeline-point timeline-point-last" style="">
+                    <ui:VisualElement class="timeline-indicator">
+                        <ui:VisualElement name="aiAgentStatusCircle" class="status-indicator-circle status-indicator-circle-disconnected" />
+                    </ui:VisualElement>
+                    <ui:VisualElement class="timeline-content" style="align-items: flex-start; margin-top: -3px; min-height: 0;">
+                        <ui:VisualElement name="aiAgentLabelsContainer" />
+                    </ui:VisualElement>
+                </ui:VisualElement>
+            </ui:VisualElement>
+            <ui:VisualElement class="divider" />
+            <!-- Extensions Section ============================== (hidden: extension install flow pending; restore after packages ship) -->
+            <ui:Label text="Extensions" class="header" style="display: none;" />
+            <ui:VisualElement name="ExtensionsSection" style="display: none;" />
+            <ui:VisualElement class="divider" style="display: none;" />
+            <!-- Support Section ============================== (hidden: nothing to configure here; social links retained for reuse) -->
+            <ui:VisualElement style="display: none;">
+                <ui:VisualElement>
+                    <ui:Label text="Found an issue?" class="section-text" style="flex-grow: 1;" />
+                </ui:VisualElement>
+                <ui:VisualElement class="row-left-align">
+                    <ui:Button name="btnDiscordHelp" class="btn-secondary btn-with-icon">
+                        <ui:VisualElement name="btnDiscordHelpIcon" class="btn-icon" />
+                        <ui:Label text="Help / Talk" class="btn-label" />
+                    </ui:Button>
+                    <ui:Button name="btnGitHubIssue" class="btn-secondary btn-with-icon">
+                        <ui:VisualElement name="btnGitHubIssueIcon" class="btn-icon" />
+                        <ui:Label text="Bug Report" class="btn-label" />
+                    </ui:Button>
+                    <ui:Button name="btnCheckSerialization" text="Check" class="btn-secondary" />
+                </ui:VisualElement>
+            </ui:VisualElement>
+            <ui:VisualElement class="divider" style="display: none;" />
+            <!-- Thanks Section ============================== (hidden) -->
+            <ui:VisualElement style="display: none;">
+                <ui:Label text="Thanks for using &lt;b&gt;&lt;color=red&gt;AI&lt;/color&gt; Game Developer&lt;/b&gt;. If you like it, please give the project a star on GitHub.&#10;&#10;Sincerely,&#10;Ivan Murzak" class="section-text" />
+                <ui:Button name="btnGitHubStar" class="btn-secondary btn-with-icon btn-golden btn-floating">
+                    <ui:VisualElement name="btnGitHubStarIcon" class="btn-icon" />
+                    <ui:Label text="GitHub Star" class="btn-label" />
+                </ui:Button>
+            </ui:VisualElement>
+        </ui:VisualElement>
+    </ui:ScrollView>
+</ui:UXML>

package/vendor/plugin/com.atelierai.unity.copilot/README.md

@@ -1,88 +1,88 @@
-<div align="center">
-  <h1>Unity Copilot</h1>
-  <p>Drive the Unity Editor from any AI agent over plain REST + WebSocket — no MCP protocol on the wire.</p>
-  <p><code>com.atelierai.unity.copilot</code></p>
-</div>
-
-Unity Copilot is a Unity Editor/Runtime plugin that exposes the Editor as an
-HTTP service: 160+ tools covering scenes, GameObjects, components, assets,
-prefabs, scripts, packages, screenshots, console, tests, and builds — plus
-prompts and resources. A self-hosted Node bridge connects the Editor to the
-outside world; the **uco** CLI drives the whole surface from any agent or
-terminal.
-
-## Highlights
-
-- **160+ Editor tools** — authoring, code (including Roslyn compile-and-execute
-  with confirmation gating for risky operations), diagnostics, build & tests,
-  visuals, physics
-- **Three-surface AI skills** — `uco setup-skills` generates focused skill
-  bundles (setup / lifecycle / live-editor) for Claude Code, Codex, Cursor,
-  and other agents, refreshed from the live tool catalog
-- **Deterministic, safe connectivity** — one port per project (hashed from the
-  project path), bearer-token auth, localhost by default, no vendor lock-in:
-  anything that can speak HTTP or run a CLI can drive the Editor
-- **Durable calls** — async invocations return a call id queryable later
-  (`uco call get <id>`); structured error envelopes survive the whole stack
-- **Dual-editor support** — gates run against Unity 2022.3 LTS and 6000.5
-
-## Requirements
-
-- Unity **2022.3 or newer** (tested on 2022.3 LTS and 6000.5)
-- **Node.js 20+** for the bridge server (the plugin auto-discovers the `uco`
-  npm package — global or project-local — or set `nodeServerPath` in the
-  config to point at a specific install)
-
-## Install
-
-### Via the uco CLI (recommended)
-
-```bash
-npm install -g @atelierai/uco
-uco install <path-to-your-unity-project>
-```
-
-This embeds the plugin package, stages the framework DLLs, writes the initial
-config, and can generate agent skills and wrappers (`uco setup-skills`).
-
-### Via OpenUPM
-
-Add the scoped registry to `Packages/manifest.json` and reference the package:
-
-```json
-{
-  "dependencies": {
-    "com.atelierai.unity.copilot": "1.0.0"
-  },
-  "scopedRegistries": [
-    {
-      "name": "package.openupm.com",
-      "url": "https://package.openupm.com",
-      "scopes": [ "com.atelierai.unity.copilot" ]
-    }
-  ]
-}
-```
-
-## Quick start
-
-```bash
-uco ping                        # health-check the bridge
-uco call unity-tool-list        # list every tool the Editor exposes
-uco exec --method-body --return-type int --code 'return GameObject.FindObjectsOfType<Camera>().Length;'
-```
-
-Configuration lives in `UserSettings/uco-config.json` (migrated automatically
-from the legacy filename by older→newer versions of the plugin).
-
-## Wire protocol
-
-Plain HTTP + WebSocket with JSON envelopes (`/api/tools/...`). There is no MCP
-protocol on the wire — the bridge was deliberately stripped down to REST so
-any agent, script, or CI job can use it without an MCP SDK.
-
-## Attribution & license
-
-Derived from [IvanMurzak/Unity-MCP](https://github.com/IvanMurzak/Unity-MCP)
-(Apache-2.0). Licensed under the Apache License 2.0 — see [LICENSE](LICENSE)
-for the dual copyright notice.
+<div align="center">
+  <h1>Unity Copilot</h1>
+  <p>Drive the Unity Editor from any AI agent over plain REST + WebSocket — a single simple wire protocol on the wire.</p>
+  <p><code>com.atelierai.unity.copilot</code></p>
+</div>
+
+Unity Copilot is a Unity Editor/Runtime plugin that exposes the Editor as an
+HTTP service: 160+ tools covering scenes, GameObjects, components, assets,
+prefabs, scripts, packages, screenshots, console, tests, and builds — plus
+prompts and resources. A self-hosted Node bridge connects the Editor to the
+outside world; the **uco** CLI drives the whole surface from any agent or
+terminal.
+
+## Highlights
+
+- **160+ Editor tools** — authoring, code (including Roslyn compile-and-execute
+  with confirmation gating for risky operations), diagnostics, build & tests,
+  visuals, physics
+- **Three-surface AI skills** — `uco setup-skills` generates focused skill
+  bundles (setup / lifecycle / live-editor) for Claude Code, Codex, Cursor,
+  and other agents, refreshed from the live tool catalog
+- **Deterministic, safe connectivity** — one port per project (hashed from the
+  project path), bearer-token auth, localhost by default, no vendor lock-in:
+  anything that can speak HTTP or run a CLI can drive the Editor
+- **Durable calls** — async invocations return a call id queryable later
+  (`uco call get <id>`); structured error envelopes survive the whole stack
+- **Dual-editor support** — gates run against Unity 2022.3 LTS and 6000.5
+
+## Requirements
+
+- Unity **2022.3 or newer** (tested on 2022.3 LTS and 6000.5)
+- **Node.js 20+** for the bridge server (the plugin auto-discovers the `uco`
+  npm package — global or project-local — or set `nodeServerPath` in the
+  config to point at a specific install)
+
+## Install
+
+### Via the uco CLI (recommended)
+
+```bash
+npm install -g @atelierai/uco
+uco install <path-to-your-unity-project>
+```
+
+This embeds the plugin package, stages the framework DLLs, writes the initial
+config, and can generate agent skills and wrappers (`uco setup-skills`).
+
+### Via OpenUPM
+
+Add the scoped registry to `Packages/manifest.json` and reference the package:
+
+```json
+{
+  "dependencies": {
+    "com.atelierai.unity.copilot": "1.0.0"
+  },
+  "scopedRegistries": [
+    {
+      "name": "package.openupm.com",
+      "url": "https://package.openupm.com",
+      "scopes": [ "com.atelierai.unity.copilot" ]
+    }
+  ]
+}
+```
+
+## Quick start
+
+```bash
+uco ping                        # health-check the bridge
+uco call unity-tool-list        # list every tool the Editor exposes
+uco exec --method-body --return-type int --code 'return GameObject.FindObjectsOfType<Camera>().Length;'
+```
+
+Configuration lives in `UserSettings/uco-config.json` (migrated automatically
+from the legacy filename by older→newer versions of the plugin).
+
+## Wire protocol
+
+Plain HTTP + WebSocket with JSON envelopes (`/api/tools/...`). The wire is plain JSON
+protocol on the wire — the bridge was deliberately stripped down to REST so
+any agent, script, or CI job can drive it with nothing but an HTTP client.
+
+## Attribution & license
+
+Derived from [IvanMurzak/Unity-MCP](https://github.com/IvanMurzak/Unity-MCP)
+(Apache-2.0). Licensed under the Apache License 2.0 — see [LICENSE](LICENSE)
+for the dual copyright notice.