Skip to content

Files and environment

Variable
ALTO_HOME Keep everything (settings, state, sockets) in this folder: a separate server and set of sessions, for trying things without touching your own
ALTO_SESSION Set inside every session, so alto status, run and work know which session they’re in
macOS Linux Windows
Settings (settings.toml) ~/Library/Application Support/alto ~/.config/alto %APPDATA%\alto
State (session records, saved screens, logs) ~/Library/Application Support/alto ~/.local/state/alto ($XDG_STATE_HOME) %LOCALAPPDATA%\alto
Sockets run/ under state $XDG_RUNTIME_DIR/alto named pipes

The window’s layout (tabs, splits, focus, profiles) is kept in app-layout.json.

alto run and alto wait share these:

Exit Means
0 (or the command’s own, for run) it happened
124 timed out (--timeout); a run command keeps running
125 couldn’t run it, or the session ended