Reference
Relays
A relay is the hop your session actually travels through. clawee keeps its own preference
order per gateway — LAN relays first, then your manual order — and dials the top row. It never
picks another relay on its own: when a connection drops, the reconnect box keeps retrying the
same relay and offers r change relay so you pick (see
routes).
clawee relaysOpen the interactive list (piped: prints the table instead).clawee relays listPrint the table in effective dial order — a relay, then a row per LAN address it publishes, each with the face token relays use takes (wss://<ip>@<short-id>).clawee relays probeProbe every relay, then print the table with what came back.clawee relays priority <id…>Move the listed relays to the front of the manual order.clawee relays skip <id>Never auto-dial that relay (at least one must stay enabled).clawee relays use <id|face>Prefer a relay, or one face of it, ahead of the LAN-first order.clawee relays autoClear the pin — back to the automatic order, and re-probe.clawee relays gateway [<id>]Show the gateways, or switch which one these relays belong to.
Ids accept an unambiguous prefix of the relay's gateway fingerprint. In the interactive list
(also reachable as /relays while attached, and with l from the picker):
relays move (↑↓) · prio (K/J) · skip (s) · pin (i) · auto (a) · probe (p) # URL STATUS LAT TTL TYPE ▸ 1 relay.example:8448 reachable 28ms 4m12s system 📌 pinned 2 relay-c.example:8448 (lan) reachable 2ms 9m58s edge ↳ wss://10.0.0.4@a1b2c3d4 lan 3 relay-b.example:8448 unreachable — cooldown 38m system row 1 dials first · cooldown clears on a good probe
STATUS is what the last probe saw, LAT its round-trip, TTL how long that
reading stays fresh (or the cooldown left on a failing relay), TYPE whether the relay is
system-run or your own edge. A ↳ row under a relay is one of its LAN faces. Row 1 dials first, and a cooldown clears on a good probe.
Choosing a relay while attached switches the live session onto it — clawee drops the
stream and re-dials through the new relay, rather than waiting for the next reconnect.
↑↓ · k/jMove the selection.K/J · +/-Raise / lower the selected relay's priority — the selection follows it.s · i · aSkip · pin to the front (a relay or one of its faces) · clear the pin and re-probe.pProbe every relay now and repaint with the result.EnterClose the list. In /relays it pins the selected relay and switches the live session onto it; from l in the box chooser the pick connects.q · EscLeave without pinning anything.
The header bar has room for the common six — k/j, +/-,
Enter, q and Esc work but aren't printed there. The
/relays hint in the composer reads i pin.
This list edits relay order within one gateway; it doesn't switch between gateways.
To do that, leave with q/Esc and pick one in the
box chooser, or run clawee relays gateway <id>.
clawee transport [production|beta|auto]Choose which burrowee cli this client talks to — production (the default), the beta one installed beside it, or auto (beta when its socket exists). Bare: report the current one. A --socket flag, $BURROWEE_TRANSPORT_SOCK or a socket config key still wins.clawee sessions dropsMerge this client's and the burrowee daemon's connection logs into one verdict per drop — --since 168h, --sid <sid>, --json for the raw events.Reference
CLI reference
Verbatim help pages for the relays verbs, generated by clawee docs from the binary's own help renderer.
clawee relays
rank relays, LAN-first (bare: interactive list; piped: the table)
clawee relays — rank relays, LAN-first (bare: interactive list; piped: the table)
Usage:
clawee relays [<command>]
Commands:
list print the relay table in effective dial order
probe probe every relay, then print the table
priority move the listed relays to the front of the manual order
<id…>
skip never auto-dial <id> (at least one relay must stay enabled)
<id>
use prefer a relay, or one face of it, ahead of LAN-auto
<id|face>
auto clear the pin — back to LAN-auto order (re-probes)
gateway show gateways, or switch the active gateway (alias: gw)
[<id>]
Ids accept an unambiguous prefix of the relay's gateway fingerprint.
The list is one table: a relay, then a row per LAN address it publishes,
each printing the face token `relays use` takes (wss://<ip>@<short-id>).
Bare `clawee relays` opens the interactive list on a terminal, and prints the
table when piped.
clawee relays list
print the relay table in effective dial order
clawee relays list — print the relay table in effective dial order Usage: clawee relays list
clawee relays probe
probe every relay, then print the table
clawee relays probe — probe every relay, then print the table Usage: clawee relays probe
clawee relays priority
move the listed relays to the front of the manual order
clawee relays priority — move the listed relays to the front of the manual order
Usage:
clawee relays priority <id…>
priority
<id…>
clawee relays skip
never auto-dial <id> (at least one relay must stay enabled)
clawee relays skip — never auto-dial <id> (at least one relay must stay enabled)
Usage:
clawee relays skip <id>
skip
<id>
clawee relays use
prefer a relay, or one face of it, ahead of LAN-auto
clawee relays use — prefer a relay, or one face of it, ahead of LAN-auto
Usage:
clawee relays use <id|face>
use
<id|face>
clawee relays auto
clear the pin — back to LAN-auto order (re-probes)
clawee relays auto — clear the pin — back to LAN-auto order (re-probes) Usage: clawee relays auto
clawee relays gateway
show gateways, or switch the active gateway (alias: gw)
clawee relays gateway — show gateways, or switch the active gateway (alias: gw)
Usage:
clawee relays gateway [<id>]
gateway
[<id>]
See the full generated references: clawee CLI reference · claweed CLI reference.
Docs synced 2026-10-17 against clawee v0.3.46 · claweed v0.3.29 — a partial pass over the guard-aware update and restart, the tab title that shows a session asking for you, and the installer exit codes, on top of the v0.3.42 catch-up. See docs_sync.json for what is not covered.