Customize Agents
- Desktop, mobile and web
- All plans
What it does
Four tiers of agents in one picker. Built-in roles (14: DevOps, Fullstack, Frontend, Backend, Architect, QA, Marketing, PM, Security, Mobile, Git, SEO, i18n, Brainstormer) plus a Custom role whose persona you write. Experts from The Agency, a catalogue of 260+ specialists. Your own agents: name, category, description, vibe, system prompt and tags, stored at account level so they follow you in every project, with a server-generated avatar and an auto-translated name and description. Community agents: agents other users published, reviewed by moderation, credited to their creator's public pseudonym. AgentsRoom also detects agent definitions already on disk (the markdown files with frontmatter your CLI uses, in the project and in your home folder) and offers to import them.
Video (1:09): Customize Agents, shown in the real app. Shop rules that would be pasted at every session become a custom agent, Shop Reviewer (name, what it does, system prompt), picked under Your agents; asked to review a file with no rule in the message, it answers with a checklist that applies them, and Add agent in another project already offers it.
Where to find it
- In a room, Add agent opens a casting screen (from the left sidebar: New agent > Agent, "You drive it in its console"). Its search bar ("Who joins the team? A role, an expert, one of your agents…") returns results grouped as Your agents, Built-in team, Experts, Community, In this project and Teams; before you type, a wall of faces lets you pick one directly. At the top of that wall sit Create custom agent (opens the agent editor directly; the new agent lands on the stage) and Manage categories (create, rename, reorder, colour or delete your categories without leaving the project), since 2026-11-06. Links under it: Browse the full catalog, Run a team, Import from disk, and Help me choose an agent (the Agent Suggestions advisor, which here places its pick on the stage instead of creating the agent).
- Once someone is picked, the stage shows the avatar in the agent's color with the name field under it, a pencil (Change role or look) with a Role tab and a Look tab, and engine cards: Provider (the account is named under it), Model, Reasoning (only when the model has that lever) and Workspace. Advanced options opens a separate panel whose badge counts what you changed: Who gets this agent (Team: saved in the project's agents file and committed, Only me: a personal gitignored file), Capabilities, System Prompt, Skills & connections, CLI launch. The button reads Add <name>. Since 2026-09-30.
- Browse the full catalog opens the full picker: Core Team / Specialists, Experts · The Agency, Community. The first three sections carry a (Tech) qualifier after their name and a separator sits above Community, because only the community catalogue goes beyond software.
- Community section: Create your own agent, My agents, the category grid, Popular / Recent sort, and Top creators aligned on the right, which opens the Leaderboard on its Agents board.
- Categories are grouped in two families: Tech & Pro (Engineering, Product, Design, Marketing, Data, Writing, Ops, Other) and Lifestyle (Sport & Health, Learning, Lifestyle). Every category is shown even when empty; an empty one is a dashed Create the first one tile that opens the editor with that category already picked.
- When an agent search finds nothing: "No agent matches", with Create my agent.
- Site: the /agents page lists community agents with an install button that opens the desktop app.
- Your public pseudonym: Settings > Account.
- Deleting several agents at once: the eraser button above the agent list > Delete agents in all projects, or right-click a closed agent > Delete in all projects (opens the same window, with that agent's name already ticked). Since 2026-10-19.
- The menu of an agent (right-click its card) opens with a Search an action… field: type a few letters to filter its actions (Edit, Save to your agents...) instead of scanning the list. Since 2026-10-23.
- Editing an existing agent: right-click its tab or card > Edit. Any section of that window (Default skills, Connections, Capabilities, System Prompt...) can be pinned to its top: hover the section and click the pin in its left margin. Since 2026-10-22.
How to use it
Create a custom agent:
- Add agent > Create custom agent (also in Community > Create your own agent). The window is titled Create your agent ("Personal agent, usable in all your projects") and its button reads Generate agent. Fill Name, Category (one of YOUR categories, one of the ready-made categories listed under them (Engineering, Design, Sport & Health...), which becomes yours with its icon once picked, or a new one created from the list, with its colour and icon; see Agent Templates), What it does, Vibe (optional), System prompt, Tags (optional). Improve with AI rewrites the prompt (undoable).
- Optional: Skills & connections. Attach your skills and your saved connections (servers, databases, dev commands). They are pre-attached to every agent you create from this one, and stay private even if you publish the agent. The account-level ones follow the agent in every project; the ones of the project open at that moment follow it in that project only. Since 2026-10-09.
- Save (Generate agent). The new agent lands on the stage of Add agent, ready to add with Add <name>. It is Private, listed under My agents, usable in all your projects: next time, type a few letters of its name in the Add agent search and it shows first, under Your agents, in any project. Its avatar is drawn by the server a few seconds after saving; until then a letter or a plain circle stands in. When you pick it in Add agent, its skills and connections show up already attached in Advanced options > Skills & connections, where you can still change them before creating the agent.
- To share it with everyone, publish it: ticking Share with the community asks for the Community category, one of the 11 fixed categories of the public catalog (your own categories stay private). The status becomes In review, then Published once approved (or Rejected with the reviewer's notes). Editing a published agent sends it back to review.
Name it yourself: the name field under the avatar is optional and its placeholder shows the name the agent would get otherwise (its role, its template or the expert's name). A name typed there is treated as a deliberate rename and is kept: the title the agent gives its own conversation never replaces it. Leave the field empty and the card keeps the default identity, which the conversation title may take over. Since 2026-09-29.
Share with a teammate: drag the agent card into the in-app chat (team channel or direct message); they import it in one click. Prompts, skills, dev commands and SSH connection metadata travel the same way, never secrets.
Import on-disk definitions: when a project already has agent definition files, the room offers to import them (also reachable with Import from disk in Add agent); you pick which ones from a list, nothing is created behind your back. Since 2026-09-29 a description written on several lines in a file's front matter is read properly instead of arriving as >-, and nothing is pre-ticked in the list.
Run a raw agent: Advanced options > Capabilities > Minimal system prompt (also in the agent's edit window). The agent then gets only its CLI and your project rules (CLAUDE.md, AGENTS.md); AgentsRoom keeps only what makes the tab title and notifications work, plus a team step's handoff and the skills you attached to that agent. No role, no tool guide, no project memory, no pre-filled commit message: MCP tools stay connected but the agent is not told how to use them. Applies at the next launch. Since 2026-09-30.
Want it for every new agent? Turn on Settings > Agents & AI > Agent behavior > New agents: Minimal system prompt: the Add agent window (desktop and phone) then opens with the box already ticked (you can still untick it), and quick agents and the project's default agent start minimal too. Agents you already have are not changed. Catalog experts, the project assistant, agents started by another agent and team steps keep their full brief. Since 2026-11-10.
Keep the options you use at the top of the edit window: in Edit, hover a section and click the pin that shows in its left margin. The section moves to a Pinned block at the top of the window, in the order you pinned them, and stays visible even with Advanced options folded. Click its pin again to put it back in its place. Pins belong to your account: the same sections are pinned on all your computers and in the phone's edit sheet, where a long-press on a section title pins or unpins it. Since 2026-10-22.
How the persona reaches the agent: at every launch the agent's persona (the text of its built-in role, or your custom system prompt) is read again, so an edit you made to a role's text is honoured on the next launch. A persona of up to about 6,000 characters is written into the CLI's system prompt itself, which is re-sent on every turn, so the agent keeps its role after a context compaction. A longer persona, and the guide to the AgentsRoom tools, stay in a file the agent is told to open with its file-reading tool (not a shell command, whose output is cut short on a long file; a CLI with no such tool, like Codex, reads it through the shell in sections of about 200 lines) and to read again after every compaction. Since 2026-09-19.
The guide to the AgentsRoom tools is short since 2026-10-19: the agent reads an index of about 11 KB (the rules that apply to every tool, then one line per tool family), and opens the file of a family (backlog, memory, SSH, browser...) only before its first use of that family, instead of reading 57 KB at every launch and resume. To stop agents from being told to read it at all: Settings > Agent behavior > Tool guide at startup. A folder (Folder settings > Agents), a project (Project settings > Agents) or one agent (its edit window, Tool guide at startup: Inherit, On, Off) can override it, narrowest wins. Off, the agent keeps the short summary of its tools in its startup prompt, but no longer knows the detailed rules (when to ask before writing, how to announce a fix, and so on). Applies at the next launch.
Settings
minimalSystemPrompt(agent,settings_setwithscope: "agent"): the Minimal system prompt option above, for one agent, default off.newAgentMinimalSystemPrompt(global, synced with your account, Settings > Agents & AI > Agent behavior > New agents: Minimal system prompt, default off): new agents start with Minimal system prompt on. Applies to the Add agent window (desktop and phone, box pre-ticked and still editable), quick agents, the project's default agent andagents_savewithout an explicit value. Not per project. Catalog experts, the project assistant,agents_spawndelegations, team steps, templates and duplicates keep their own value.agentToolEtiquette(global, folder, project, agent; default on): the Tool guide at startup switch above. Off = the startup prompt no longer tells the agent to read the tool guide. Narrowest scope wins;nullon a folder, project or agent means inherit.ignoredAgentDefinitions(project, read-only): the on-disk definition files you chose not to import; written by the import dialog.pinnedSections(global, synced with your account and the phone; default nothing pinned): the sections pinned to the top of the Edit window, in pin order, as{ "editAgent": ["defaultSkills", "connections"] }. The section ids are listed insettings_list.
Agent tools (MCP)
agents_list/agents_get: the saved agents of a project, including whether a custom system prompt is set and its body.settings_list/settings_get/settings_setwithscope: "agent": read or change one saved agent's options,minimalSystemPromptincluded.agents_save: create a new project agent or update one (role, provider, model, custom system prompt, skills, capabilities).agents_delete: delete saved agents, by id or by exact name, in this project, in another one or in every project open in the desktop. One confirmation card in the agent's pane for the whole batch; nothing is deleted before you approve.dryRun: truelists what would be deleted without asking.
Providers
All providers, no difference: a built-in, expert, custom or community agent runs on whichever CLI you assign it (Claude Code, Codex, GitHub Copilot CLI, Antigravity, OpenCode, Aider, Grok Build, Mistral Vibe, Kimi Code, Amp, oh-my-pi, Freebuff, Devin, Cursor). The system prompt is never translated: the persona stays in its author's language. Minimal system prompt works on every provider; on Claude Code and oh-my-pi it is appended to the CLI's own system prompt instead of replacing it, so the CLI keeps its native instructions.
Mobile
Partly. The phone's Add agent sheet uses the same casting screen: search, Help me choose an agent, the stage with Change role or look, the Provider / Model / Reasoning cards and Advanced options (Who gets this agent, capabilities including Minimal system prompt, system prompt, Skills & connections); picking one of your own agents pre-attaches its skills and connections there too. The agent's edit sheet on the phone also changes its skills and connections. Since 2026-10-09. Its sections follow the pins of your account (pinned ones first, under Pinned), and a long-press on a section title pins or unpins it. Since 2026-10-22. Workspace and CLI options stay on desktop because they point at files of the computer. The full catalog offers the same tiers (Core Team, Specialists, Experts · The Agency, Community) with search, categories and install, the same (Tech) qualifier on the first three and the same Tech & Pro / Lifestyle grouping of categories; creating or publishing an agent is desktop only ("Create your own agents on desktop").
Deleting agents in several projects at once (Delete agents in all projects) is desktop only. On the phone, ask your assistant ("remove the old layou-dev everywhere"): the confirmation card of agents_delete shows in its console on the phone, and one tap approves the whole list.
Limits
- Custom agents per account: 3 on Free, 10 on Plus, unlimited on Pro.
- Publishing requires a public pseudonym and passes moderation; approved agents stay in the catalogue even if the creator deletes their account (credited "Community").
- Likes: one per user per agent, never on your own. Unique installs exclude the creator. Creator badges: bronze at 10 unique installs, silver at 50, gold at 250. The first agent to reach 25 unique installs grants its creator the Plus plan.
- Name, description and vibe are translated from an English canonical version; the creator sees their original text.
Common questions
- Can I build my own coding agent? Yes, with its own name, prompt, category and avatar, stored at account level and usable in every project.
- I paste the same long rules into Claude Code at every session, can I save them once? Yes: Add agent > Create custom agent, give it a name and put the rules in System prompt, then Generate agent. Pick it under Your agents in any project; it follows those rules without you repeating them. Video: https://youtu.be/P-g36vWD-vM
- Is there a video that shows it? Yes, about a minute, filmed in the real app: https://youtu.be/P-g36vWD-vM
- Do I get credit for publishing? Yes: your pseudonym on the card, install and like counters, creator badges, a top-creators leaderboard and a Plus reward at 25 unique installs.
- I already wrote sub-agents for my CLI, do I redo them? No. AgentsRoom detects them at project and user scope and offers to import them.
- My agent forgot its persona after a context compaction, or only followed part of it. Fixed on 2026-09-19. Before, the agent was only told to read its role file, and Claude Code in its bypass-permissions mode read it through a shell command that silently returns a short preview of a long file; what it had read then vanished with the first compaction. The persona is now placed in the system prompt when it fits, and the file instructions ask for the CLI's file-reading tool and a re-read after each compaction. Restart the agent to get the new prompt.
- I named my agents after my tasks and they all renamed themselves on the first turn. Fixed on 2026-09-29: a name typed in the Name field at creation now wins over the title the agent gives its conversation. Agents created before the fix keep their old behaviour until you rename them by hand.
- My agent is not about code, which category do I pick? The Lifestyle family: Sport & Health, Learning or Lifestyle. Added on 2026-09-29, because a coach or a tutor used to be filed under Engineering or Other.
- My agent follows AgentsRoom's brief more than my CLAUDE.md, can I turn the brief off? Yes, per agent: Minimal system prompt in Advanced options. The tab title and notifications keep working; the agent no longer knows how to use the AgentsRoom tools unless you ask it explicitly. Not available on team steps, which need their full brief.
- Can every new agent start with the minimal system prompt, like the plain CLI in a terminal? Yes: Settings > Agents & AI > Agent behavior > New agents: Minimal system prompt. It is off by default and only affects agents created after you turn it on.
- My agents spend a lot of context reading AgentsRoom's tool guide at startup, can I shorten or skip it? Since 2026-10-19 the guide read at startup is a short index (about 11 KB instead of 57 KB) and each tool's rules are read only when that tool is about to be used. To skip it entirely, turn off Tool guide at startup in Settings > Agent behavior, or only for a folder, a project or one agent.
- Can I give my agents fewer AgentsRoom tools, or rewrite what a tool's description says? Yes, since 2026-10-21: Settings > AgentsRoom tools switches tool families or single tools off for every project (a folder, a project or one agent can override each switch), and lets you rewrite a tool's description. See AgentsRoom tools settings.
- Can I put the settings I change most at the top of the Edit agent window, like Default skills? Yes, since 2026-10-22: hover the section in Edit and click its pin. It moves to a Pinned block at the top, even when Advanced options are folded, on every computer of your account and on the phone. Click the pin again to unpin it.
- Can my own agent come with my skills and connections? Yes, since 2026-10-09: Skills & connections in the agent's editor (Create your own agent or Edit). Every agent created from it starts with them attached, on desktop and on the phone. They are yours only: someone who installs your published agent gets the persona, never your skills or connections. Editing them does not send a published agent back to review.
- Can I give skills and connections to a saved agent without opening a project? Yes: Skills & connections is offered in the saved agent's form even from the dashboard; without a project, only the skills and connections of your account are listed.
- Why is my published agent back "In review"? You edited it; every edit to a published agent is re-moderated. Counters and likes are kept.
- I replaced an agent with a new version, can I remove the old one from all my projects at once? Yes, since 2026-10-19: eraser button above the agent list > Delete agents in all projects. Every saved agent of the projects open in AgentsRoom is listed, grouped by name: tick a name to remove it from every project, or open it to choose project by project. The name must match exactly, so ticking
layou-devnever takeslayou-dev-v2with it. Only projects open in the app are covered. An agent at work, running a team step, protected from agent close, running a scheduled task, or the project assistant, is shown but cannot be ticked. - I have several copies of the same agent in a project, how do I clean them up? Same window: a name with copies shows Select N duplicates, which ticks every copy except the most recently used one in each project.
- Agents launched for backlog tickets stay in my list after I close them, how do I remove them? Since 2026-10-20, closing a ticket's agent whose ticket is already done removes it from the list (a ticket still open keeps its agent, so you can resume it). For the ones left over, eraser button above the agent list > Clean up backlog ticket agents: it removes every inactive agent launched for a ticket, never your saved agents nor a running session.
- Can my assistant or an agent delete agents for me? Yes, on your instruction ("remove the old layou-dev everywhere"): it calls
agents_deleteand you confirm the whole list on one card in its pane. The same card shows on the phone, in that agent's console, so you can approve from the mobile app. If you decline or do not answer within 2 minutes, nothing is deleted and the agent does not retry. Since 2026-10-19. - Can I reuse an agent with its CLI, model and permissions in all my projects? Yes, since 2026-10-14: right-click it in the room > Save to your agents. It then appears under Your agents in Add agent, in every project, and stays private (see Agent Templates). An agent made with Create your own agent keeps a persona (name, prompt, category, toolkit) and gets its CLI and model when you add it.
Related
- Agent Templates: reusable full configurations (provider, model, skills) for your agents.
- Agent Suggestions: the advisor that picks among these tiers from a task description.
- Agent Morphing: switch a live agent into any of these roles.
- Team Chat: the chat used to share agents with teammates.
- Skills Library: shared skills, the other marketplace.
- Leaderboard: the Top creators button of the Community section and the Agents board it opens.