Manage your agents

Return to an agent#

Click an agent in the Facade panel to open its terminal. You can also run Go to Agent from the Command Palette and search for it.

Talk to the agent directly in that terminal. You can give it work, answer a question, or clarify a requirement even when another agent is coordinating the task.

Choose New Agent when you want a fresh conversation.

Name agents by their work#

Right-click an agent in the Facade panel and choose Rename Agent. You can also click the agent, then run the command from the Command Palette. Names such as “Search feature”, “Reviewer”, and “Project lead” make a growing team easier to follow.

If you name an agent “Reviewer”, use @Reviewer in a prompt to ask another agent to contact it. If names are repeated, use the agent’s #aN ID. Renaming an agent does not start a new conversation.

Pin a session you want to keep#

Hover over an agent in the Facade panel and click the pin icon. Facade restores pinned agents when you reopen the project, using their saved CLI conversations where supported.

Pin a reviewer that knows your codebase, or a PM or tech lead you consult often. You can return to the same conversation as the project develops.

Unpin the agent when you no longer want automatic restoration. Pinning restores the session later; it does not keep the CLI running while the editor is closed.

Resume a saved conversation#

1. Open the project where you used the agent.
2. Run Resume Agent from the Command Palette.
3. Search by title, agent name, CLI, or location, then choose the conversation.

Resume uses the CLI’s conversation history in that environment. The picker lists conversations it can resume here. If one is already running in another window, Facade says so instead of starting it twice.

To resume work saved on another machine, connect to that machine first.

End an agent#

Right-click the agent and choose End Agent. Facade closes its terminal and ends the CLI process. Project files keep their current changes.

Other agents it started continue running. End those separately when their work is done. You can return to a saved conversation with Resume Agent.