zmx Process Management

Session Rules

• Check zmx list --short before creating sessions — duplicates cause port conflicts and confusing output
• Derive session name from git rev-parse --show-toplevel — hardcoded names collide when multiple agent instances run concurrently
• Use zmx run to send commands without attaching — zmx attach blocks the agent's shell and makes it unresponsive
• Use separate sessions with a common project prefix for multiple processes

One project = one session prefix. Multiple processes = multiple sessions sharing the prefix.

Session Naming

PROJECT=$(basename "$(git rev-parse --show-toplevel 2>/dev/null)" || basename "$PWD")

All subsequent examples assume PROJECT is set. Session names follow ${PROJECT}-<role>:

• myapp-server, myapp-tests, myapp-tilt