pālana

The field

The field view turns your SSH configuration into a map of hosts, pools, datasets, and mounts. It opens on demand and never polls in the background.

f—the field view#

f summons the topology as an in-window card: every host from your ssh config, this Mac first. Each row carries a verdict — reachable · 2 days ago, never visited, unreachable—and the host's capability tokens: its userland flavor, zfs, rsync, sudo, and how many datasets it remembers. Under a ZFS host, the datasets themselves, with their mountpoints; unmounted ones dimmed and labeled—visible, but not somewhere you can go.

Walk it like a pane: j/k move, l folds a host open or closed, points the focused pane at the node and dismisses the card, esc just dismisses. r re-probes the host under the cursor—the row says probing…, then answers with fresh facts. One keystroke heals a stale picture: a host that changed its userland, grew rsync, or finally came online is re-read in place.

The card's own footer is the cheat sheet: ↵ / dbl-click point · l toggle · r re-probe · esc dismiss — and one line of field wisdom: ~ is the remote user's home · grey = unmounted, not a place.

Failures come back as sentences, not codes. A probe refused for key reasons says no usable ssh key—key setup needed; a host that answered gibberish says answered, but the probe came back unreadable.

Remembered, and marked as remembered#

Discovery happens on demand—when you probe, when you point, never on a timer. What the Field learned is cached locally as a plain JSON file, so the card opens instantly on the remembered shape of your field, each fact carrying its age. The cache records your last visit; it is not a live status feed. Delete it any time; the hosts are the system of record and the Field rebuilds from them.

A dated cached result is more useful than a background status check that quietly changes the state of your machines.

F—the host map#

F floats the deeper map as its own window—one you can park on a second display while you work. Where the field view answers "where do I point a pane," the host map answers "what ground does each machine stand on": every host with a probe button, its ZFS pools, and the full mount table—target, filesystem type, source, ro where read-only — plain mounts included, because not everything you manage is ZFS. System-mount noise is folded away and counted: 14 system mounts not shown.

Its markers are the same ones the field view uses: an unprobed host reads not yet asked—probe gathers the ground, and every probed host's facts are dated—ground as of 2 days ago. The legend names the one glyph that matters everywhere in pālana: the filled drive is a dataset, the hollow one a plain mount.

The config is the control#

The field's roster is your ~/.ssh/config—pālana never keeps a second list. The pane header's menu carries edit ~/.ssh/config… and reload hosts; settings can add, remove, and hide hosts, always by editing that same file, always after backing it up. Hiding tucks a # palana: hide comment into the host's block. The host stays out of menus, but a typed address still works.