docs/Ethos.md

Ref: main worktree-web-client-spec   Size: 1.0 KiB   History

# Ethos

Mux keeps terminal sessions alive and makes their current state available wherever you attach. It is a state-sync terminal multiplexer: the daemon owns the terminal state, while clients render replicas of it.

## Keep the terminal authoritative

The daemon runs the Ghostty VT engine. Clients do not replay escape sequences; they receive terminal cells, starting with a snapshot and continuing with row deltas. Reconnecting restores the current screen rather than replaying a terminal transcript.

## Keep clients flexible

Use the terminal/TUI client, a browser wall, the native `muxg` client, or the `mux a` automation interface against the same daemon sessions. Clients can connect locally or remotely without changing the terminal-state model.

## Keep control explicit

Sessions outlive client connections. Detaching is separate from ending a session or stopping a daemon. A read-only check does not start a daemon. SSH-agent forwarding is opt-in through `mux -A`; `mux a` does not offer an agent.

## Platform support

Mux publicly supports Linux x86_64 only.