Agent Templates

  • Desktop app
  • All plans

What it does

A library of reusable agent definitions saved at your account level ("Your agents"), organised in folders, ready to add to any project. A saved agent carries everything an agent is configured with: role (or an Expert / Community identity), provider, variant and model (including extended context or a free-typed model), the CLI account pinned per agent, system prompt, permission mode, default skills and connections, colour, capabilities (embedded browser, Chrome, always-memorize, minimal system prompt), CLI options, environment variables, MCP servers, personal flag, and the worktree mode. Adding an agent from it copies the whole definition; the saved agent's name becomes the agent's default name. Saved agents are private to your account: nothing is published to the community.

Where to find it

  • On any agent of a project: right-click > Save to your agents ("Reuse it in all your projects"). Since 2026-10-14.
  • Inside a project, Add agent: your saved agents are the first row of faces, under Your agents, and they come up in the search. Right-click one ("Right-click to edit or delete") for Edit Agent or Delete Agent. Since 2026-10-14.
  • Projects home (the Home button, no project open): sidebar, Agents tab (next to Projects), the folder tree of your saved agents, with New Agent Template to create one from scratch. Empty state: "No agent templates. Save reusable agents with names, roles, prompts." This tab is not shown while a project is open. Since 2026-10-15 the Agents button of the title bar (between Home and the Open space) opens it from anywhere. The tab opens on Reusable agents and teams ("Build your agents and teams once here, then reuse them in all your projects."); hovering a saved agent shows Use in a project (pick the project, its Add agent studio opens with the agent on the stage), Edit Agent, Duplicate and Delete Agent. Your own teams are listed below, see Agent Teams.

How to use it

Save an agent you already configured in a project:

  1. Right-click the agent in the room > Save to your agents.
  2. The editor opens on a copy of the agent, titled Save to your agents: "A copy of this agent's setup (CLI, model, prompt, permissions), saved to your account. You will find it in every project, under Add agent > Your agents." Rename it or adjust any lever, then click Save to your agents. Nothing is saved before that click.

Use it in another project:

  1. Open the project, click Add agent.
  2. Pick it under Your agents: the whole configuration fills the form, still editable, and Add <name> creates the agent.

Create one from scratch: from the projects home, Agents tab > New Agent Template ("Reusable agent config, saved to your account and available in every project"). The form is the same as Add agent; give it a name and save (Create agent / Save changes). Not sure which role to start from? The sparkle of its search field (Help me choose an agent, since 2026-10-23) takes a task description and puts the advised role or expert on the stage, see Agent Suggestions.

Manage: in Add agent, right-click a saved agent for Edit Agent (the Add agent window closes and the editor opens) or Delete Agent (asks "Delete it from your agents? Agents already created from it are kept."). From the projects home, click a saved agent in the Agents tab to open it in the editor (since 2026-10-14; before, a click only highlighted the row), right-click it to edit, duplicate or delete it, and drag it between folders.

Avatar shared by a saved agent (since 2026-10-14): give the saved agent an avatar once (its editor, the pencil on the avatar, upload an image or pick a preset) and every agent created from it follows that avatar. Change it later on the saved agent and the agents that follow it update in every project, without touching their prompt, model or conversation. An agent that already exists can follow it too: Edit agent > Avatar > Customize avatar > From your agents, pick the saved agent's avatar and save; the line under the avatar then reads "Follows <name> from Your agents". Picking any other avatar (a preset, an upload, the default) makes it this project's own avatar again, and that agent stops following. Choosing another avatar while adding the agent does the same.

A saved agent whose worktree mode is "always" gives every agent created from it its own git worktree and branch, so several can work on the same repository at once. Picking it in Add agent shows New worktree per agent on the Workspace card; open the card and choose Main or another worktree to change that for this agent only.

Personal catalog and categories

Since 2026-10-27 your saved agents (Your agents, complete setups) and your own custom agents (My agents, personas created with Create your own agent) form one personal catalog, filed in YOUR categories. A category is a top-level folder of the Agents tab: you create, rename, order and nest it as before, and you can now give it a colour and an icon.

  • Colour and icon: projects home, Agents tab, hover a folder > the palette button (Category colour and icon). The window Category look offers the colour picker (No colour removes it) and a grid of icons (legal, real estate, research, finance, writing, coding...). Changes apply at once. A sub-folder without its own colour or icon shows its parent's.
  • From inside a project: Add agent > Manage categories does the same for the top-level categories (sub-folders stay in the Agents tab). Since 2026-11-06.
  • Filing: choose the Category in the editor of a custom agent (the list also creates a new category, colour and icon included, since 2026-11-06), or drag a saved agent or one of your custom agents onto a folder (Folders view). Your custom agents now appear in the Agents tab too, next to your saved agents; a click opens their editor.
  • Add agent (desktop and phone): your catalog comes first, one section per category in your folder order, titled with the category name and its icon, each face ringed with the category colour; agents filed in no category follow under Your agents, then the built-in team. Searching keeps the same grouping.
  • Colour in the room: an agent created from a coloured category takes the category colour (cards, tabs, sidebar) and FOLLOWS it: recolour the category and those agents change colour in every project. Choosing another colour for the agent (in Add agent or Edit agent) makes that colour its own, and it stops following.

Settings

None.

Agent tools (MCP)

None for saved agents themselves. agents_save creates or updates a project's agents, not the account library.

Providers

All providers: a saved agent records the provider it was built with, and the agent created from it runs on that CLI. An agent on the default CLI is saved with that CLI written out, so it does not change CLI if your default changes later. A CLI account pinned in a saved agent is a machine-local identity: on another computer the agent falls back to the project or global default account. An account pinned by the automatic account switch (not by you) is not copied.

Mobile

Since 2026-10-27 the phone's Add agent sheet lists your personal catalog first (saved agents and your own custom agents, grouped by your categories with their colour and icon). Picking a saved agent creates it on the computer from the full saved setup, exactly like the desktop. Creating, editing or colouring categories and Save to your agents stay on the desktop.

The phone does show every agent's custom avatar, including one followed from a saved agent; choosing a saved agent's avatar for an existing agent is done on the desktop.

Limits

  • A project nobody has opened since a saved agent's avatar changed shows the old avatar until it is opened on one of your computers, then catches up.

  • Working directories and the choice of an existing worktree are not saved: they are absolute paths of one checkout and make no sense for an object that travels with the account. The dynamic worktree mode replaces them.

  • The four team-member permissions (run test tools without confirmation, create agents without confirmation, protection from agent close, coordinator) are not saved: set them in Add agent > Advanced options when you add the agent.

  • Default skills reference the skills of the project where the agent was configured; an unknown skill is ignored when it is used in another project. Without a project open, the form offers the skills and connections of your account only (since 2026-10-09; before, the section was hidden).

  • Saved agents sync through your account, so they need you to be signed in to appear on your other computers. Their manual order follows too (Live settings sync and Machines).

Common questions

  • How do I make my project agents global, available in all my projects? Right-click each one > Save to your agents. Then Add agent in any project lists them under Your agents. Since 2026-10-14; before, the only way was to recreate them by hand from the Agents tab of the projects home.
  • Does a saved agent keep my CLI, model, prompt and permissions? Yes: provider, model, system prompt, permission mode, capabilities, skills, connections and CLI launch options. Only the team-member permissions and the working folders stay on the original agent.
  • Is a saved agent shared with anyone? No. It belongs to your account only. Publishing to the community is a separate feature, for the agents you create with Create your own agent (see Customize Agents).
  • What is the difference with "My agents" in the Community section? My agents are personas (name, description, system prompt, category) you can publish; you choose the CLI and model when you add one. Your agents are complete setups, CLI and model included, that stay private.
  • Why did the pinned CLI account not apply on my other Mac? Account pins are local to a machine; the agent uses the project or global default there.
  • Can I set an agent's avatar once and reuse it in all my projects? Yes: put the avatar on the saved agent. Agents added from it follow it, existing agents adopt it with Edit agent > Avatar > From your agents, and changing it on the saved agent updates them everywhere. An agent with its own avatar keeps it.
  • Will updating the saved agent's avatar change my agents' prompts or models? No. Only the avatar of the agents that follow it changes.
  • Does the phone show the same avatar? Yes, the phone shows each agent's custom avatar (uploaded image or preset), the same as the desktop, since 2026-10-14.
  • Can I make my own categories for legal, research or real estate agents? Yes: create a folder in the Agents tab of the projects home, give it a colour and an icon with the palette button, and drag your agents into it. Add agent then lists them first under that category, on the desktop and on the phone.
  • Why did my agent's colour change on its own? It was created from a category and follows its colour: someone recoloured the category. Give the agent its own colour in Edit agent to stop following.
  • Are "Your agents" and "My agents" still two different things? They are stored differently (a complete setup versus a persona you can publish), but they are listed together in the Agents tab and in Add agent, filed in the same categories.
  • Where is a saved agent's worktree option? In the form's worktree mode: "Every agent created from this template gets its own git worktree and branch".