Closing an agent removes it from the sidebar and ends its process if it's still running. This is different from stopping an agent, which keeps the row and any saved resume identity so you can continue the conversation or start fresh later.
How to close an agent
- When enabled, press the current Close agent/terminal shortcut while the agent is selected (
Cmd+Won macOS andCtrl+Won other platforms by default; configurable in Settings → Hotkeys). - Or right-click the agent row and choose Remove agent.
Confirmation behavior
Solo asks for confirmation before removing an agent, but the prompt depends on the agent's state:
- Running agents get a confirmation dialog before Solo stops and removes them.
- Stopped agents get a simpler confirmation. On supported systems, this can include a "don't ask for stopped agents" suppression option.
If the agent was working on something important, hit Cancel to switch to the agent's terminal first and see where it left off. For work another agent must continue, capture a durable handoff before removing the session.
Subagents
If the agent has nested subagents, Solo asks whether to close those subagents too. You can keep them, or close all nested descendants along with the parent.
How closing differs from stopping
Regular commands and terminal-backed agents both have a Stop action that ends the process but keeps the entry in the sidebar. A stopped agent can also offer Resume last session when Solo has saved its provider session ID.
Agents also have a Remove agent action that takes the entry away entirely. If the agent was still running, Solo stops it first.
A supported stopped agent may retain resumable conversation context. Removing the agent deletes Solo's stored entry and its association with that session.
If an agent is mid-task
If you close an agent while it's actively working (writing files, running tools), Solo begins stopping it immediately and force-kills it if it has not exited within the grace period. File writes and running tools can continue briefly during shutdown. Any partial changes the agent already made to your filesystem remain — closing doesn't undo its work.
Review what the agent was doing before closing if you're concerned about partially applied changes.
After closing
The agent's entry disappears from the Agents section of the sidebar. Solo clears local summary and notification state for successfully removed agents.
No auto-restart happens — agents don't auto-restart on close.
To use the same tool again, launch a new agent instance. The New agent/terminal shortcut defaults to Cmd+T on macOS and Ctrl+T on other platforms, and can be changed or disabled in Settings → Hotkeys.