Runtime (run / ps / logs / stop)

Run

matrix run <alias>

• For process runners, CLI launches the server and writes a lock with real PID/port.
• For connector runners, CLI writes a lock with pid=0, port=null, url=<runner.url>.

List

matrix ps
matrix ps --plain     # script‑friendly (alias pid port uptime url target)
matrix ps --json

Logs

matrix logs <alias> [-f]

Health

matrix doctor <alias>

• Process: probes /health at http://127.0.0.1:<port>/health.
• Connector: returns ok with a message like configured remote SSE url … (may perform a short HEAD).

Stop

matrix stop <alias>

• Process: sends SIGTERM and removes the lock.
• Connector: no‑op (removes the lock only).