Skip to content

The open-source full-stack studio for Opus 5.5 motion video. Reverse engineering for any video. Code video with HTML: recreate, edit and render. BYOA + BYOK · Motion.md · Images, Video, Music & Voice.

docs: use the actual local Studio startup URL

lefarcenfa7459fb2bca
diff --git a/README.md b/README.md
index d7714a11..2392f6aa 100644
--- a/README.md
+++ b/README.md
@@ -415,7 +415,7 @@ npm run build:studio
npm start
```
-Open **http://localhost:4173**, then open **Template library**. Select a template and choose **Recreate template** to copy the instruction for your agent. Keep projects and credentials outside the checkout; `MOTION_DATA_DIR` selects the workspace.
+Open the address printed by `npm start`, then open **Template library**. On macOS, use the returned `studioUrl` or `previewUrl`: the shared editor selects a local port dynamically. Other platforms default to `http://localhost:4173`. Select a template and choose **Recreate template** to copy the instruction for your agent. Keep projects and credentials outside the checkout; `MOTION_DATA_DIR` selects the workspace.
Source checkouts load templates from `library/templates/catalog/`. The local Studio and MCP use the same files; `openmotion_list_templates` returns a searchable local index, and `openmotion_get_template` returns local guide content and absolute source paths. Larger images and videos use existing CMS links. Local edits appear on the next catalog read.
diff --git a/docs/template-repository.md b/docs/template-repository.md
index c7e0fd97..a125853a 100644
--- a/docs/template-repository.md
+++ b/docs/template-repository.md
@@ -12,7 +12,7 @@ npm run build:studio
npm start
```
-Open `http://localhost:4173`. Keep user projects and credentials outside the checkout; `MOTION_DATA_DIR` can select a separate workspace. The plugin root is the cloned `openmotion/` directory: `.codex-plugin/plugin.json` points to `skills/` and `.mcp.json`; that file launches the root `mcp.ts`. For a manual MCP client, launch `node --experimental-strip-types /absolute/openmotion/mcp.ts`, or use `npm run mcp` from the checkout. The repository path is resolved from the loaded plugin, not the caller's working directory.
+Open the address printed by `npm start`. On macOS, the shared editor selects a local port dynamically and returns `studioUrl` and `previewUrl`; use those URLs instead of assuming port 4173. Other platforms default to `http://localhost:4173`. Keep user projects and credentials outside the checkout; `MOTION_DATA_DIR` can select a separate workspace. The plugin root is the cloned `openmotion/` directory: `.codex-plugin/plugin.json` points to `skills/` and `.mcp.json`; that file launches the root `mcp.ts`. For a manual MCP client, launch `node --experimental-strip-types /absolute/openmotion/mcp.ts`, or use `npm run mcp` from the checkout. The repository path is resolved from the loaded plugin, not the caller's working directory.
- Source checkouts default to `MOTION_TEMPLATE_SOURCE=repository`. Studio search and MCP read `library/templates/catalog/` directly, without downloading the CMS catalog. A malformed local catalog fails explicitly.
- `openmotion_list_templates` returns `source=repository`, an absolute JSONL `indexPath`, total and a hash-based `catalogVersion`. Search that file locally; each repository entry includes `localSource` paths.