Devices
Create, validate and test interactive devices.
create_device
[Experimental] RETURNS A COMMAND, NOT DATA. This tool hands you a helix … command string to RUN yourself — it executes nothing and returns no results. The answer is in that command’s output. The only Device authoring entrypoint. Prepares the Creator CLI command that wraps an existing GLB in a declarative helix.device/1 project. Devices are MCP/CLI-authored; there is intentionally no website workbench. After running it, edit the generated device.json through normal agent file tools, then call validate_device and test_device.
| Argument | Type | Required | Description |
|---|---|---|---|
directory | string | yes | Absolute path for the new Device project |
id | string | yes | Stable lowercase Device slug (min length 3, max length 50) |
title | string | yes | Player-facing Device title (min length 1, max length 80) |
model | string | yes | Absolute path to the source GLB |
template | "standing-desk" | "clock" | "television" | yes | Starting behavior/state contract. Television includes a permissioned Screen/App, universal text input, audio playback, and typed power/volume/audio ports. |
test_device
[Experimental] RETURNS A COMMAND, NOT DATA. This tool hands you a helix … command string to RUN yourself — it executes nothing and returns no results. The answer is in that command’s output. Prepare the Creator CLI Device simulation command. Use mode=both before publication: the exact same self-contained Device definition is exercised as an owned Item Instance and as a World-owned package instance; single covers every control/graph path and durable remount, multiplayer uses two independent clients against one authority state and refuses divergence.
| Argument | Type | Required | Description |
|---|---|---|---|
directory | string | yes | Absolute Device project directory or device.json path |
mode | "single" | "multiplayer" | "both" | no | Default both |
json | boolean | no | Return machine-readable test receipts |
validate_device
[Experimental] RETURNS A COMMAND, NOT DATA. This tool hands you a helix … command string to RUN yourself — it executes nothing and returns no results. The answer is in that command’s output. Prepare the Creator CLI validation command for a Device project. It fails closed on malformed definitions, invalid GLB bytes, missing named-node bindings, invalid typed state or Universal Action Surface controls, undeclared capabilities, and missing Home/World compatibility.
| Argument | Type | Required | Description |
|---|---|---|---|
directory | string | yes | Absolute Device project directory or device.json path |
json | boolean | no | Return a machine-readable validation report |