@volter/game-editor 0.5.67 → 0.5.69

package/src/index.ts

@@ -5,31 +5,31 @@
  * building a game needs. Three decisions, each a product's to make and nobody
  * else's:
  *
- *  - WHICH PACKAGES, in mount order. `vgai:contributions/<package>` is that
- *    package's own `package.json#vgai.contributions`, read at build time
+ *  - WHICH PACKAGES, in mount order. `volter:contributions/<package>` is that
+ *    package's own `package.json#volter.contributions`, read at build time
  *    (`@volter/editor-core/build/product-contributions`) — the product names
  *    the package, never its modules, so a package that grows a contribution
  *    grows this product with no edit here.
  *  - THE LOOK. `classic` — the editor's own Graphite, which is the reference
  *    frame every host-default shape was measured against. A DEFAULT:
- *    `~/.vgai/settings.json`, the project's own, and its adapter's declaration
+ *    `~/.volter/settings.json`, the project's own, and its adapter's declaration
  *    each outrank it.
  *  - THE WORKSPACE. `game` — `@volter/editor-game`'s own workspace
  *    contribution, which applies to a project with at least one root that
  *    plays.
  *
- * `mountVgai` is what the workbench contribution reads off this module once
+ * `mountVolter` is what the workbench contribution reads off this module once
  * `/__editor/served-modules` hands it this file's URL.
  */
 
-import blender from 'vgai:contributions/@volter/editor-blender';
-import game from 'vgai:contributions/@volter/editor-game';
-import react from 'vgai:contributions/@volter/editor-react';
-import threejs from 'vgai:contributions/@volter/editor-threejs';
-import xstate from 'vgai:contributions/@volter/editor-xstate';
+import blender from 'volter:contributions/@volter/editor-blender';
+import game from 'volter:contributions/@volter/editor-game';
+import react from 'volter:contributions/@volter/editor-react';
+import threejs from 'volter:contributions/@volter/editor-threejs';
+import xstate from 'volter:contributions/@volter/editor-xstate';
 import { product } from '@volter/editor-core/frame/product';
 
-export const { mountVgai } = product({
+export const { mountVolter } = product({
   id: 'game-editor',
   packages: {
     '@volter/editor-game': game,

package/starter/cube.py

@@ -36,7 +36,7 @@ either way.
 
 Run it through the session's Blender, from this project:
 
-    npm run --silent vgai -- blender-mcp        # the transport an agent drives
+    npm run --silent volter -- blender-mcp        # the transport an agent drives
     # or, in a live editor session:
     # editor.blender('blender-execute', { code: open('src/models/cube.py').read() })
 

package/template/.agents/references/project-manual.md

@@ -1,4 +1,4 @@
-# Detailed VGAI game project reference
+# Detailed VOLTER game project reference
 
 This is the procedural reference behind the compact project `AGENTS.md`
 router. Load only the section the current decision needs. The source files
@@ -23,7 +23,7 @@ registry supplies their semantics.
 ## Starting a game
 
 Read the brief, create the first `ROADMAP.md` arc, inspect
-`vgai.project.json`, then start the editor immediately:
+`volter.project.json`, then start the editor immediately:
 
 ```bash
 npm run dev
@@ -46,12 +46,12 @@ has one `status:` and one `Summary:`; do not add acceptance criteria yet.
 finishes, covering what changed, why, important decisions, the live playtest
 outcome, and what remains. Link only evidence you inspected. Copy selected
 screenshots into `media/screenshots/` and selected short clips into
-`media/clips/`; bounded `.vgai/` history is working material, not a permanent
+`media/clips/`; bounded `.volter/` history is working material, not a permanent
 journal attachment.
 
 ## Source architecture
 
-Read `vgai.project.json` and `src/main.ts` first. Every manifest root has one
+Read `volter.project.json` and `src/main.ts` first. Every manifest root has one
 adapter and lifecycle. Its entry is the source document: TSX for a Three or
 Canvas root, JSX for a DOM root. Do not call `createRoot`, `hydrateRoot`, or
 `ReactDOM.render` inside a root component: mounting belongs to `src/main.ts`
@@ -92,7 +92,7 @@ genuine exception with a reason.
 The world node is the entity. Behavior on an R3F root is an ordinary React
 component using `useFrame`; physics is ordinary `@react-three/rapier` JSX.
 Use the ecosystem library directly. No mirror tree, gameplay registry, or
-vgai phase vocabulary belongs in game code.
+volter phase vocabulary belongs in game code.
 
 ## Playable slices
 
@@ -191,7 +191,7 @@ project inherits may error and these three throw until they are rewritten:
 - Analytics shows game-specific charts and metrics from the selected recorded
   Gameplay Session, using the editor's existing playback controls.
 
-All three stubs emit `VGAI_STUB_UNIMPLEMENTED`, which makes the live console and
+All three stubs emit `VOLTER_STUB_UNIMPLEMENTED`, which makes the live console and
 `check-idioms` report remaining work. Rewrite the files whole in the game's
 vocabulary.
 
@@ -226,12 +226,12 @@ Build charts from the selected log at the shared cursor.
 Record motion while Play runs:
 
 ```bash
-npm run --silent vgai -- eval 'return editor.recording.start({ fps: 30 })'
+npm run --silent volter -- eval 'return editor.recording.start({ fps: 30 })'
 # direct tester goals and advance with game.waitSimTime(...)
-npm run --silent vgai -- eval 'return editor.recording.stop()'
+npm run --silent volter -- eval 'return editor.recording.stop()'
 ```
 
-Recordings are standard WebM files under `.vgai/recordings/`. Use ordinary
+Recordings are standard WebM files under `.volter/recordings/`. Use ordinary
 `ffprobe`/`ffmpeg` to inspect and trim them.
 
 ## Game data
@@ -258,7 +258,7 @@ small set of authored parameters; the generated table is build output.
 
 ## UI roots
 
-A player HUD is a `dom` root in `vgai.project.json`, default-exporting an
+A player HUD is a `dom` root in `volter.project.json`, default-exporting an
 ordinary React component. It reads the project's own React context/store and
 uses normal React subscriptions. Do not mount a second React root from project
 code, and do not use Drei `Html` for a HUD—it is absent from clean composite
@@ -266,7 +266,7 @@ captures.
 
 `src/main.ts` mounts the roots the manifest declares for the standalone game,
 and the editor mounts the same entries itself. The source component itself
-stays free of vgai runtime context.
+stays free of volter runtime context.
 
 ## Capabilities and assets
 
@@ -274,8 +274,8 @@ Capabilities are optional standard libraries copied into the project. Before
 writing reusable plumbing, list what already exists:
 
 ```bash
-npm run --silent vgai -- add
-npm run --silent vgai -- add <id>
+npm run --silent volter -- add
+npm run --silent volter -- add <id>
 ```
 
 The copied source under `src/lib/` is project-owned and editable. Use its
@@ -283,7 +283,7 @@ native library API; do not wrap Three, Rapier, Pixi, React, Colyseus, or XState
 behind another programming model.
 
 For 3D, 2D, animation, humanoid, environment, or generated assets, load the
-matching `.agents/skills/vgai-*` skill before acting. The 3D asset floor is a
+matching `.agents/skills/volter-*` skill before acting. The 3D asset floor is a
 named prefab component, a colocated story, named nodes, and inspected visual
 evidence. Provider generation must go through the provider-native skill and
 `ctx.projectOutputs.write(...)`; never spend funds by calling a provider ad
@@ -291,7 +291,7 @@ hoc.
 
 Repeatable creative sequences are flat scripts under
 `scripts/<task>/steps/`, with a README at each meaningful step and
-intermediates under `.vgai/tmp/<task>/`. Helpers under `src/lib/<domain>/` are
+intermediates under `.volter/tmp/<task>/`. Helpers under `src/lib/<domain>/` are
 only for reusable, purely mechanical operations—not workflow runners,
 registries, or auto-judges.
 
@@ -324,7 +324,7 @@ npm run check-idioms
 npm run typecheck
 npm run validate
 npm run validate-manifest
-npm run --silent vgai -- status
+npm run --silent volter -- status
 ```
 
 Then verify through the live editor-owned session:
@@ -341,7 +341,7 @@ Then verify through the live editor-owned session:
 8. Inspect hierarchy and Content: prefabs appear as prefabs, repeated
    primitives are collapsed under their owner, and independent entities are
    not hidden in scenery.
-9. `npm run --silent vgai -- console` must be silent. Any unresolved warning/error is
+9. `npm run --silent volter -- console` must be silent. Any unresolved warning/error is
    remaining work or must be explicitly acknowledged with an honest reason.
 10. Commit the verified slice immediately. When the arc finishes, update
     `DEVLOG.md` with the judged result and reviewed media.

package/template/.agents/skills/editor/SKILL.md

@@ -1,16 +1,16 @@
 ---
 name: editor
-description: Launch, control, inspect, and verify a VGAI game through its live visual editor. Use for editor sessions, Play mode, selection, hierarchy or inspector work, screenshots, status, logs, restart after setup changes, or the live playtest loop.
+description: Launch, control, inspect, and verify a VOLTER game through its live visual editor. Use for editor sessions, Play mode, selection, hierarchy or inspector work, screenshots, status, logs, restart after setup changes, or the live playtest loop.
 ---
 
-# Control the VGAI editor
+# Control the VOLTER editor
 
 ## Open the observable session
 
 1. Run `npm run dev` from the game project. Let it auto-open unless the run is
    genuinely unattended CI.
 2. Tell the user the printed editor URL and keep the process running.
-3. Run `npm run --silent vgai -- status`; require `connected: true` before treating the
+3. Run `npm run --silent volter -- status`; require `connected: true` before treating the
    response as live state. A running server without a browser tab only has a
    cached snapshot.
 4. Use Play mode for user-visible game runs. The standalone page
@@ -18,8 +18,8 @@ description: Launch, control, inspect, and verify a VGAI game through its live v
    exported it refuses to mount, so the editor is the one surface for a game
    in development.
 
-Always invoke the scaffold-pinned CLI as `npm run --silent vgai -- <verb>`. Never use
-a bare global `vgai` command, which may come from a different checkout.
+Always invoke the scaffold-pinned CLI as `npm run --silent volter -- <verb>`. Never use
+a bare global `volter` command, which may come from a different checkout.
 
 ## Verify the loop
 
@@ -38,7 +38,7 @@ a bare global `vgai` command, which may come from a different checkout.
 - Read persisted Play logs and visible pixels as well as state. Screenshots
   must make the result being claimed legible.
 - **Every `npx volter-game-editor play` records video automatically** — the ack prints the
-  recording path (`.vgai/recordings/play-latest.webm`, replaced by the next
+  recording path (`.volter/recordings/play-latest.webm`, replaced by the next
   play; `npx volter-game-editor play --record <name>` keeps a clip forever), play auto-stops
   after 2 idle minutes, and stopping finalizes the WebM. A claim about
   MOTION (an effect, an animation, a stutter, anything that lives between

package/template/.agents/skills/editor/agents/openai.yaml

@@ -1,4 +1,4 @@
 interface:
-  display_name: "Control the VGAI Editor"
-  short_description: "Operate and inspect the live VGAI editor"
-  default_prompt: "Use $editor to open, control, inspect, and verify this game in the VGAI editor."
+  display_name: "Control the VOLTER Editor"
+  short_description: "Operate and inspect the live VOLTER editor"
+  default_prompt: "Use $editor to open, control, inspect, and verify this game in the VOLTER editor."

package/template/.agents/skills/editor/references/editor-control.md

@@ -4,14 +4,14 @@
 
 - [CLI invocation](#cli-invocation--use-the-project-local-cli)
 - [Quick start](#quick-start)
-- [Connection precondition](#precondition-most-verbs-need-a-connected-browser-tab-not-just-vgai-edit-running)
-- [**Drive the running game — `npx volter-game-editor eval`**](#drive-the-running-game--vgai-eval-the-general-door)
+- [Connection precondition](#precondition-most-verbs-need-a-connected-browser-tab-not-just-volter-edit-running)
+- [**Drive the running game — `npx volter-game-editor eval`**](#drive-the-running-game--volter-eval-the-general-door)
 - [CLI reference](#cli-reference)
 - [Entity IDs](#entity-ids)
 - [Typical workflows](#typical-workflows)
 - [SDK](#sdk-programmatic-access)
 
-Use the `vgai` CLI to create projects, launch the editor, and control it programmatically. The editor is a browser-based WebGL app; the CLI sends commands to it over HTTP.
+Use the `volter` CLI to create projects, launch the editor, and control it programmatically. The editor is a browser-based WebGL app; the CLI sends commands to it over HTTP.
 
 **Driving a running GAME is a different question from driving the editor**, and
 it has one answer: `npx volter-game-editor eval`. Read that section before the verb list — the
@@ -19,31 +19,31 @@ verbs cover the editor, and a game's own commands are never verbs.
 
 ## CLI invocation — use the project-local CLI
 
-Inside this scaffold, invoke every CLI verb as `npm run --silent vgai -- <verb>`. The
+Inside this scaffold, invoke every CLI verb as `npm run --silent volter -- <verb>`. The
 script points at the versioned `@volter/game-editor` installed with this project. Never
-use a bare global `vgai` command here: another installation can own that binary
+use a bare global `volter` command here: another installation can own that binary
 and can silently target the wrong session or apply different manifest rules.
 
 ## Quick Start
 
 ```bash
-npm run --silent vgai -- create "My Game" # Scaffold a new project in ./my-game
+npm run --silent volter -- create "My Game" # Scaffold a new project in ./my-game
 cd my-game
-npm run --silent vgai -- edit .           # Launch editor + open browser
-npm run --silent vgai -- play             # Enter play mode
-npm run --silent vgai -- restart          # Remount all game roots — acks only when the session is READY
+npm run --silent volter -- edit .           # Launch editor + open browser
+npm run --silent volter -- play             # Enter play mode
+npm run --silent volter -- restart          # Remount all game roots — acks only when the session is READY
                                  # again (relay up, tab attached, play measured running); exits
                                  # non-zero naming the gap otherwise. No sleep-then-play dance.
-npm run --silent vgai -- status           # Check editor state
-npm run --silent vgai -- eval --list      # Everything you can drive — ask this FIRST
+npm run --silent volter -- status           # Check editor state
+npm run --silent volter -- eval --list      # Everything you can drive — ask this FIRST
 ```
 
 **Port cross-talk:** the default editor port (5173) is shared across every
-VGAI project on the machine. `npm run --silent vgai -- edit .` never silently retargets a
+VOLTER project on the machine. `npm run --silent volter -- edit .` never silently retargets a
 DIFFERENT project's already-running editor — if one is already open
 elsewhere, this one starts a second instance on a fresh free port and prints
 that URL instead (use `--switch` to retarget the existing one on purpose).
-If you might have another vgai project's tab open in the browser already,
+If you might have another volter-game-editor project's tab open in the browser already,
 don't assume it's this project: read the URL `npx volter-game-editor edit` actually prints
 (check `npx volter-game-editor sessions` to see every live session's port → project), or pass
 `npx volter-game-editor edit --port <n>` to pin an explicit port for this project so a stale
@@ -74,7 +74,7 @@ one legitimate case is a fully unattended CI job that then drives the
 editor itself, e.g. via Playwright:
 
 ```bash
-npm run --silent vgai -- edit . --no-open # ONLY when no human could be watching (e.g. CI)
+npm run --silent volter -- edit . --no-open # ONLY when no human could be watching (e.g. CI)
 ```
 
 ```ts
@@ -85,7 +85,7 @@ npm run --silent vgai -- edit . --no-open # ONLY when no human could be watching
 await page.goto('http://localhost:5173', { waitUntil: 'load' });
 ```
 
-Once that page has loaded, it registers as a connected client and `vgai
+Once that page has loaded, it registers as a connected client and `volter-game-editor
 status`/`npx volter-game-editor play`/etc. from another shell will reach it for real.
 
 ## Drive the running game — `npx volter-game-editor eval`, the general door
@@ -97,12 +97,12 @@ is no command registry, provider registry, or fixed game vocabulary to learn.
 `{ editor, game, page, tools, session }` from `@volter/game-live` already in scope:
 
 ```bash
-npm run --silent vgai -- eval --list                     # what's in scope (no session needed)
-npm run --silent vgai -- eval 'return game.run(async ({ modules }) => { const arena = await modules("src/sim/arena.ts"); return arena.readArena(); })'
-npm run --silent vgai -- eval 'return game.run(async ({ modules }) => { const arena = await modules("src/sim/arena.ts"); arena.setupBossWave(); return arena.readArena(); })'
-npm run --silent vgai -- eval 'return game.run(async ({ modules }) => { const tester = await modules("src/bot/tester-station.ts"); return tester.hireTester("sweep"); })'
-npm run --silent vgai -- eval 'await game.waitSimTime({simSeconds: 4})'
-npm run --silent vgai -- eval 'await editor.grid(false)' # the editor half, same door
+npm run --silent volter -- eval --list                     # what's in scope (no session needed)
+npm run --silent volter -- eval 'return game.run(async ({ modules }) => { const arena = await modules("src/sim/arena.ts"); return arena.readArena(); })'
+npm run --silent volter -- eval 'return game.run(async ({ modules }) => { const arena = await modules("src/sim/arena.ts"); arena.setupBossWave(); return arena.readArena(); })'
+npm run --silent volter -- eval 'return game.run(async ({ modules }) => { const tester = await modules("src/bot/tester-station.ts"); return tester.hireTester("sweep"); })'
+npm run --silent volter -- eval 'await game.waitSimTime({simSeconds: 4})'
+npm run --silent volter -- eval 'await editor.grid(false)' # the editor half, same door
 ```
 
 `--list` walks the live binding objects themselves rather than a written list,
@@ -112,7 +112,7 @@ template's `src/tools/use-game-modules.ts` shows how a literal contribution
 reads the exact same running instances.
 
 **NEVER pilot a realtime game from the developer REPL, with synthetic key
-events, rAF loops, wall-clock sleeps, or direct `window.__vgai*`/scene-graph
+events, rAF loops, wall-clock sleeps, or direct `window.__volter*`/scene-graph
 reads.** Arrange expensive preconditions with exported setup functions, then
 hire the resident tester to act through the game's real input store.
 `waitSimTime` advances deterministically even while the editor tab is HIDDEN.
@@ -137,9 +137,9 @@ providers every other tool reads.
 ### Project Management (no running editor needed)
 
 ```bash
-npm run --silent vgai -- create <name> [location]   # Empty project (default location: ./<name>)
-npm run --silent vgai -- create <name> [location] --template game # Game composition; also empty, website, models
-npm run --silent vgai -- edit [project-path]        # Launch editor for project (default: cwd).
+npm run --silent volter -- create <name> [location]   # Empty project (default location: ./<name>)
+npm run --silent volter -- create <name> [location] --template game # Game composition; also empty, website, models
+npm run --silent volter -- edit [project-path]        # Launch editor for project (default: cwd).
                                            # Reuses the session already serving THIS
                                            # project; otherwise starts a NEW instance on
                                            # a free port rather than silently retargeting
@@ -148,15 +148,15 @@ npm run --silent vgai -- edit [project-path]        # Launch editor for project
                                            #   --switch    retarget an existing instance
                                            #               instead of starting a new one
                                            #   --port <n>  force a port for a fresh instance
-npm run --silent vgai -- sessions                   # List live editor sessions (port -> project)
+npm run --silent volter -- sessions                   # List live editor sessions (port -> project)
 ```
 
 ### Scene & Project Info (needs running editor)
 
 ```bash
-npm run --silent vgai -- open <path>      # Switch project in running editor
-npm run --silent vgai -- project          # Show current project info
-npm run --silent vgai -- projects         # List recent projects
+npm run --silent volter -- open <path>      # Switch project in running editor
+npm run --silent volter -- project          # Show current project info
+npm run --silent volter -- projects         # List recent projects
 ```
 
 `open` / `project` / `projects` stay first-class for a concrete reason: project
@@ -166,11 +166,11 @@ management lives on `EditorClient` and was never lifted onto `@volter/editor-liv
 ### Play Control
 
 ```bash
-npm run --silent vgai -- play             # Enter play mode
-npm run --silent vgai -- restart          # Dispose + remount every game root — waits out a relaunching dev
+npm run --silent volter -- play             # Enter play mode
+npm run --silent volter -- restart          # Dispose + remount every game root — waits out a relaunching dev
                                  # server, re-ensures the one tab, and acks only once play is
                                  # measured running (a failure names the next step)
-npm run --silent vgai -- stop             # Exit play mode
+npm run --silent volter -- stop             # Exit play mode
 ```
 
 `pause` / `resume` / `step` were REMOVED — `npx volter-game-editor eval 'editor.pause()'`,
@@ -191,16 +191,16 @@ exposes, so they were deleted rather than kept as aliases. Typing one now
 errors with its exact replacement:
 
 ```bash
-npm run --silent vgai -- eval 'editor.select("<entityId>")'   # or "all"
-npm run --silent vgai -- eval 'editor.deselect()'
-npm run --silent vgai -- eval 'editor.focus("<entityId>")'    # omit arg = current selection
-npm run --silent vgai -- eval 'editor.view("top")'            # top|front|right|perspective
-npm run --silent vgai -- eval 'editor.showPanel("inspector")' # viewport|inspector|console|build
-npm run --silent vgai -- eval 'editor.openAsset("<path>", "<kind>")'
-npm run --silent vgai -- eval 'editor.grid(false)'
-npm run --silent vgai -- eval 'editor.helpers(true)'
-npm run --silent vgai -- eval 'editor.stats(true)'
-npm run --silent vgai -- eval 'editor.shading("wireframe")'   # solid|unlit|wireframe|normals|overdraw
+npm run --silent volter -- eval 'editor.select("<entityId>")'   # or "all"
+npm run --silent volter -- eval 'editor.deselect()'
+npm run --silent volter -- eval 'editor.focus("<entityId>")'    # omit arg = current selection
+npm run --silent volter -- eval 'editor.view("top")'            # top|front|right|perspective
+npm run --silent volter -- eval 'editor.showPanel("inspector")' # viewport|inspector|console|build
+npm run --silent volter -- eval 'editor.openAsset("<path>", "<kind>")'
+npm run --silent volter -- eval 'editor.grid(false)'
+npm run --silent volter -- eval 'editor.helpers(true)'
+npm run --silent volter -- eval 'editor.stats(true)'
+npm run --silent volter -- eval 'editor.shading("wireframe")'   # solid|unlit|wireframe|normals|overdraw
 ```
 
 The advantage is not brevity — it is that one door composes. Selecting an
@@ -208,7 +208,7 @@ entity, framing it, and capturing the result is a single round trip instead of
 four processes:
 
 ```bash
-npm run --silent vgai -- eval 'await editor.select(id); await editor.focus(); await editor.shading("wireframe"); return editor.screenshot()'
+npm run --silent volter -- eval 'await editor.select(id); await editor.focus(); await editor.shading("wireframe"); return editor.screenshot()'
 ```
 
 Shading is temporary, render-only editor state: it never rewrites scene or
@@ -222,7 +222,7 @@ bounds toggles; use `setHelperType()` through the SDK when you need one category
 ### State
 
 ```bash
-npm run --silent vgai -- status           # Print full editor state as JSON
+npm run --silent volter -- status           # Print full editor state as JSON
 ```
 
 The `status` command returns:
@@ -240,9 +240,9 @@ The `status` command returns:
 ### Verification — the LIVE playtest, in as many seats as it needs
 
 ```bash
-npm run --silent vgai -- eval 'return game.run(async ({ modules }) => { const mechanic = await modules("src/sim/<mechanic>.ts"); mechanic.<setup>(); return mechanic.<read>(); })'
-npm run --silent vgai -- eval 'return game.run(async ({ modules }) => { const tester = await modules("src/bot/tester-station.ts"); return tester.hireTester("<goal>"); })'
-npm run --silent vgai -- eval 'return game.run(async ({ modules }) => { const tester = await modules("src/bot/tester-station.ts"); return tester.describeTester(); })'
+npm run --silent volter -- eval 'return game.run(async ({ modules }) => { const mechanic = await modules("src/sim/<mechanic>.ts"); mechanic.<setup>(); return mechanic.<read>(); })'
+npm run --silent volter -- eval 'return game.run(async ({ modules }) => { const tester = await modules("src/bot/tester-station.ts"); return tester.hireTester("<goal>"); })'
+npm run --silent volter -- eval 'return game.run(async ({ modules }) => { const tester = await modules("src/bot/tester-station.ts"); return tester.describeTester(); })'
 ```
 
 Verification IS the interactive playtest: cheats set the situation, the
@@ -270,7 +270,7 @@ functions, which is exactly why the door is general.
 
 ```bash
 --url <url>                      # Editor URL (default: http://localhost:5173)
-                                 # Also: VGAI_EDITOR_URL env var
+                                 # Also: VOLTER_EDITOR_URL env var
 ```
 
 ## Entity IDs
@@ -278,7 +278,7 @@ functions, which is exactly why the door is general.
 Entity ids are minted by the active authoring adapter (a three world's are
 keyed on the OID its source carries — stable across reloads). To find one:
 
-1. `npm run --silent vgai -- eval 'return editor.hierarchy()'` — the hierarchy panel's
+1. `npm run --silent volter -- eval 'return editor.hierarchy()'` — the hierarchy panel's
    rows as data, each with its `id` and label
 2. Use that id with `editor.select("<id>")` / `editor.focus("<id>")` through
    `npx volter-game-editor eval`
@@ -288,29 +288,29 @@ keyed on the OID its source carries — stable across reloads). To find one:
 ### Start a new project from scratch
 
 ```bash
-npm run --silent vgai -- create "My Platformer"
+npm run --silent volter -- create "My Platformer"
 cd my-platformer
-npm run --silent vgai -- edit .
+npm run --silent volter -- edit .
 ```
 
 ### Show the user an entity you just created/modified
 
 ```bash
 # After editing the world's TSX source — select and frame the entity in one round trip:
-npm run --silent vgai -- eval 'await editor.select("<entity-id>"); await editor.focus()'
+npm run --silent volter -- eval 'await editor.select("<entity-id>"); await editor.focus()'
 ```
 
 ### Test gameplay
 
 ```bash
-npm run --silent vgai -- play
-npm run --silent vgai -- eval 'return game.run(async ({ modules }) => { const mechanic = await modules("src/sim/<mechanic>.ts"); mechanic.<setup>(); return mechanic.<read>(); })'
-npm run --silent vgai -- eval 'return game.run(async ({ modules }) => { const tester = await modules("src/bot/tester-station.ts"); return tester.hireTester("<goal>"); })'
-npm run --silent vgai -- eval 'await game.waitSimTime({simSeconds: 5})'
-npm run --silent vgai -- eval 'return game.run(async ({ modules }) => { const mechanic = await modules("src/sim/<mechanic>.ts"); return mechanic.<read>(); })'
-npm run --silent vgai -- screenshot                            # and LOOK at the pixels
-npm run --silent vgai -- restart                               # after an init-time source change
-npm run --silent vgai -- stop
+npm run --silent volter -- play
+npm run --silent volter -- eval 'return game.run(async ({ modules }) => { const mechanic = await modules("src/sim/<mechanic>.ts"); mechanic.<setup>(); return mechanic.<read>(); })'
+npm run --silent volter -- eval 'return game.run(async ({ modules }) => { const tester = await modules("src/bot/tester-station.ts"); return tester.hireTester("<goal>"); })'
+npm run --silent volter -- eval 'await game.waitSimTime({simSeconds: 5})'
+npm run --silent volter -- eval 'return game.run(async ({ modules }) => { const mechanic = await modules("src/sim/<mechanic>.ts"); return mechanic.<read>(); })'
+npm run --silent volter -- screenshot                            # and LOOK at the pixels
+npm run --silent volter -- restart                               # after an init-time source change
+npm run --silent volter -- stop
 ```
 
 Arrange and read through the mechanic's own exported functions; let the
@@ -321,7 +321,7 @@ disagrees.
 ### Debug a specific view angle
 
 ```bash
-npm run --silent vgai -- eval 'await editor.view("top"); await editor.shading("wireframe"); await editor.helpers(true)'
+npm run --silent volter -- eval 'await editor.view("top"); await editor.shading("wireframe"); await editor.helpers(true)'
 ```
 
 ## SDK (Programmatic Access)
@@ -358,6 +358,6 @@ the right import for editor-only automation that has no game running — plus th
 handful of project-management calls (`createProject()`, `openProject()`,
 `getProject()`, `listRecentProjects()`) that `@volter/editor-live` does not re-expose.
 
-Run `npm run --silent vgai -- eval --list` for the current member list on every binding.
+Run `npm run --silent volter -- eval --list` for the current member list on every binding.
 It walks the live objects at runtime, so it is accurate in a way this page
 cannot promise to be.

package/template/{.claude/skills/vgai-3d-models → .agents/skills/volter-3d-models}/SKILL.md

@@ -1,5 +1,5 @@
 ---
-name: vgai-3d-models
+name: volter-3d-models
 description: Model and revise game props with ordinary Blender Python through the Blender MCP and export the asset for a reusable Three.js prefab. Use when asked to model a prop, shape, machine, or other game object. For placement, stories and gameplay follow .agents/references/project-manual.md; for procedural geometry generated during gameplay use ordinary Three.js.
 ---
 
@@ -12,7 +12,7 @@ Blender coordinates are **Z-up**, distances are metres, and angles are radians.
 
 Start the game's editor with `npm run dev` **in the background**, keep it running
 while authoring, and tell the user its URL. Connect the project's `blender`
-server in `.mcp.json` (`npm run --silent vgai -- blender-mcp`).
+server in `.mcp.json` (`npm run --silent volter -- blender-mcp`).
 The **Model** document is your Blender viewport; the **Scene** composes game
 objects. Inspect the model there, then inspect its placement in the game.
 
@@ -43,7 +43,7 @@ For an asset revision, edit it in Blender and re-export to the same asset path.
 Check its game placements and preserve the selected starter's studio and
 verification requirements. Before handoff, run the game's build and inspect the
 exported game. Keep input assets and runtime exports in version control;
-keep scratch files in `.vgai/tmp/`.
+keep scratch files in `.volter/tmp/`.
 
 For animation and skinning, a static mesh export is not proof that an animated
 character is game-ready.

package/template/{.github/skills/vgai-ingest-existing-game → .agents/skills/volter-ingest-existing-game}/SKILL.md

@@ -1,8 +1,8 @@
 ---
-name: vgai-ingest-existing-game
+name: volter-ingest-existing-game
 description: >
   Take an existing, unmodified web game (three.js, PixiJS, or React) to FULL
-  vgai editor integration: mount it through the adapter seam, declare its
+  volter editor integration: mount it through the adapter seam, declare its
   real capabilities through the game contract, drive every adapter slot to a
   terminal state (implemented, or verified implemented-empty), and prove it
   live through the product's own doors. Use when asked to ingest, adapt,