| name | trayce-start |
| description | Use when the user asks to "start trayce", "launch trayce", "run the canvas server", "start the canvas", or otherwise bring the trayce canvas server up. Use this skill after trayce has been configured via `trayce-setup` — not for first-time installation.
|
| invocable_by | ["user"] |
Start Trayce
Bring the trayce canvas server online. This skill assumes the MCP bridge is
already configured (via the trayce-setup skill). If it isn't, route the user
to trayce-setup first instead of proceeding.
Pre-check (MCP config installed?)
Confirm trayce is registered in either the project's .mcp.json or the user's
~/.claude.json before starting. If neither has a trayce entry, tell the user
to run trayce-setup first and stop.
PROJECT_CFG=".mcp.json"
GLOBAL_CFG="$HOME/.claude.json"
if [ -f "$PROJECT_CFG" ] && grep -q '"trayce"' "$PROJECT_CFG" 2>/dev/null; then :
elif [ -f "$GLOBAL_CFG" ] && grep -q '"trayce"' "$GLOBAL_CFG" 2>/dev/null; then :
else
echo "NOT CONFIGURED — run trayce-setup first"
fi
Start the server
Invoke the cross-platform start script. It reuses an existing server if one is
already running at the expected state file.
bun run ${CLAUDE_PLUGIN_ROOT}/../scripts/start.ts
The script emits a single JSON line on stdout:
{"status":"new","url":"…","pid":N} — server was launched{"status":"existing","url":"…","pid":N} — a server was already running; URL
and PID are reported as-is{"status":"error","message":"…"} on stderr with non-zero exit — the server
failed to start; check /tmp/trayce/server.log (or %TEMP%\trayce\server.log
on Windows)
Tell the user
- Quote the exact URL from the JSON. The URL already embeds the auth token; no
extra copy/paste needed.
- Tell them to open the URL in a browser. The canvas should load and show
their connected sessions.
- If Claude Code isn't already running with the channel flag, remind them to
launch it with:
claude --dangerously-load-development-channels server:trayce
To stop the server later, route to trayce-stop. To check whether it's running
without starting it, route to trayce-status.
