tmax · local control, remote execution

tmax · local control, remote execution An architecture diagram generated by Archify. Session switcher · remote.py · fzf popup · This machine Session switcher remote.py · fzf popup Proxy panes · remote.py · view / control · This machine Proxy panes remote.py · view / control SSH master · auth.py · shared connection · This machine SSH master auth.py · shared connection Remote tmux · pi-box · sessions and panes · pi-box · remote host Remote tmux pi-box · sessions and panes Config and state · remotes.json · cache · sockets · This machine Config and state remotes.json · cache · sockets Local tmux · tmax.tmux · bindings / hooks · This machine Local tmux tmax.tmux · bindings / hooks Lease watchdog · auth.py · 24-hour expiry · This machine Lease watchdog auth.py · 24-hour expiry Remote programs · Claude Code · Codex · Pi · pi-box · remote host Remote programs Claude Code · Codex · Pi Local activity · agent_status.py · snapshot · This machine Local activity agent_status.py · snapshot Remote activity · installed agent_status.py · pi-box · remote host Remote activity installed agent_status.py select session control mode SSH / tmux -C read / write host panes check / revoke run programs window states SSH snapshot inspect panes This machine pi-box · remote host Legend Frontend Backend Database Security External

Discovery follows remote tmux

  • • Local popup polls list-sessions via SSH.
  • • tmux owns sessions; local entries are proxies.

Two different update mechanisms

  • • Control mode streams pane output.
  • • Local watcher reconciles layouts at 5s / 15s.

No separate tmax daemon on the Pi

  • • SSH service and tmux remain running.
  • • Activity helper runs per snapshot or hook.