AgentsRoom Help
- Desktop app
- All plans
What it does
An assistant that answers questions about AgentsRoom itself: what a feature does, where a setting lives, how to set something up. It reads the product knowledge base shipped with the app and, when it runs on your own CLI, your actual configuration too, so the answer matches your machine rather than a generic manual. Depending on the engine it can also change a setting or open the right screen for you when you ask.
It is not a coding agent and it never touches your project. It answers in the language of your question.
When you ask for something the product cannot do, it says so, names the closest thing that exists, and offers in one line to file the request on the public backlog. It never files anything without your yes.
Where to find it
- Title bar: the Help button (its bubble is titled AgentsRoom Help), in the right-hand group next to the personal assistant and your account, on the projects home and inside a project. Its logo carries the service status dot (green, orange, red).
- Projects home, search bar: the third cell Help ("Ask how AgentsRoom works") opens the same bubble. The other two cells, Projects and Build, are search modes.
- Inside two dialogs, an Ask for help button (the AgentsRoom logo, in the header of Add agent when you create a real agent, and at the top of Agent Teams): it opens the same bubble over the dialog, with a question about that step already typed for you.
- In Settings, the search bar has the same switch as the projects home: Settings (search) and Help. Help opens the bubble over Settings with "What would you like to configure?": describe what you want and, on a CLI that can act, the assistant changes the setting for you while Settings stays open behind it. Once it is done, Settings scrolls to that setting and flashes it, so you see what changed; when the assistant cannot change it for you, it still takes you to the right setting.
- At the very bottom of the bubble, Or reach us directly: Guide, Tutos, Feedback, Bug or idea, Community, Status. Tutos opens the AgentsRoom YouTube channel with every video tutorial. Bug or idea captures the AgentsRoom window and opens the in-app report form (the same as the footer Bug button, see Report a bug or an idea from the app (desktop)); the form links to the public backlog. The Community link opens the same panel as the Community button of the top bar (both called Chat before 1.184.0; the link kept the old name until 1.185.0).
- In the bubble header, under the subtitle: the engine and the model answering, two compact selects changeable right there (the same two settings as the card in Settings > Defaults).
- Settings > Defaults > Product assistant: which engine answers.
The bubble opens by itself once, a moment after the first-launch walkthrough, and never again. It always stays in the main window: unlike the personal assistant and the chat, it has no "Detach into a window" button.
How to use it
- Click Help in the title bar and type your question ("e.g. can I use two Claude accounts?"), then Ask.
- Watch what it is doing under the answer: Reading the knowledge base…, Reading your settings…, Changing a setting…, Opening the screen…, Filing the request….
- Ask it to act when the engine allows it: "turn that on for this project", "open that screen". An explicit request is carried out; its own idea is proposed first and waits for your yes.
- The conversation survives closing the bubble, including a question still being answered: since 2026-11-08 (reported by Allen) closing the bubble (click outside, the cross, a footer link) no longer cancels it, and reopening shows the answer arriving or the finished exchange. Start a new conversation clears it.
- Under its latest answer, Help asks Did this answer help? with Yes / No (since 2026-11-08). One click, once per answer: Yes thanks you, No thanks you and points at the links below to reach the team (Help has no human behind it, nothing is escalated). The question only shows when Share usage data (Settings > Privacy) is on, and never under an older answer or a failed one.
- Nothing left to ask? Use the tiles under Or reach us directly to reach a human or the public board.
Help on the step you are in: in Add agent or Agent Teams, click Ask for help. The bubble opens next to the form (the form stays where it is, nothing is lost) with a ready-made question ("Help me create an agent: which role, provider and settings should I pick for what I need?" or "Help me build a team of agents: which roles should follow each other, and how do I connect the steps?"). Edit it or send it as is: nothing is sent until you click Ask. The assistant knows which dialog you are in, so "this screen" means that dialog.
Settings
assistantProvider(global, Settings > Defaults > Product assistant, and under the question field of the bubble): the engine. A CLI with a headless mode (claude, codex, grok, opencode, copilot, mistral, antigravity, kimi),"cloud"for the AgentsRoom fallback, or empty to follow your default provider and fall back to the cloud when that CLI is missing. Only Claude Code can act; the row tells you which case you are in.assistantModel(global, same two places): the model the assistant's CLI answers on. Empty means the recommended affordable tier (sonneton Claude Code,gpt-5.6-lunaon Codex), which answers help questions as well for less. Any model of the picker can be pinned instead. The model field only appears when the engine is a CLI whose print mode accepts a model flag (Claude Code, Codex, Grok, Antigravity); the other CLIs run their own default model, and the cloud engine is not concerned. Changing the engine resets the pin (a model id means nothing to another CLI). Since 2026-11-12, on a CLI with an open model list (Antigravity, Codex...) a free-text field under the picker takes any model id your account reaches, for examplegemini-4-carbon-highon Antigravity; leave it empty for the recommended tier.assistantIntroShown(global, no UI): whether the bubble already opened by itself once. Set it back to false to see the intro again.
Agent tools (MCP)
The knowledge base is not reserved to the assistant: every agent in your projects can read it.
product_help_index: the list of feature fiches with what each one covers.product_help_get: one fiche in full, by slug.product_help_search: the fiches that match a question.
The assistant itself also uses settings_list / settings_get / settings_set, ui_open (a fixed list of screens it may open) and report_issue (a feature request or bug on AgentsRoom's public board, only after your yes).
Providers
Claude Code answers and acts (settings, opening screens). Codex, Grok, OpenCode, Copilot, Mistral, Antigravity and Kimi answer only: they read the knowledge base and your configuration, and cannot change anything. Whichever CLI answers, it starts in a folder of its own, so a project with no agent, or no project at all, changes nothing. A CLI with no headless mode is refused with a message pointing at the setting. With no usable CLI on the machine, the AgentsRoom cloud answers instead: it explains and gives the exact click path, and leaves the change to you.
Mobile
Not on the phone. The mobile companion reaches the team through its chat, opened from the people button next to the AgentsRoom logo, at the top of the Projects screen (with the unread badge), and the guide and support links live there.
Limits
- On a CLI engine, each question runs on your subscription and counts toward its quota. Nothing is sent to AgentsRoom on that path.
- The cloud fallback is capped at a few questions a day per address; past it, the message points at installing a CLI. Only your question and the interface language are sent.
- When your CLI cannot answer (not signed in, usage limit reached, stopped before replying, could not reach the AgentsRoom help), the cloud answers that question instead and a note under the answer says why the CLI was skipped and how to get it back (sign in to the CLI in a terminal, wait for the limit to reset, or pick another CLI in the setting).
- The cloud engine cannot read your configuration, change a setting or open a screen.
- It knows the product, not your code: questions about your own repository belong to an ordinary agent.
- A feature shipped without its knowledge-base entry is invisible to it; it will say it does not know rather than guess.
Common questions
- Does it cost me anything? On a CLI it uses your own subscription quota. The cloud fallback is free and rate-limited.
- Which model does it use? Can I change it? By default the recommended affordable tier of the engine you picked (
sonneton Claude Code,gpt-5.6-lunaon Codex). Change it right under the question field of the bubble, or in Settings > Defaults > Product assistant, whenever the CLI allows it. - Is there a video tutorial? Yes: the Tutos tile at the bottom of the bubble opens the AgentsRoom YouTube channel, where every feature has a short walkthrough.
- Is my code or my project sent anywhere? No. On a CLI everything stays local; on the cloud only your question and the UI language leave.
- It told me it has no access to the help. That was a bug on Codex and the other CLIs, fixed in the release after 1.251.0: update AgentsRoom. Every CLI now reads the knowledge base, and when one cannot, the cloud answers instead and a note under the answer says so.
- Why can it not change my setting? Only Claude Code can act. Pick it in Settings > Defaults > Product assistant, or apply the path it gives you.
- I closed the bubble while it was answering and my question was gone. Fixed on 2026-11-08 (reported by Allen): the answer keeps coming in the background and is there when you reopen Help.
- Why does it ask "Did this answer help?" So the team sees which answers miss. Your Yes or No is attached to that question only. With Share usage data on, questions and answers are already sent. With it off (the default since 2026-11-10), nothing is sent until you click Yes or No: then your question, that answer and your verdict are sent, and a line under the buttons says so.
- It said a feature does not exist. Ask it to file the request: it opens a ticket on the public backlog and hands you its URL.
- Where did "Feedback & support" go? It became this button. Its five destinations are the tiles at the bottom of the bubble.
- Can AgentsRoom configure itself for me? Yes. Open Settings, click Help at the right of the search bar and say what you want in your own words ("switch to the dark theme"). With a CLI that can act (Claude Code), the assistant finds the setting, changes it and scrolls Settings to it (the row flashes); otherwise it takes you to the setting and tells you what to click. Anything you had typed in the search is kept as the question.
- I am stuck in the agent or team form. Click Ask for help in the dialog: the bubble opens on top of it with the question already written, and the form keeps what you typed.
- Is there a documentation I can read in a browser? Yes, since 2026-10-02: agentsroom.dev/docs (site menu Resources > Documentation) publishes the same knowledge base this assistant reads, one page per feature, in English, with a search (
Cmd/Ctrl+Kor/). Each page also exists in Markdown (/docs/<page>.md) for an AI agent to read. - Can I open Help in its own window? No, the Help bubble stays in the main window. The personal assistant and the chat can be detached, Help cannot.
Related
- In-App Guide: the step-by-step tour, one of the tiles at the bottom of the bubble.
- Feedback & Support Chat: reaching a human, and following what you reported.
- Public Remote Backlog: where a filed request lands.
- Welcome Chat: the Build mode of the same search bar.
- AgentsRoom MCP: the connector the knowledge-base tools belong to.
- Assistant (personal assistant): the other title-bar assistant, which works in your projects instead of answering about the product.
- Customize Agents: the Add agent dialog where the Ask for help button sits.
- Agent Teams: the Agent Teams dialog, the other place with that button.