Getting Started

Session Menu

Switch between sessions, see what each is doing, and navigate scrollback without leaving your terminal.

actor claude doubles as a terminal multiplexer. Every session is a live agent conversation, and one keystroke opens a menu that lists them all — with status — and drops you into any of their terminals.

The session menu

Press Ctrl-Z to open the session menu — it expands from the pill at the top of the screen. Ctrl-Z again closes it.

While open, it lists your sessions; the selection moves with the arrow keys:

Per row:

  • A crown marks main, the session you launched.
  • A breathing star sits next to any session that is mid-turn.
  • [+A -B] is the git diff of the session's worktree against its base branch.
  • * means the worktree has uncommitted changes.
  • A pull-request icon and number (#N) appear for any branch with an open PR.

Switching

With the menu open, move the selection with the arrow keys (vim j/k and emacs Ctrl-N/Ctrl-P also work), then press Enter to attach to the highlighted session. The view switches to its live terminal; anything you type goes to it.

Selecting main again (or pressing Enter on the one you're already in) closes the menu.

Getting back

  • Quitting the agent — e.g. Ctrl-D in Claude — drops you back to main rather than ending the TUI. Only quitting main itself ends everything.
  • Ctrl-Q tears down the whole TUI from anywhere.

Scrollback

The attach view keeps each session's scrollback. Use PageUp / PageDown or the mouse wheel to scroll through history; scroll back to the live tail to resume following output.