Skip to Content

cmdop monitor

Open a live TUI that shows the daemon’s health in real time: connection state, recent RPC calls, in-flight sessions, recent permission decisions, and the last few log lines. Quit with q.

cmdop monitor

What you see

The TUI is split into four panels:

  1. Status — verdict (ONLINE / DEGRADED / STARTING), uptime, workspace, mode, version, PID.
  2. RPC stream — the last N relay RPCs with timestamp, method, latency, outcome.
  3. Sessions — currently attached sessions: caller, target, duration.
  4. Permission decisions — recent allow/deny/ask outcomes with rule that matched.
  5. Tail — last 10 log lines (full log via ./logs).

Keyboard shortcuts

KeyAction
qQuit
rRefresh now
cCycle panels (full-screen one panel)
fFilter (in RPC and decisions panel)
?Help

When to reach for it

  • Triaging “why is something slow?” — watch the RPC panel for high-latency calls.
  • Verifying a fresh permission rule — the decisions panel shows the matched rule ID.
  • Checking session leaks — sessions panel shows attached clients in real time.
  • Confirming an ONLINE daemon — status panel updates every second.

Headless servers

cmdop monitor requires a TTY. On a headless server, prefer:

cmdop agent status # one-shot verdict cmdop logs -f # streaming logs

Combining with cmdop logs

cmdop monitor shows the last 10 log lines. For the full log stream side-by-side, run cmdop logs -f in another pane:

# pane 1 cmdop monitor # pane 2 cmdop logs -f
Last updated on