# getting started
## install
macOS or Linux, plus at least one agent CLI on your PATH: codex, claude, pi or zot.
Update any time with hrdx update.
## run
# start$ hrdx# open several projects at once$ hrdx --cwd ~/Developer/api --cwd ~/Developer/web# pick your default agent$ hrdx --agent claude# resume each project's latest session$ hrdx --continue
## flags
| flag | purpose |
|---|---|
| --cwd PATH | open a project as a workspace, repeatable |
| --agent ID | default agent for new panes: zot, pi, claude, codex (default zot) |
| --provider ID | pass a provider to every zot pane (zot only) |
| --model ID | pass a model to every zot pane (zot only) |
| --reasoning LEVEL | set the reasoning level (zot only) |
| --continue | resume each project's latest session |
| --codex-bin PATH | use a specific codex binary |
| --claude-bin PATH | use a specific claude binary |
| --pi-bin PATH | use a specific pi binary |
| --zot-bin PATH | use a specific zot binary |
| --shell PATH | shell for shell panes (default $SHELL) |
| --state PATH | state file for workspace persistence (empty disables) |
| --fresh | ignore saved workspaces and start clean |
| --api | serve the control API on a unix socket (default on, --api=false disables) |
| --persist | keep pane processes alive across restarts via the session holder (default on) |
## persistence
Quitting hrdx does not kill your sessions. Pane processes live in a small background session holder. Close the TUI, reopen it, and every shell and agent reattaches exactly where it was: running commands keep running, scrollback and screen state are replayed, nothing restarts. If a held session is truly gone, agent panes relaunch resuming their latest conversation from the agent's own session store.