zmx — long-lived processes

zmx runs processes in detached sessions that survive the conversation. zmx help is the command reference; this page is the working agreement plus the gotchas no --help confesses.

Core loop

zmx run <session> -d bash -lc '<command>'     # start detached; bash -lc carries &&, pipes, quotes
zmx history <session> | tail -100             # read output so far
zmx history <session> | rg -i 'error|ready'   # scan for signals
zmx wait <session>                            # gate on completion — see timeout gotcha below
zmx list --short
zmx kill <session>

Drive sessions with run/history/wait. zmx attach opens an interactive PTY that blocks your shell — it's for humans.

Gotchas