Skip to content

Creating sessions

The + button in the toolbar, ⌘CtrlN or ⌥AltN opens the new-session dialog. Type what you want, pick the repo and a mode, and press Enter (⇧ShiftEnter adds a newline). A session started while another is open starts in the background; hold ⇧Shift as you click the start button to switch to it once it starts.

The new-session dialog in draft modeThe new-session dialog in draft mode
The new-session dialog in draft mode
Mode Starts
draft An agent drafts a backlog item from your description, asking questions as it goes
bug An agent files a bug with reproduction steps, expected and actual behaviour
prompt A plain agent session with your text as its first prompt
design An interactive agent session with assist’s design system prompt appended

Each mode has a menu that picks the harness to run it with, and the model to run it on. It opens on that mode’s default harness and model, and a harness or model you pick stays picked when you switch modes.

Draft and bug need a repo. When the repo isn’t cloned on the node you picked, the button offers to clone it first. Hold ⇧Shift as you click Start draft or File bug and the item the session proposes is approved and its run started.

The dialog opens in draft mode. To open it in another mode:

Terminal window
assist config set sessions.newSessionMode prompt

A repo’s run commands can run as sessions too, so a dev server’s output sits next to the agents using it. When the repo has run commands, the toolbar’s run menu starts them.

A run command flagged server: is a dev server, and only one may be live per server group across a repo’s clone and worktrees. Cards in that repo show a start button, the serving card shows serving :5173 and a stop button, and starting a second one replaces the first. Hold ⇧Shift as you click a start button, a server in the run menu or Retry to skip the confirmation. Agents can read a run’s output with /run-logs (see Session commands).

A dev server running as a sessionA dev server running as a session
A dev server running as a session