The agent

Threads, modes and reviewing changes.

Threads

View › Toggle Agent Panel shows the agent.

The thread's … menu has Rename, Archive, Delete and Detach, which moves the thread to its own window. On one of your messages, Fork thread from here starts a new thread from that point.

Modes

Pick the mode in the composer. New threads start in Default mode (Settings › Agents).

ModeDoes
AutoEdits without asking. Sansa reviews every other action and asks you only when it's risky.
ReviewAsks before every action. The default.
ReadReads and answers, never edits.
PlanWrites a plan for you to approve, then works from it.

What asks, and how to change it: Approvals and sandbox.

Mentions and commands

Type @ in the composer to attach:

MentionSends
A file or folderIts contents
A URLThe page
DiagnosticsErrors and warnings in the open files
Terminal selectionThe selected terminal output
Git diffChanges against HEAD
A threadA summary of that thread

Type / for commands: /compact shortens the thread now, /helpful and /not-helpful rate it, /code-map opens the Code Map, and each skill is a command.

Reviewing changes

Changes stay in your files while you review them.

  • Above the composer: Accept all and Reject all, or ✓ and × per file.
  • In the editor: Accept and Reject under each change, and Accept File and Reject File in the toolbar.

Rejecting restores the original. A file the agent created is deleted, and a file it deleted comes back.

Checkpoints

Before a turn changes anything, ngram snapshots the project. Restore checkpoint on a message puts the project back as it was before that message. Git doesn't have to be installed, and your branches, index and stash aren't touched.

Asking about code

Select the code, press Cmd-Alt-L to add it to the thread as a mention, and type what you want. Changes come back as edits to accept or reject in place.

Write a command

Cmd-I in a terminal opens a box under the prompt. Describe a command and the agent types it at the prompt without running it.

Notifications

When a thread finishes or needs you while it's out of view, a small ngram window appears in the corner of the screen. Questions and approvals can be answered from it. Set Notifications and Notification sound in Settings › Agents.

Keys

KeyDoes
Cmd-NNew thread (agent panel focused)
Cmd-;Mode picker
Cmd-'Model picker
Ctrl-Alt-Up / Ctrl-Alt-DownPrevious / next thread
EnterSend. Set Send key to Cmd-Enter in Settings › Agents.
Cmd-Alt-Enter / Cmd-Alt-BackspaceAccept / reject the change at the cursor
Cmd-Alt-Shift-Enter / Cmd-Alt-Shift-BackspaceAccept / reject the file
Alt-F5 / Shift-Alt-F5Next / previous change

Approval keys are in Approvals and sandbox. Change any key with Cmd-K Cmd-S.