Reference

Gateways

Each gateway can hold more than one OS user now — clawee scopes sessions and devices per (gateway, user) pair, not just per gateway. Pick a gateway by short name, fall back to the chooser, or set friendly names; a gateway with no user added yet has nothing to attach as until you add one.

clawee <name>Attach scoped to that gateway, as its currently selected user (matches a short name, the gateway's name, or a fingerprint prefix).

clawee gatewayOpen the interactive gateway chooser — a tree of gateways with their users listed beneath (piped: list local sessions grouped by gateway, then by user, with live/dead state).

clawee gateway use <fp|name> [<user>]Switch to that gateway — and optionally that user — then attach.

clawee gateway listTable of every paired gateway — GATEWAY · FP · RELAYS · USERS · SESSIONS · DEFAULT.

clawee gateway name <fp|name> <short>Set a friendly short name for a gateway.

clawee gateway user <fp|name> add|rm <user>Add or remove a user known at that gateway (add also selects it).

gw is a short alias for gateway — clawee gw list and clawee gateway list are the same command.

With a single gateway, none of this shows — clawee goes straight to the picker. With more than one, bare clawee uses your last gateway or opens the chooser; press g in the picker to switch.

The chooser's table is three aligned columns — GATEWAY | USER | SESSIONS, plus a LIVE column once a gateway has been probed. Each gateway is at least a 3-line block: its name alone on the first line, then the gateway's full 16-hex fingerprint sharing a line with its first user, further users indented beneath, and a selectable dim + add user row closing every gateway (Enter on it does the same thing as u). The pick is a user, not a gateway:

    GATEWAY               USER    SESSIONS  LIVE
▸   workshop
    a1b2c3d4e5f6a7b8      alice   2         1/2
                          bob     0         —
                          + add user
    10.0.0.4              + add user

Keys in the chooser:

↑↓ · EnterMove over the tree (a gateway header, then its users indented beneath) · pick a user row to attach as that (gateway, user).

lDrill into the selected row's gateway relays and pin one (Enter picks, q goes back).

dOpen the devices view for the selected user — Enter approves a pending key, x revokes.

rSet the gateway's short name.

uAdd a user to the selected gateway (also the + add user row's action). A gateway with none has nothing but that row and must have one added before it can be used.

q · EscBack, without switching.

The bar itself has three variants: in the picker's own chooser it reads … · u user · q back; reached bare (a countdown present but not armed) it's the same bar with q quit; while a launch countdown is armed, u user is dropped to make room for the countdown label — u still adds a user, it's just not named on that bar.

Reference

Client config upgrade

Upgrading is one-way. Once a v0.2.x clawee writes config.json or a session's meta.json in the multi-user schema, an older clawee binary refuses the file outright rather than silently misreading it — there is no downgrade path. Rolling a fleet back means rolling its config back with it. On the daemon side, the instance id lives in the system config root (moved there by the v0.2.0 migration ladder) and is an auth-challenge input: a regenerated value silently refuses every already-enrolled device. claweed never generates one on its own — only the installer's migration adopts it — so treat that file as load-bearing, not disposable.

Reference

CLI reference

Verbatim help pages for the gateway verbs, generated by clawee docs from the binary's own help renderer.

clawee gateway

gateways: interactive switch (bare), plus the scripting verbs (alias: gw)

clawee gateway — gateways: interactive switch (bare), plus the scripting verbs (alias: gw)

Usage:
  clawee gateway [<command>]

Commands:
  use                         switch the active gateway (optionally picking the user), then attach
         <fp|name> [<user>]
  list                        print the burrowee matrix gateways with users + session counts
  name                        set the gateway's local short-name ("-" or empty clears)
         <fp|name> <short>
  user                        grow or shrink the gateway's OS-user list
         add <user>           add the user to the gateway (and select it)
         rm <user>            remove the user (clears the selection if it pointed there)

Bare `clawee gateway` opens the interactive switch modal on a terminal, and
prints the per-gateway session grouping when piped.

clawee gateway use

switch the active gateway (optionally picking the user), then attach

clawee gateway use — switch the active gateway (optionally picking the user), then attach

Usage:
  clawee gateway use <fp|name> [<user>]

  use
        <fp|name> [<user>]

clawee gateway list

print the burrowee matrix gateways with users + session counts

clawee gateway list — print the burrowee matrix gateways with users + session counts

Usage:
  clawee gateway list

clawee gateway name

set the gateway's local short-name ("-" or empty clears)

clawee gateway name — set the gateway's local short-name ("-" or empty clears)

Usage:
  clawee gateway name <fp|name> <short>

  name
         <fp|name> <short>

clawee gateway user

grow or shrink the gateway's OS-user list

clawee gateway user — grow or shrink the gateway's OS-user list

Usage:
  clawee gateway user <fp|name> add|rm <user>

  user
         add <user>   add the user to the gateway (and select it)
         rm <user>    remove the user (clears the selection if it pointed there)

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.