Trade a one-time setup bootstrap key (sbk_…) for a durable agent token. Writes SPAWN_AGENT_KEY to the project .env. The full token is NEVER returned — only a masked prefix. Bootstrap keys expire in ~5 minutes and work once.

Whoami — returns { userId, username } for the connected Spawn agent token.

List games this token can push to: { games: [{ appId, variantId, name, playUrl }] }. Ask the creator which one by name.

Create a new game in the creator's account. Optionally writes SPAWN_VARIANT_ID to .env. Creator should open the play URL and keep it open.

Set SPAWN_VARIANT_ID in the project .env (join an existing game from spawn_list_games).

Scaffold a Spawn game project: gitignore secrets, world/ + scripts/, pull current spec → game.json, materialize scripts, fetch docs into .spawn/ (guide.md, tome-api.md, skills.json).

Fetch engine guide, tome API reference, and skills index. Optionally save under .spawn/.

Fetch one skill's markdown (terrain, structures, combat, cameras, …). Call before entering a new domain.

Pull a saved spec: head (mode=dev, default), published live (mode=live), an exact version, or a published updateSlug. Head pulls sync scripts (untouched fast-forward; both-changed → .theirs) and update the base-version rail — use after version_conflict. Non-head pulls are read-only unless applyLocal:true (resets local rail to that snapshot). version and updateSlug are mutually exclusive.

Compile the project (game.json + world/*.json + scripts/**) and run authoritative server-side schema validation.

Compile + push the project live (~1s in the creator's browser). Every push rebuilds the live room. On 409 version_conflict, call spawn_latest then merge .theirs receipts and push again.

Run a read-only JavaScript snippet against the live room (e.g. query objects). Pushing is the only write path.

Variant logs + live room script logs. Use when behavior doesn't match what you pushed.

Active rooms + player counts for the current variant.

Leave background context for Savi (the creator's in-game AI companion) after meaningful pushes so you don't fight over the world.

Revoke the durable agent token (disconnect). Removes SPAWN_AGENT_KEY from project .env after success.

Local project status plus optional remote head/published versions: env (masked), base version, conflict receipts, docs present, headVersion vs publishedVersion when credentials allow.

Open the live Spawn play URL in a local Chromium (Playwright). Headed by default so you can watch. Use this as the agent's eyes/hands on the game — Spawn is WebGPU/canvas, so screenshot + input beat accessibility trees. Resolves play URL from the variant if omitted.

Screenshot the open play session. Primary visual check after spawn_push — look at the image before calling the change done. Optionally save under the project.

Send keyboard/mouse actions to the play session (WASD, jump, click UI, etc.). Clicks the canvas center ONCE per session to give it keyboard focus — later batches send only the actions you list, so no stray clicks fire your weapon or dismiss UI. After acting, call spawn_play_screenshot to see the result.

Reload the play tab (e.g. if a push didn't hot-apply to this client). Prefer waiting ~1s after spawn_push first — rooms usually reshape in place.

Return recent browser console / pageerror messages from the play session. Pair with spawn_logs for server-side script errors.

Evaluate JavaScript in the play page (browser context — not the Spawn room api). Prefer spawn_exec for live world queries. Use this for DOM/WebGPU diagnostics.

Close the Playwright Chromium session.

Whether a play browser session is open, its URL, headed mode, recent error count.