Guide and reference
The field
The field contains dated host capabilities, pools, datasets, and mount facts. It is populated from SSH configuration and explicit probes.
Field card#
f opens the field card with local first and the SSH
aliases after it. A host row shows reachability, fact age, userland type,
rsync, ZFS, sudo capability, and remembered dataset count.
j/k or arrows move, l/h expand and collapse, r probes the selected host, and Enter points the target pane. Tab changes the target pane while keeping the card open, and f or Esc closes it.
Mounted datasets can be opened at their mountpoint. Unmounted datasets remain visible with their state because they have no directory to open.
Cache#
Field facts are stored with timestamps in
field-cache.json. Missing or invalid cache data loads as an empty
field, and an explicit probe rewrites the cache. Deleting this file removes
remembered facts and leaves host files unchanged.
The Field has no periodic probe. ZFS mutations refresh the affected host's facts after completion because the operation may have changed its topology.
Host map#
F opens a separate host-map panel. It shows all hosts, pools, datasets, and ordinary mounts, including mount target, source, filesystem type, and read-only state. Common system mounts are folded and counted.
The map uses cached facts until its probe control requests a new read. The panel can remain open beside the main window.
Pane refresh#
A local pane watches its directory and performs a debounced re-read after a filesystem change. A remote pane re-lists every ten seconds while the app is frontmost and re-lists once when the app becomes active. Quiet refresh keeps the cursor and selection.
A failed remote quiet read suspends periodic refresh until the next app activation or an explicit read. ⌘R always requests an explicit refresh of the focused pane.