Your first sessions

Open a tab

Open Alto, or from any terminal:

alto             # a session in an Alto window, in this folder (a new tab if one's open)
alto open ~/src  # the same, in a folder
alto open -- htop  # run a program instead of your login shell

Over SSH, or with no app running, plain alto lets you choose a session to attach to in the terminal you’re in.

Close the window

Start something long in a tab, a build, a dev server or an agent, then quit the app. Nothing stops. Every tab’s session is its own background process, and the window was only drawing it.

alto ls

1  48211  2h  working   claude    ~/src/payments
2  48230  2h  done      codex     ~/src/web
3  48262  1h  idle      pnpm dev  ~/src/web

The columns are the session’s id, its process, how long it’s been running, its state, its program and its folder.

Open Alto again and every tab is where you left it: its splits, which pane had focus, and the scrollback.

Use a session from another terminal

alto attach      # choose from a list, or start one
alto attach 2    # show session 2 here

Ctrl-\ detaches. The session carries on, and the Alto window still shows it. Several clients can show one session at once; its size follows whoever typed last.

Start and end sessions without a window

alto new                 # a session running your shell; prints its id
alto new -- npm run dev  # running a program
alto new --attach        # and show it here
alto kill 3              # end its program (or forget an ended session)

After a reboot

Sessions save their screen as they go. After a restart each tab shows its last screen, scrollback included, with a note: This session has ended, and a button that says what it’ll do: Resume Claude, Run vim again, New shell. It starts the command again in the folder it was last in, and an agent picks up its own conversation. See Sessions.