Skip to content

Preview panes

When an agent has something for you to approve or read, it opens a preview pane on its session: a proposal or decision to approve, a pull request, a backlog item or comment to create, or links and snippets to copy.

  • The width toggle in the pane’s header widens it over the terminal or shrinks it back.
  • ⌥AltD moves focus to the pane’s main button, such as Approve, and pressing it again returns to the terminal with the pane left open.
  • Approve accepts what is shown and the agent carries on. Reject turns it down, and the agent revises it and shows you the next version.

Drag across text in the pane to select it, type a note, then:

  • Send to agent types the note, quoting the selected text, straight into the session.
  • Add to review adds the note to the list above the pane’s buttons. Request changes sends every note in the list back to the agent together, each with the text it quotes, for the agent to revise and show you again.
A proposal waiting for approval in the preview pane, with a comment addedA proposal waiting for approval in the preview pane, with a comment added
A proposal waiting for approval in the preview pane, with a comment added

As in the diff, Cite a broken rule and Add rule turn a comment into a rule fix or a new rule.

Ask the agent to /ask about something and it puts a proposal, summary or decision in the pane and waits. Approve it and the agent goes ahead, acting on any comments you added; reject it and the agent revises it and asks again.

When the agent designs a story or fix, the design opens in the pane with a summary. Open design opens it on claude.ai. Approve it, or reject it with comments and the agent revises it and asks again.

A design waiting for review in the preview pane, with its Open design button and summaryA design waiting for review in the preview pane, with its Open design button and summary
A design waiting for review in the preview pane, with its Open design button and summary

Questions the agent asks you open in the pane as a form instead of in the terminal. Pick one option, or several where the question allows it, or choose Other and type your own answer, then press Answer. In an Other box, Enter sends the answers once every question is answered and ⇧ShiftEnter adds a new line. Dismiss declines to answer.

A question from the agent in the preview pane, with its options, an Other box and the Answer buttonA question from the agent in the preview pane, with its options, an Other box and the Answer button
A question from the agent in the preview pane, with its options, an Other box and the Answer button

Turn on Auto submit in the pane (sessions.askQuestionAutoSubmit) and a form whose questions each take one option is sent as soon as you pick the option that completes it, without pressing Answer.

With yolo mode on, a form whose questions each take one option and offer a (Recommended) one is answered with those options without being shown, and a manual check raised in a backlog phase that has later phases is marked Works:

Terminal window
assist config set sessions.yolo true

Manual checks open in the pane. Follow the steps, then press Works or Doesn’t work, with an optional note.

During a backlog run, a check that can’t be judged yet can wait: press Later phase and pick one of the item’s later phases, including Review, to move the check there.

If a step is unclear, select the text you’re unsure about, type your question and send it. The agent answers in the session, and the check stays open for you to answer.

A manual check in the preview pane, with its steps and the Works, Doesn't work and Later phase buttonsA manual check in the preview pane, with its steps and the Works, Doesn't work and Later phase buttons
A manual check in the preview pane, with its steps and the Works, Doesn't work and Later phase buttons

Long links, paths and commands wrap in the terminal and break when you click or copy them. Ask the agent to /show them and they open whole in the pane.

Links, paths and a command shown in the preview paneLinks, paths and a command shown in the preview pane
Links, paths and a command shown in the preview pane

When /draft or /bug has written an item, the whole item, with its description, acceptance criteria and plan, opens in the pane.

A proposed backlog item in the preview paneA proposed backlog item in the preview pane
A proposed backlog item in the preview pane
  • Approve adds the item to the backlog.
  • Approve & start adds it and starts running it in a new session.

With linked nodes, pick the node to run it on beside Approve & start. It starts on the node selected in the toolbar unless you pick another.

When the agent raises or edits a pull request, the title and description open in the pane for you to approve before it goes to GitHub.

A pull request previewed before it is raisedA pull request previewed before it is raised
A pull request previewed before it is raised
  • Drop or paste images onto the pane to attach screenshots to the description, and give each a caption and an optional group.
  • Draft raises a new pull request as a draft.
  • Auto-merge (squash) squash-merges it once its required checks pass.
  • Review PR reviews it once it’s raised, then addresses the findings. It starts ticked unless prs.reviewAfterRaise is false.
  • Post to Slack announces it in Slack at the end.

Issues, issue and pull request comments and Slack posts the agent writes open in the pane the same way, for approval before they are sent.