trayce-start

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

1. Quote the exact URL from the JSON. The URL already embeds the auth token; no extra copy/paste needed.
2. Tell them to open the URL in a browser. The canvas should load and show their connected sessions.
3. 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.