Module helper_hosts 

The SSH hosts AgentMux’s helper has answered on (spec §7.1 of SPEC_REMOTE_TERMINALS_AND_DURABLE_SESSIONS_2026_10_02.md): on such a host a new terminal pane is durable unless the pane, the connection’s settings or the global setting say otherwise. Kept in remote-helper-hosts.json under AgentMux’s config dir; a host is its canonical connection name (ConnTarget::name), so one host is one entry however it is spelled.

The same file keeps what AgentMux learned about each host for the Remotes pane (SPEC_REMOTES_PANE_2026_10_05.md §4.6): its platform (uname -sm, from the helper install’s probe) and the AgentMux version whose helper last answered there.

Structs

HostInfo

What AgentMux learned about one host.

Hosts 🔒

Constants

FILE_NAME 🔒

Statics

LOCK 🔒

Serializes read-modify-write of the file within this srv.

Functions

all_in

Every host the helper has answered on, and every host’s record, by canonical name.

canonical 🔒

change_in 🔒

Change connection’s record (and, with helper, mark the helper as there), writing only when something changed.

forget_helper

forget_helper_in under this instance’s config dir.

forget_helper_in

The helper was removed from connection’s host: it is no longer a helper host, and no version is there. Its platform stays known.

known

known_in under this instance’s config dir.

known_in

Whether the helper has answered on connection’s host.

path_in 🔒

read 🔒

record_uname

record_uname_in under this instance’s config dir. Best effort.

record_uname_in

Record connection’s platform, as uname -sm printed it.

remember

remember_in under this instance’s config dir, for this AgentMux’s version. Best effort: a host not remembered only means its next pane is not durable by default.

remember_in

Remember that the helper of AgentMux version answered on connection’s host.

write 🔒