Skip to content

Use terminal companions

A terminal companion is a shell you open in Volli. Run your own commands there, or an external terminal UI (a TUI) such as Claude Code or Codex. It is a manual workflow alongside chat; Volli never opens one as a fallback when a chat fails.

  1. In Home or a Ticket view, select Open a tab (+).
  2. Choose Terminal. You can also use ⌥⌘T.

A Home terminal starts in the project’s main checkout. A ticket terminal uses the ticket’s selected destination: its worktree, or the project’s Project checkout. If the ticket needs a worktree, Volli creates it when the terminal starts. When that worktree is new and its Setup command setup command has not run yet, the setup command runs first in the terminal.

The terminal opens as a Session with a shell. To use an external TUI, start it from that shell yourself. Volli never starts one for you. Choose Chat when you want Volli’s built-in agent conversation and tools.

With the terminal focused, press ⌘D to open a shell pane to the right, or ⇧⌘D to open one below. Each pane starts its own shell in the same ticket or project scope. Use ⌥⌘ plus an arrow key to move between shell panes, and drag their dividers to resize them.

These shell panes share one terminal tab. To put a terminal beside a chat, file, or Browser Tab instead, use split view.

Right-click a live terminal tab and choose Park Now to pause its process tree. Choose Wake to resume it. Parking keeps the process in memory; it does not save a restorable terminal screen.

Use Keep Awake to prevent automatic parking, or Allow Parking to make the terminal eligible again. For a split terminal tab, these actions apply to its live shell panes.

A supported terminal companion can call Volli’s volli CLI through the local Unix socket. Use it to inspect tickets and worktree state, or to report progress to the app. See the CLI reference for commands, arguments, and the difference between read and write operations.

A terminal keeps a Session record, but Volli does not save its shell output or commands. If Volli quits, the live terminal process and its scrollback do not resume when you reopen the app. The saved record shows the terminal’s scope, when it started and ended, and its exit code. It does not reproduce the terminal screen.

A new terminal is a new Session. If a closed terminal record offers Resume session, that resumes a supported TUI’s own history in a new terminal; it is not a copy of the old shell or its scrollback. See Terminal resume for the supported TUIs and the command each one runs.