trayce-status

Trayce Status

Report whether the trayce canvas server is currently running. This skill is non-mutating — it does not start, stop, or restart anything.

Run the status check

bun run ${CLAUDE_PLUGIN_ROOT}/../scripts/status.ts

The script emits a single JSON line on stdout and exits 0 in all non-error cases so the output is always parseable.

Interpret the output

Running:

{"running":true,"pid":12345,"port":9740,"url":"http://localhost:9740?token=…","token":"…"}

Report the URL, PID, and port to the user. The URL already embeds the auth token. If they want to open the canvas, they can paste the URL into a browser.

Not running — state file missing:

{"running":false,"reason":"no state file"}

Tell the user trayce is not running. If they want to start it, route to trayce-start. If they've never configured trayce, route to trayce-setup first.

Not running — stale state:

{"running":false,"reason":"stale state — pid 12345 not alive"}

The server crashed or was killed outside of trayce-stop. Tell the user the state file is stale and suggest trayce-start to launch a fresh instance — the start script will clean up the stale state file automatically.

Other running:false reasons ("corrupt state file", "no pid in state file", "jq not installed" from the .sh variant): relay the reason verbatim and suggest trayce-start which recreates a clean state file.