Skip to Content
DesktopConnection

Connection Tab

TL;DR

Connection is the network surface: live request counters, per-request-type breakdown, bandwidth charts, and a complete outage history. Use it to debug “why isn’t my chat streaming?” and to audit when the desktop disconnected.

When chat feels slow or the agent goes silent, the Connection tab is the first place to look.

What the Connection tab shows

The tab has four panels: live counters (bytes/sec, requests/sec), a per-request-type table that highlights which kinds of requests are hot, a connection-state timeline, and a complete outage history. The data is sampled on a fixed cadence and updates live.

Connection states explained

The connection moves through six observable states: connected (steady stream of bytes), connecting (initial dial), reconnecting (retry with countdown), stale (last byte time elapsed past threshold), disconnected (intentional close), and error (a fatal error — usually auth or transport). The same state is surfaced in compact form by the system tray status indicator, so you do not have to keep this tab open just to glance at it.

Outage classification

Each outage is tagged with one of two reasons: auth when your login was rejected, or server when the transport or upstream failed. The outage history table groups by reason so you can see at a glance whether you are looking at a network problem or an authentication problem.

Auth-class outages mean the server is reachable but your login is rejected. Try reauthenticating from Settings → Account before debugging the network.

Bandwidth charts

The bandwidth panel renders rolling-window graphs for upload and download with separate lines. The sample cadence is the same ticker that feeds the live counters, and the data is local-only — nothing leaves the desktop. This is the panel to watch when you suspect a runaway tool call is silently exfiltrating MBs in the background.

Per-request-type breakdown

The breakdown table shows each request type with its calls/sec, bytes/sec, and error rate. When chat feels slow, look at the chat-streaming row — high latency there points at the server or upstream LLM, not your network, so you can stop tweaking your wifi and start checking machine health.

Disconnect — what it means

Clicking Disconnect — here, in the tray, or in Settings → Connection — closes the live connection so no bytes leave the process. Your login stays in the keychain, so reconnect is one click.

Disconnect closes the connection but does not log you out. To revoke your login entirely use Settings → Account → Sign out, or cmdop logout in the CLI. The full explanation lives on the system tray page.

Sticky disconnect across restart

Ticking “Stay disconnected across restart” in the tray (or toggling auto-connect in Settings → Connection) saves the choice. The desktop comes back disconnected on next launch until you opt back in, which is the safe default for shared machines.

Last updated on