AgentsRoom documentation

The macOS, Windows and Linux app where your agents run.

• Account Auto-SwitchWhen the account an agent runs on hits its usage limit mid-task, AgentsRoom hands the same conversation to another signed-in account of the same provider and the work continues: no restart from a blank prompt, no waiting for the 5-hour or weekly window.
• Adaptive ModeSmart model routing from the composer.
• Agent DelegationA developer agent that has just finished a feature does not test it itself: it calls one tool, run_qa_test, on the AgentsRoom Test Runner MCP server.
• Agent MessagingThe saved agents of a project are permanent members that can write to each other, whichever CLI each one runs.
• Agent Reply LanguageDecides which language your agents answer in, whatever language you write in.
• Agent TemplatesA library of reusable agent definitions saved at your account level, organised in folders, ready to instantiate in any project.
• AgentsRoom HelpAn assistant that answers questions about AgentsRoom itself: what a feature does, where a setting lives, how to set something up.
• AgentsRoom MCPAgentsRoom exposes itself to the agents it runs, through the Model Context Protocol.
• AI Commit MessagesWrites one clean commit message from the real git diff of the files you are about to commit.
• AI Suggestion (Intent Screen)A short screen shown before an agent session opens.
• Appearance CustomizationMakes the app look the way you want: light, dark or system theme, an accent color applied to buttons, borders, focus rings and active states, replaceable interface fonts, a global zoom for tired eyes, and a "calm rendering" switch that stops decorative animations.
• Auto-updateThe desktop app checks for a new version on its own, downloads it in the background and installs it the next time you quit AgentsRoom.
• Beta ProgrammeSome features open to a small group before everybody.
• Browser AutomationEvery project has a real Chromium browser embedded in the right panel, with its own persistent session (cookies, local storage) per project.
• CLI DoctorAn agent in AgentsRoom is a third-party CLI (claude, codex, grok, agy, ...) started in a terminal, and AgentsRoom never bundles those binaries.
• Codex Data StorageEvery Codex agent runs in a folder AgentsRoom generates per project and per account, where Codex keeps its conversations, logs and generated images.
• Command PaletteOne search field over everything the open project holds: skills, scheduled agents and webhook triggers, prompts, memory notes, open backlog tickets, dev commands and saved SSH / database connections, the project's agents, the repository files, the last 200 commits, then the agents of your other projects and the projects themselves.
• Command ProposalEvery agent CLI runs inside a sandbox, and when that sandbox refuses a command the agent used to have only one way out: print the line in its answer and ask you to run it somewhere else, then paste the output back.
• Commit ContextAttaches the agent conversation behind a commit to the commit itself.
• Contact Between MembersTwo additions to the community surfaces of the chat, shipped in 1.182.0.
• Context CanaryA long agent session rarely breaks all at once: as the context fills, the model quietly drops a small instruction a turn or two before it invents a file, an API or a decision that never existed.
• Dynamic IslandA small borderless, transparent window that floats above every other application, anchored to a screen edge, and plays a different animation depending on the global state of your agents: all idle, at least one working, or at least one waiting for your input.
• Early Exit ChatIf you close AgentsRoom after a very short first session, the mascot opens once and asks a single question: what made you stop today.
• Git WorktreesA worktree is a separate checkout of your repository on its own branch, inside the project under .worktrees/<branch>/.
• Import RepositoriesConnect GitHub or GitLab once, see the repositories you own or are a member of, tick several and clone them in a single pass.
• In-App GuideFour pieces of help live inside the desktop app.
• Interface ElementsLets you hide, one by one, the small chrome elements you never use: the Community button of the title bar, the banners and toolbar of the agents column, the buttons of the dock, the decorations and floating controls of an agent panel, the pills of the footer, the tabs and blocks of the right panel, the buttons of the dev command bar.
• Interface ModesAn interface mode chooses how much of the cockpit is on screen.
• Keep the Machine AwakeWhile an agent is thinking, a dev command is running or a database export or import is in flight, AgentsRoom asks the operating system not to suspend the machine.
• Linked PromptsLets a prompt include other prompts from the same library, by copy.
• Multi-Provider SupportEvery agent in AgentsRoom is a real third-party coding CLI running in its own terminal, and each agent picks its own CLI: Claude Code (Anthropic), Codex CLI (OpenAI), GitHub Copilot CLI, Antigravity CLI (Google), OpenCode, Aider, Grok Build (xAI), Mistral Vibe, Kimi Code (Moonshot AI), Amp (Sourcegraph), oh-my-pi, Freebuff (Codebuff), Devin (Cognition) and Cursor (Anysphere), 14 providers in all.
• Multiple AccountsSign in to several accounts of the same CLI (a Work login, a Personal login, one per client) and keep them all active in the same window.
• New ProjectDescribe what you want to build in one sentence and AgentsRoom turns it into a project without any other question: no folder picker, no git prompt, no framework menu.
• Ollama and Local ModelsOllama is a provider of the AgentsRoom catalogue: pick it on an agent and type the model you want to run, local or hosted on Ollama Cloud.
• Open SpaceOne full-screen view of the whole account: every project you have open and every agent inside it, on one board with a column per state, most urgent first: Needs you, To review, Working, Available (and Done, the agents you parked, on demand).
• Per-Agent ReviewWhen several agents work on the same project at once, AgentsRoom records which agent touched which file and lets you review and commit one agent at a time.
• Process GuardAn AI agent spawns a real system process for every tool it calls (a search, a build, a script).
• Project MemoryA persistent knowledge base attached to a project, written and read by the agents themselves while they work: architecture, decisions, conventions, pitfalls, the state of each feature.
• Project SharingThe owner of a project invites other AgentsRoom accounts to it.
• Project StatisticsA per-project panel that answers "where did the time go": eight headline numbers (Time open, Active, Idle, Avg active agents, Prompts, Agents opened, Tokens, Cost), a By day activity chart and a By agent table (Active, Idle, Prompts, Cost per agent).
• Project WindowOpens a project in a window of its own, pinned to that project: one window per project, as many windows as you have projects.
• Projects HomeThe screen you see when no project is selected: every project of the account as a grid grouped by folder, with a big search bar on top and a toolbar to sort and filter.
• Quota RulesA quota rule watches one quota gauge of a provider (an account, a window, a threshold) and acts on its own when the condition is met: block some launches, send a launch to another account, launch on another provider, model or effort, run one of your triggers, or move the agents already running to another account.
• RDS through AWS SSMReach an Amazon RDS database (or any service in a private subnet) that has no public endpoint, no inbound SSH and a locked security group, from your own machine, without a bastion or a VPN.
• Recent AgentsThe title bar shows the agents you opened last, across every open project, so you can jump back to the agent you just left in one click.
• Review ModeA full-screen review of everything your agents changed before you commit it.
• Scope LevelsAgentsRoom files what an agent knows and what it can reach on a ladder of scopes: the account (yours, everywhere), the folder a project is filed under (typically a client or an employer), the project (one repository, shared with everyone who clones it), and a single saved agent.
• ScratchpadA proper place to write a long, structured prompt before it reaches an agent.
• Screenshot to AgentCaptures a region of any screen and attaches it straight to the composer of the focused agent, as a numbered thumbnail ready to send with your prompt.
• Sent messages history and messages held by a CLI questionTwo safety nets around the composer of an agent.
• SketchA drawing canvas inside the agent composer.
• Smart HintsSmall contextual suggestions that appear when the app can see you are about to do something the long way.
• Split ViewTiles a project's workspace into several panes so you watch several agents at once, side by side, in one window.
• Start on the ticket in the agent's nameMany people name an agent after the tracker ticket it is created for: ARD-221, PROJ-14 login.
• Ticket ScopingAdds a framing step to a feedback ticket before anyone builds it.
• Voice ModeA two-way spoken conversation with one running agent.
• Welcome ChatThe first screen of a fresh install (no project yet) is a short conversation with the AgentsRoom mascot.
• Windows and LinuxAgentsRoom desktop runs on macOS, Windows and Linux with the same interface, the same settings and the same mobile pairing.

Features that span several surfaces: the desktop app, the phone app and the site.

• Account Sign-InOne AgentsRoom account serves the desktop app, the mobile companion, the site and the Chrome extension, and there are three ways into it: an email and a password, Continue with Google, or Continue with Apple.
• Agent Fork and Ask on the SideTwo gestures built on the same idea: copy a running agent's conversation without disturbing it.
• Agent MorphingSwitch a running agent's role on the fly without restarting it and without losing anything it knows.
• Agent NotificationsTells you when an agent finishes a turn or needs your input, wherever you are.
• Agent Status TrackingEvery agent carries a live status you can read from anywhere in the app: Working (the agent is processing or editing, with an elapsed timer counting up), Done (it finished its turn; unread completions are highlighted), Needs input (it is blocked on a question or a permission, the most urgent state) and Idle (ready for a prompt).
• Agent SuggestionsAn agent advisor for the moment you do not know which agent to use.
• Agent TeamsA team is a replayable pipeline of agent roles drawn on a visual canvas: Start, one or more Agent steps (each with its own role, provider, model, step instructions and optional skills), an End, and connections between them.
• AgentsRoom in Chrome (agents drive your own Chrome)Your agents drive the real Google Chrome on your computer, with your own logins, cookies and extensions, through the free "AgentsRoom.dev : AI Dev Remote Control (Chrome companion)" Chrome extension.
• All BacklogsOne board with the tickets of every project of your account, whichever machine the project lives on.
• Apple In-App PurchaseAgentsRoom Pro can be taken from inside the iPhone and iPad app, as an Apple subscription paid with your Apple ID.
• Assistant (personal assistant)The assistant is the one agent of your AgentsRoom account that is not tied to a project.
• Backlog Task BoardA kanban board attached to every project where each card is a task an agent can run.
• Chrome Extension"AgentsRoom.dev : AI Dev Remote Control (Chrome companion)" is a free Chrome extension that turns any web page into an entry point for your agents.
• Claude Code Token UsageTwo meters, both computed on your machine from the files the CLIs already write.
• CLI Update NoticeAgent CLIs announce their own updates when they start ("Update available!
• Cloud AgentsA cloud run is a job, not a remote session: a throwaway machine clones your repository from its remote, runs Claude Code or Codex headless on your prompt, commits, pushes a branch, writes a report and destroys itself.
• Community CatalogTwo public catalogs, one behaviour: anyone can publish a prompt or a skill from their own library, and anyone can search, read and install what other AgentsRoom users have published, without leaving the app.
• Community RoomsThree permanent group chats hosted by AgentsRoom, pinned at the top of the Community tab: Pro community for accounts on the Pro plan, Plus community for accounts on the Plus plan, Beta testers for members of the beta programme.
• Contributor StatusCredits the people whose reports turned into shipped work.
• Conversation ViewEvery agent pane has two faces: the raw terminal of the CLI, and the Conversation view, a chat-style rendering of the same session read from the transcript the CLI writes on disk.
• Crash ScreenWhen the interface itself breaks, AgentsRoom shows a readable screen instead of a black window (desktop) or a white one (phone).
• Customize AgentsFour tiers of agents in one picker.
• Database ConnectionsSave your MySQL / MariaDB, PostgreSQL and MongoDB connections once and open them as a tab next to your terminals: schema tree on the left, a statement editor, a result grid, plus a Data mode to browse and edit rows.
• Dev TerminalsA per-project terminal manager that lives next to your agents.
• Feedback & Support ChatThe in-app chat is where you reach the AgentsRoom team and follow what you reported.
• Figma to AI AgentsA workflow rather than a converter: take the Figma frame into a backlog ticket with the AgentsRoom Chrome extension (or send it straight to an agent), and let a coding agent implement it against your real components while you review the diff.
• File PreviewOne preview window for every file the app shows you: a file in the Files tab, a changed file in the Changes tab, an attachment in the composer, a result of the command palette, a path clicked in a terminal.
• Idea BoxA backlog board that belongs to your account instead of a project.
• Idea RadarAn idea board next to the backlog for everything you have heard but not decided on yet.
• Import TicketsBrings tickets that already live in GitHub Issues, JIRA Cloud or Notion onto the project's backlog, so agents can run them like any other card.
• LeaderboardThe Leaderboard ("What the community launches, builds and shares") is the community's scoreboard inside the Community panel: eight boards, each ranking one thing members do with AgentsRoom.
• Localhost TunnelExposes a local dev server as a public HTTPS URL on a subdomain you choose (https://my-app.preview.agentsroom.dev), without deploying or installing anything.
• MCP ServersYour own MCP servers (GitHub, Notion, Sentry, a database bridge, anything you already use from a CLI) are handed to every agent AgentsRoom launches, whatever CLI it runs on, next to the AgentsRoom servers.
• Message QueueInstead of sending every prompt right away, you stack messages above an agent's composer and send them one at a time, in the order you choose, so the agent gets one clear task at a time and you keep a view of what is still to come.
• Mobile-Desktop SyncThe mobile app is a live mirror of your running desktop: projects, agents, terminal output, dev servers, backlog and prompts sync to the phone in real time, and every action the phone takes (start an agent, type in a terminal, answer a permission prompt, close a session) is executed by the desktop on its own processes.
• Multi-Project Multi-AgentAgentsRoom runs several AI coding agents, on several projects, in parallel, inside one window.
• Needs Input InboxWhen an agent ends a turn with a question, a permission prompt or a choice to make, AgentsRoom makes it impossible to miss: the agent's avatar gets a pulsing red halo and badge, its row is tinted red, the project row in the sidebar gets a pulsing beacon and is hoisted to the top of its zone, a soft ping plays, a desktop notification and a push to your phone go out, and a red needs input pill appears in the title bar.
• Pin an Agent to the Top of the ListKeeps one agent in sight whatever it is doing.
• Product NewsA short chat message that announces a change to the people who actually use the feature that changed (or, for some campaigns, to those who never tried it), written in the language they use in their Support thread, with a button that opens that feature in the app.
• Prompt LibraryA built-in manager for the prompts you keep retyping: save them once, organize them in folders with tags, and insert or send them in one click, on any agent.
• Prompt ReferencesLoading a saved prompt into a trigger, a ticket or a message used to be a copy: the text was pasted into the field and nothing tied it back to the library any more.
• Public Remote BacklogPublishes a project's backlog as a feedback portal for clients, users and teammates.
• Read AloudReads written text out loud in a natural synthetic voice: a markdown file, a terminal selection, the agent's last answer, or an AI summary.
• Remote FleetLinks every computer where you are signed in to AgentsRoom into one view.
• Remote SSH OffloadMap a project to a remote machine so that its agents run there instead of on your laptop: you pick a saved SSH connection and the path of the project on that host, and from then on launching an agent opens the SSH session and starts the agent CLI in that folder.
• Restore SessionBrings back your workspace after a quit: the projects that were open, the agent terminals, the dev command terminals, and the window at its previous size and position.
• Robin HoodTells you what one session really costs of your weekly limit, measured on real subscriptions, and warns when a provider quietly changes that balance.
• Scheduled TasksA trigger is a prompt, an agent (or a whole team) and one question: what makes it run?
• Secret ManagerThe one place where AgentsRoom keeps a secret: a machine-local vault encrypted through the operating system keychain.
• Skills LibraryA library of reusable procedures for your agents: each skill is a name, a "Use when..." description that tells the agent when it applies, and a markdown body with the steps (review checklist, migration pattern, accessibility audit, framework conventions).
• SSH ConnectionsAn SSH connection manager and a built-in SSH terminal in one place.
• Team ChatLets the people working on the same project talk inside AgentsRoom.
• Team cleanupKeeps a project's list of agent teams small enough to stay usable.
• Team Shared LibraryAnything set up at project level can be published to your team in one action and imported by every member: dev commands (the seed script, the migration runner), SSH hosts (staging, production, a jump box), database connections (engine, host, port, database, user, including ones reached through an SSH tunnel), prompts and skills.
• Usage AlertsWarns you before a provider quota runs out.
• Voice DictationDictate your prompts instead of typing them.
• Webhook TriggersA webhook trigger starts an agent (or a team) in your project when an outside service calls a URL, instead of at a set time.
• Which Chrome your agents drive (default Chrome per computer)With AgentsRoom and Chrome running on several computers of the same account, every Chrome profile that has the extension is visible to every desktop.
• Windows Connections (WinRM)A third transport for saved connections, on the same model as the SSH servers: the credential is typed once, stored in the OS keychain, and never shown to an agent.
• WorkspacesA project in AgentsRoom does not have to be a code repository you already have.

The iOS and Android companion that follows your agents from your phone.

• Live Agents (Live Activity and widgets)Shows the state of your AI agents where you look without opening the app: one Live Activity for the whole room on the iPhone lock screen, in the Dynamic Island, on the Apple Watch and in StandBy, plus home-screen and lock-screen widgets.
• Mobile CompanionThe Companion screen of the mobile app (Activity tab, then the Companion button at the top) turns the phone into a remote for the agents running on your desktop.
• Mobile Offline ModeThe phone is not always online.
• Remote Agent ControlOnce the phone is paired, the AgentsRoom mobile app is a full cockpit for the agents running on your computer, not a read-only viewer.
• Terminal Keys and the Agent ConsoleEverything a physical keyboard lets you do in an agent's terminal, from a phone screen, on a console laid out like the desktop pane so nothing has to be relearnt.

Signing in, plans, payments and the allowances that come with them.

• Adaptive PricingThe Pro price can be lower in countries with a lower purchasing power.
• AI Helpers AllowanceYour coding agents run on your own CLI subscription, but a few small helpers inside AgentsRoom call an AI model on the AgentsRoom side: voice dictation, Voice Mode, Read Aloud, agent suggestions, AI commit messages, the SQL assistant, CLI diagnostics (CLI doctor), AI summaries, translations, Adaptive Model suggestions and the AI Suggestion intent screen.
• Bring Your Own OpenAI KeyTwo ways to keep working when the AI included in your plan runs out, instead of being stopped mid-task.
• Gift a year of ProYou can buy one year of AgentsRoom Pro for someone else.
• Plans and PricingAgentsRoom has four tiers: Free, Plus, Pro and Team.
• Referral ProgrammeEvery account has a personal referral link.
• Team PlanThe Team plan turns AgentsRoom from a personal cockpit into a shared one.