Hand over and restart
- Desktop app
- All plans
What it does
Gives an agent a fresh context in one click. AgentsRoom asks the agent to write its handover (where it stands, decisions, what is left to do) in a file of the project, then the agent restarts its own console on a new conversation in the same tab. The first message of that conversation is a saved one, followed by the path of the handover file, so the agent picks the work up where it left it. Before this, you had to open the agent, type /clear, then paste a first message.
Where to find it
- Desktop: right-click an agent that is running > Hand over and restart.
- Phone: long-press an agent that is running > Hand over and restart.
The entry shows only while the agent runs on this computer (not for an agent running on another machine of the account, nor for the project assistant).
How to use it
- Right-click the agent > Hand over and restart.
- Check the First message of the next conversation (default "Read your handover and continue"), edit it if you want: it is saved for this agent.
- Click Hand over and restart. Nothing else to type: the agent writes its handover, ends its turn, and its console starts over on the new conversation.
Settings
handoverFirstMessage(agent, the First message of the next conversation field of the Hand over and restart dialog; default "Read your handover and continue"; stored with the agent, so every computer and the phone follow): the first message of the conversation that starts after Hand over and restart. Also settable withsettings_set { scope: "agent", key: "handoverFirstMessage" }(which writes throughagents_save); empty or null goes back to the default.
Agent tools (MCP)
agents_restart_prepare: the agent declares its handover has started, so messages wait for its next conversation.agents_restart: the agent restarts its own console on a fresh conversation, with the first message. This action asks the agent to call both.agents_recoverwithaction: "handover"(coordinator only): the project's coordinator asks for this action on a teammate. You get this same dialog, with the coordinator's name and reason above it (and a card in the coordinator's console on the phone): Hand over and restart runs it, Cancel does nothing. The coordinator is not told your choice.
Providers
Every CLI that has the AgentsRoom tools (MCP). A CLI without MCP cannot restart itself: the action says so, type /clear in its console instead.
Mobile
Same entry in the agent's actions sheet, same confirmation (it shows the saved first message), and the desktop does exactly what its own menu does. The first message is edited on the desktop. A coordinator's request shows as a card in the coordinator's console: approve or cancel it from there.
Limits
Same refusals as agents_restart, shown as a message: a step of a running Agent Team, a QA run, the project's terminals shown in another window, the rate limit (one restart every 2 minutes, 6 per hour per agent). The action also waits for the agent's turn: if it is working, try again once it has answered. Anything the agent does not write in its handover is lost with the old conversation.
Common questions
- Can I clear an agent's context without typing
/clearand a first message? Yes: Hand over and restart in its right-click menu, one confirmation. - Where does the handover go? In a file of the project the agent chooses (its own handover file if its routine keeps one, otherwise
.handoff/latest.md). Its path is added to the first message of the new conversation. - Can each agent have its own first message? Yes, edit it in the dialog: it is saved on that agent and follows you on every computer.
- Can a coordinator agent trigger it? It can ask, never run it: the dialog opens with its name and reason, and nothing happens until you click Hand over and restart. The request is refused (and no dialog opens) in the same cases as the menu, and while another such dialog is open. On the phone, the same request shows as a card in the coordinator's console, with the same two buttons.
- It says the agent cannot restart now. The message says why: wait for its turn to end, for its team step to finish, or for the rate limit; bring detached terminals back into the main window.
Related
- AgentsRoom MCP:
agents_restart, the tool this action asks the agent to call.