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 switches on its own: when the chosen relay stays unreachable, clawee tells you and opens the list so you pick.

clawee relaysOpen the interactive list (piped: prints the table instead).

clawee relays listPrint the table in effective dial order — # · RELAY · URL · WHERE · OBSERVED · STATUS.

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>Pin a relay to the front, 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 · K/J prio · s skip · u pin · a auto · p probe · ⏎ choose

    #  URL                  STATUS       LAT    TTL             TYPE
▸   1  relay.example:8448   reachable    28ms   4m12s           system   📌 pinned
    2  10.0.0.4:8448 (lan)  reachable    2ms    9m58s           edge
    3  relay-b.example:844  unreachable  —      cooldown 38m0s  system

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. 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 · u · aSkip · pin to the front · clear the pin and re-probe.

pProbe every relay now and repaint with the result.

EnterPin the selected relay. In /relays and clawee relays that also switches the live session; in the gateway chooser's drill-down it pins and returns.

q · EscLeave without pinning anything.

The header bar has room for the common six — +/-, q and Esc work but aren't printed there.

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 gateway chooser, or run clawee relays gateway <id>.

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 <id> (pin to the front, ahead of LAN-auto)
             <id>
  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.
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 <id> (pin to the front, ahead of LAN-auto)

clawee relays use — prefer <id> (pin to the front, ahead of LAN-auto)

Usage:
  clawee relays use <id>

  use
        <id>

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-08-21 against clawee v0.2.12 · claweed v0.2.4.