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).
| Mode | Does |
|---|---|
| Auto | Edits without asking. Sansa reviews every other action and asks you only when it's risky. |
| Review | Asks before every action. The default. |
| Read | Reads and answers, never edits. |
| Plan | Writes 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:
| Mention | Sends |
|---|---|
| A file or folder | Its contents |
| A URL | The page |
| Diagnostics | Errors and warnings in the open files |
| Terminal selection | The selected terminal output |
| Git diff | Changes against HEAD |
| A thread | A 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
| Key | Does |
|---|---|
Cmd-N | New thread (agent panel focused) |
Cmd-; | Mode picker |
Cmd-' | Model picker |
Ctrl-Alt-Up / Ctrl-Alt-Down | Previous / next thread |
Enter | Send. Set Send key to Cmd-Enter in Settings › Agents. |
Cmd-Alt-Enter / Cmd-Alt-Backspace | Accept / reject the change at the cursor |
Cmd-Alt-Shift-Enter / Cmd-Alt-Shift-Backspace | Accept / reject the file |
Alt-F5 / Shift-Alt-F5 | Next / previous change |
Approval keys are in Approvals and sandbox. Change any key with Cmd-K Cmd-S.