Assistant (personal assistant)

  • Desktop, mobile and web
  • All plans

What it does

The assistant is the one agent of your AgentsRoom account that is not tied to a project. The interface calls it "Assistant" (title bar, Settings tab, phone tab), its default name is "Personal assistant" (you can rename it), and a few settings labels still say "Bot", its original name. It is one click away in the desktop title bar and one tap away in the mobile app. You ask in plain words, spoken or typed: "handle the last bug of the shop project", "add a task to the mobile backlog", "find out whether this library is still maintained". It lists your projects, reads and files backlog tickets in any of them, launches or resumes an agent there, searches the web, and reports back in a few lines, always saying in which project it acted. It never writes code itself: it hands that to the project's agents. It confirms before sending, deleting or publishing anything. Every calendar day starts a fresh conversation, with the previous day's one offered for resumption. If you allow it, it keeps a private memory of its own between conversations: one dossier per subject of your life (your building's management, your investments, a training plan), the people you deal with, and a dated journal of your requests (see Memory below). Shipped to everyone in 1.176.0; since 1.178.0 its panel can live in a window of its own. The site page is agentsroom.dev/features/assistant.

Video (1 min 19 s): The assistant's private memory, shown in the real app. The assistant is told once about a half marathon (date, goal, coach), files a Running dossier and a contact card on its own, and in a brand-new conversation still answers with the race date and the coach.

The assistant runs on your desktop, in a hidden home project of its own (never inside one of your repositories, so no project instructions leak into the conversation). That home is not listed among your projects and does not count in your plan's project limit.

Where to find it

  • Desktop, title bar: the right-hand group shows "Help", then the assistant's button (its avatar, its name, a status dot: grey until its console was ever opened, green at rest, orange while thinking, red when it waits for you; it also reflects the specialists, see Assistant specialists). Clicking it opens a floating panel under the button, which is the agent's real pane (conversation view, terminal toggle, composer, dictation, Voice Mode). Hovering shows "Open Personal assistant" (or the name you gave it). The panel's header holds two buttons: the "Assistant actions" menu (three dots: "What is this?", "Start a new conversation", "Previous conversations", "Close session", "Global triggers", "Open notes", "Open the memory", "Bot settings") and "Close". Its tab strip ends with two more buttons, one click away: "Detach into a window" (shown once the console is mounted) and "Minimize" (hides the panel like "Close"). "Bot settings" opens Settings on the Assistant tab; the memory choices are further down, under "Memory" in the tab's sub-menu. "Close" only hides the panel and the conversation keeps running; clicking anywhere in the app behind the panel (an agent's terminal or screen, the sidebar) hides it the same way, while clicks in a dialog or menu opened over the app leave it open; Close session in the panel's menu (or the button of its own window) stops the assistant's process, keeps the conversation and closes the panel, the same as Close session on the phone.
  • Video tutorial: the video tutorial icon (a help icon with a small play badge) sits in the header of the Assistant memory window (opened by the brain button), next to its close button; it opens the memory video on YouTube in your browser.
  • Desktop, Open space: a header button and a first-row launcher, "Talk to Personal assistant".
  • Desktop, Settings > Agents & AI > Assistant: all its settings. Settings > Defaults > "Personal assistant" shows its provider and model and opens that same tab.
  • Mobile: the "Assistant" tab in the middle of the tab bar (a raised circle with its avatar and the same status dot), and the "Assistant" card in the phone's Settings.
  • Mobile, system entry points: the deep link agentsroom://bot, Siri "Talk to Bot in AgentsRoom", the iPhone Action button and Back Tap (through that shortcut), a long press on the app icon ("Talk to the assistant" / "Write to the assistant"), the Android home screen widget and Quick Settings tile ("Personal assistant"), and "Send to Personal assistant" at the top of the text share sheet.

How to use it

  1. On the desktop, click the assistant's button in the title bar. The first time, a welcome window explains what it does ("Got it"); the panel shows its console starting ("Starting the console…"). The first launch may ask the CLI's folder-trust question once, like any new folder.
  2. Type or dictate your request in the composer, or use Voice Mode like with any agent.
  3. The answer arrives in the conversation view and as a notification titled with its name. When a task took more than a minute, the desktop also says your first name and what was done out loud (see Settings).

From the phone: tap the "Assistant" tab, or use any system entry point. The app opens the assistant's real agent screen (conversation and composer); the Siri, widget, tile, Action button and "Talk to the assistant" routes open it with the composer's dictation already recording, "Write to the assistant" opens it with the keyboard. If the desktop is off, the assistant is disabled, or no console can be opened, a card says why with "Try again".

Sharing text from another app: pick "Send to Personal assistant" in the share sheet. If the desktop is unreachable, the text is kept on the phone ("Kept for Personal assistant, sent when your desktop is back") and goes as soon as it is back.

Starting over today: Settings > Assistant > Identity > "Start a new conversation", or the same button in the panel's header. Closing the panel keeps the console alive; reopening reattaches to it.

A new day, or a restart of the app on a new day, boots the assistant on a blank conversation and shows the Restore past agent card above its composer with the previous day's conversation: Resume picks it up where it stopped, Ignore keeps the fresh one. Reopening the panel later the same day resumes silently. Only "Start a new conversation" forgets the previous conversation for good (since 2026-09-20; before, a restart on a new day dropped it with no way back). The card only exists when the assistant runs on a CLI that can reopen its own conversation (see Restore Session).

In its own window: click "Detach into a window" at the right end of the panel's tab strip, next to "Minimize" (shown once the console is mounted; since 2026-10-23 it is no longer in the three-dot menu). The floating panel leaves the main window and the same conversation continues in a separate window, which you can move to another screen; the title bar button now brings that window forward instead of opening the panel. The window keeps "Start a new conversation" and the settings button, and its "Reattach to main window" cross (or closing the window) puts the panel back under the title bar button. That window does not follow the project you switch to in the main window, and it reopens at the next launch when the app restores your session.

Settings

All in Settings > Agents & AI > Assistant on the desktop; the phone shows the same rows in its "Assistant" settings card and writes them back to the desktop (greyed out until a desktop is connected). They are stored on the desktop machine, not on the account.

  • botAgentEnabled (global, "Enable Bot"): master switch. Off, the title bar button and the Open space launcher disappear, the phone's tab is hidden and its messages are refused.
  • botAgentName (global, Identity > "Name"): the name it answers to everywhere. Empty = "Personal assistant" in the interface language.
  • botAgentAvatarImage / botAgentAvatarRole (global, Identity > "Avatar"): a custom picture, or the art of a built-in role.
  • botAgentProvider (global, Provider and model > "Provider"): the CLI it runs on. Empty = "Same as your quick agents".
  • botAgentModel (global, "Model"): empty = "Provider default".
  • botAgentReasoningEffort (global, "Reasoning effort"): empty = provider default.
  • botAgentCodexServiceTier (global, Provider and model > "Codex service tier", shown only when the assistant runs on Codex): "Inherit" (empty, the default) keeps your usual Codex speed setting; "Standard", "Fast" or "Ultrafast" pins a tier for the assistant alone. Fast and Ultrafast consume more usage, Ultrafast is offered only when the selected model and account advertise it, a line shows the "Effective tier at next launch", and a change applies when the assistant next starts. Specialists do not inherit it.
  • botAgentAccountProfileId (global, the account row under the model: "Claude account", "Codex account", "Antigravity account", "Grok account" or "Cursor account" depending on the provider): which signed-in account the assistant consumes. "Default" (empty) follows the account of your other agents, the pill names what that resolves to; "Default account" forces the login the CLI made on its own. Picking another provider clears it, an account never crosses CLIs. The row only shows for a provider with accounts (see Multiple Accounts).
  • botAgentSpawnWithoutConfirm (global, Behaviour > "Can launch agents without confirmation"): off by default, you confirm each agent launch on the desktop.
  • botAgentAnnounceByName (global, Behaviour > "Call me by my first name when a long task ends") and botAgentUserFirstName ("First name", empty = the first word of your account name): the spoken announcement, in the Voice Mode voice, on the desktop only.
  • botAgentSyncConversations (global, Behaviour > "Sync conversations across my computers", on by default): after each answer, the conversation of the assistant and of each specialist is uploaded end-to-end encrypted (only your computers hold the key, the server cannot read it) and kept 30 days. Opening the assistant on another signed-in computer picks the latest one up before its console starts: same day it continues silently, an older one is offered by the Restore past agent card. "Previous conversations" in the panel's menu lists the last 30 days from all your computers and Continue reopens one. With two different CLIs on the two computers, the other one starts a fresh session that reads the previous exchange first. Off, nothing is uploaded nor picked up.
  • botAgentReviewDelaySec ("Review delay before sending") and botAgentStopOnSilence ("Stop recording on silence") are still shown, but the phone now uses the composer's dictation, which they do not drive.
  • botAgentRef and botAgentConversationStartedAt: internal, which agent is the assistant on this machine and when today's conversation started.
  • Memory (Settings > Assistant > "Memory", also the "Memory" card of the phone's Settings): "What your assistant remembers", three choices, no default: "Nothing", "Ask me first", "Automatic". Stored on the ACCOUNT (server), not on the machine, so every computer and the phone show the same answer. Not an AppSettings key and not settable by an agent: only the user turns the memory on. Below the privacy block, a "Notes" line shows how much of the text room is used ("4.9 MB of 6 MB used", turns orange with a warning from 80 %), then an "Images" line how much of the plan's image storage is used ("12.4 MB of 30 MB used, 40 of 150 images"). Under the "Notes" line, "Prune old versions" (shown once a note has a saved version) removes the saved versions of every note, on all devices, after a confirmation that says how much room comes back; the current text of each note stays, and the number of versions kept for later edits does not change (still 20). Buttons: "Open the memory", "Export as Markdown" (a zip with an images folder once the memory holds images), "Export as JSON", "Erase everything".

Memory

  • What it is: the assistant's private memory, separate from the account memory your coding agents read. Folders: profile (who you are, preferences, which address goes with which subject), dossiers/<subject> (context, goals, follow-up, and a journal of dated lines), contacts (one card per person), inbox (notes to sort).
  • First use: the assistant panel asks "Should your assistant remember?" with the three choices; "Decide later" asks again at the next launch. Until you answer, the assistant has no memory at all (the server refuses it).
  • Ask me first: it proposes in one line what it would keep and saves only on a yes. Automatic: it saves on its own and says so in one line. After a turn that wrote to the memory, the panel shows "Kept in memory: ..." with See and Undo (puts the notes back as they were before the turn).
  • Browse and edit: the brain button in the assistant panel header, or "Open the memory" in Settings: notes grouped by section and dossier, search, edit, delete, and "Versions" (the last 20 states of each note, "Restore").
  • Privacy: encrypted on the AgentsRoom servers with a key specific to your account; only the assistant reads it, never your project agents. When it reads a note, that note is sent to your model provider like the rest of the conversation. Passwords, tokens and card numbers are refused ("This looks like a password, a token or a card number"); keep those in the secrets vault (Commands > Secrets). IBANs are accepted.
  • Text room: 6 MB of text, the same on every plan (Free, Plus, Pro). It counts the notes AND their saved versions (the last 20 of each note), so a note edited often weighs much more than its text. Settings > Assistant > Memory shows "Notes: X of 6 MB used" and warns from 80 %. When it is full, new notes and longer notes are refused ("The assistant memory is full"); a save that makes a note shorter is still accepted (the oldest saved versions of that note make room), and deleting a note always works. "Prune old versions" (Settings > Assistant > Memory, desktop and phone) frees the room the saved versions take in one go, without touching any note's text; only the user can do it, never the assistant. For the assistant, memory_list (scope assistant) returns usage (usedBytes, maxBytes, usedPercent, a warning from 80 %) and, per note, chars (its length) and storedBytes (with its saved versions), so it can condense the heaviest notes first.
  • Images: the memory keeps photos inside its notes (a recipe, a scanned letter, a training plan). Drop an image on the assistant panel on the desktop and tell it what to keep, or share photos from another app on the phone and pick "Send to <name>": they are kept at once in the "To sort" section, then the assistant files each one in the right dossier. In the memory browser an image shows inside its note; click (tap) to see it full size, "Delete image" removes it from the note and from the storage. Images are re-encoded by the server (WebP, at most 2048 px, location data removed) and encrypted like the notes. Storage depends on the plan: Free 30 MB / 150 images, Plus 150 MB / 750, Pro 1 GB / 5 000; one image is at most 15 MB sent, 2 MB once compressed. When it is full the assistant says so and nothing is stored. Deleting a note deletes the images only it showed.
  • Leaving: "Export as Markdown" / "Export as JSON" saves a copy (Markdown becomes a zip with the images when there are some); "Erase everything" deletes every note on all devices (the choice stays). Deleting the account deletes the memory.

Agent tools (MCP)

The assistant is itself an AgentsRoom-MCP client. The tools its persona relies on:

  • projects_list: every project of the account, the ones open on this desktop first (openHere: true); "my projects" means those.
  • backlog_list, backlog_get, backlog_create, backlog_start_next: read and file tickets in any project (project argument).
  • agents_spawn, agents_resume: put an agent on a task in a project open on this desktop.
  • teams_list({ project }), teams_run({ project, team, prompt }): hand a task to one of a project's agent teams, brief included, without copy-pasting it. You approve the run on a card in the assistant's panel (or on the phone), unless you allowed it to launch agents without confirmation; the assistant is told when the run stops. Since 2026-10-20.
  • agents_questions_list, agents_question_answer: reads the questions your agents are waiting on in every project, AgentsRoom cards and Claude Code's own question dialog (see Structured Questions), and passes on the answer you give it, or a Not clear? (cards only). Only your explicit answer: it never picks an option for you, not even the one the agent recommends. Main assistant only among the assistants, since 2026-10-20; a project's coordinator gets the same two tools for its own project (2026-10-23).
  • memory_list, memory_get, memory_save, memory_delete with scope: "assistant": its private memory, reserved to the assistant (any other agent is refused) and only once you turned it on. memory_list returns the chosen mode.
  • assistant_journal({ dossier, entry }): one dated line in a dossier's journal; the server adds the date in your time zone. Hidden from every other agent.
  • assistant_attach({ path | id, note, dossier, caption }): keeps an image in a note (a file on this computer by path, or moves a photo already in the memory, such as one waiting in "To sort", by id). assistant_image({ id }) shows a kept image back to the model, plus a local copy path for CLIs that open images by path. Both hidden from every other agent, same consent rule as saving.

Providers

The assistant runs through an installed CLI like any other agent, so it inherits the MCP connectors attached to your account (mail, calendar, messaging) and the AgentsRoom tools. Any provider you can pick for a quick agent works; by default it follows your quick-agent provider. A provider without an MCP client (Aider) answers, but cannot reach your connectors or your other projects; the settings tab says so when you pick one. The account row exists for Claude Code, Codex, Antigravity, Grok and Cursor, the providers that carry account profiles; the others have no such row.

Mobile

Fully present: the "Assistant" tab, the deep link agentsroom://bot (?mode=talk or ?mode=write), Siri, Action button, Back Tap, long press on the icon, Android widget and tile, the share sheet, and the same settings rows in a card titled "Assistant" (no Beta badge any more). When the desktop has it turned off, the phone says "Enable it in Settings > Assistant there." The phone never runs the assistant: it opens the desktop's agent screen through the encrypted relay, so the desktop app must be running. The tab and the assistant's cards are hidden from project lists and the Activity feed, and the tab disappears when the desktop reports the assistant disabled. The "Reasoning effort", "Account" and "Codex service tier" rows are on the phone too, with the same "Default" pill naming the inherited account; when the desktop runs an older version the account row shows no inheritance subtitle. Icon shortcuts, widget and tile need the store build of the app. The separate window is a desktop thing: nothing changes on the phone. "Previous conversations" is on the phone too: the clock button in the assistant's tab strip lists the last 30 days of synced conversations (asked to the connected desktop, which holds the keys) and Continue restarts the tab on one of them.

Limits

  • Requires being signed in to the AgentsRoom account: the transcription and the spoken announcement run on it ("Sign in to use Bot" in the settings tab).
  • Settings are local to the desktop machine; a second computer has its own assistant and settings. Its conversations follow you (see botAgentSyncConversations), except a conversation encrypted before a computer joined the account: it shows a lock there until it is continued once on the computer that wrote it.
  • The Siri phrase "Talk to Bot in AgentsRoom" is fixed, in English, whatever name you gave it.
  • The share sheet sends text, links and photos to the assistant (photos need its memory turned on); other files go to the mobile companion.
  • One pane at a time: while the assistant is out in its own window, the floating panel cannot open in the main window, and the panel exists in one desktop window only.
  • A text kept on the phone while the desktop was away is replayed on reconnection; a message that failed to send is not.
  • Quota rules apply to every message the assistant or a specialist receives from the phone, the share sheet, a delegation or a trigger, not only to its launch: a blocking rule refuses the message with its notice (a trigger can be set to ignore quota rules). See Quota Rules.
  • The spoken announcement is silent while Voice Mode is open on the assistant, when signed out, and only one desktop window speaks.

Common questions

  • Can the assistant tell me what my agents are asking, and answer for me? It reads you the open questions of every project and passes on YOUR answer ("answer yes to the security architect"). It never answers on its own, even with a recommended option: no answer from you, nothing is sent.
  • Why did it not open in my project? By design: the assistant lives in its own hidden home folder and opens in a floating panel, never in a project room. Its console is not listed in any project's roster.
  • It says "Your desktop is offline" on the phone. The assistant runs on the desktop app: open AgentsRoom there, then "Try again". Shared text waits on the phone; a dictated request does not start until the desktop answers.
  • Can I change its name or face? Yes: Settings > Assistant > Identity. The title bar, the phone, the notifications and the icon shortcuts follow.
  • Does it remember yesterday? The conversation restarts every day, but the card above the composer offers to Resume yesterday's conversation. If its memory is on (Settings > Assistant > Memory), what it kept (dossiers, contacts, journal) comes back at the next start either way.
  • Can I stop it from remembering, or make it forget? Settings > Assistant > Memory > "Nothing" stops it; "Erase everything" deletes what it kept; a single note can be deleted or restored from "Open the memory". You can also just tell it "forget that".
  • I talk to the assistant on two computers: why can I not find the conversation on the other one? Since 2026-10-29 the conversations sync between your computers, end-to-end encrypted ("Sync conversations across my computers", on by default). Open the assistant on the other computer: it continues where you stopped; "Previous conversations" in its menu lists the last 30 days. Both computers must run a version with the feature and be signed in to the same account.
  • Can my project agents read what the assistant remembers? No. The assistant's memory is private to it; your coding agents only see the project memory and the account memory.
  • How do I see what the assistant remembers? Click the brain button "Open the memory" in the assistant panel's header (or Settings > Assistant > Memory > "Open the memory"): the notes are grouped by dossier and contacts; click one to read it, edit it, or restore an earlier version. Video: https://youtu.be/Wb0dfj7F0m4
  • Is there a video that shows it? Yes, the assistant's memory in the real app, from the first request to a new conversation that still knows: https://youtu.be/Wb0dfj7F0m4
  • What is the text limit of the assistant's memory? It says "memory is full". 6 MB of text on every plan, the last 20 saved versions of each note included: Settings > Assistant > Memory shows how much is used and warns from 80 %. When full, ask the assistant to condense its longest notes (shortening a note is accepted even when full; memory_list gives each note's size), or delete notes you no longer need from "Open the memory". If the memory is full of history (notes the specialists correct several times a day), "Prune old versions" in the same card removes the saved versions of every note and keeps their current text.
  • Can the assistant keep photos? Yes, inside its notes: drop an image on its panel on the desktop, or share photos to it from the phone ("Send to <name>"), and it files them in the right dossier. The room depends on your plan (Free 30 MB, Plus 150 MB, Pro 1 GB); Settings > Assistant > Memory shows what is used. A photo the assistant looks at is sent to your model provider, like a note.
  • Is the memory encrypted? Yes, at rest on the AgentsRoom servers, with a key per account. The notes the assistant reads still go to your model provider, like any conversation.
  • I restarted the app and the assistant forgot the conversation we were in the middle of. Fixed on 2026-09-20: a restart on a new day now offers the previous conversation in the Restore past agent card. Same day, it resumes silently.
  • Can the assistant send work to a team? Yes: "give this to the Dev and QA team of project X". It finds the team, writes the brief and asks you on a card Start a team run? (team, steps, project, brief). Approve and the run starts in that project; you never copy-paste the brief. It is told when the run stops.
  • Will it launch agents on its own? Only if "Can launch agents without confirmation" is on. Off (the default), each launch shows a confirmation card on the desktop.
  • Why does it open on the terminal the first time? With no transcript yet, the pane shows the CLI starting (folder trust, login, model). Once a conversation exists, the panel opens on the conversation view.
  • The panel hides the agent I am working with. Click that agent's terminal or screen: the panel closes and the conversation keeps running; the title bar button brings it back. To keep it visible beside your work, use "Detach into a window" at the right end of its tab strip.
  • The panel covers the dialog I am filling in. Click "Detach into a window" at the right end of the panel's tab strip: the conversation moves to its own window that you can put next to the form or on another screen. Close that window (or its "Reattach to main window" cross) to get the floating panel back.
  • Can the assistant run on another account than my agents? Yes: Settings > Assistant > Provider and model, the account row under the model (on the phone, the "Account" row of the Assistant card). "Default" follows your other agents; pick a profile to pin one. Changing the provider resets it.
  • Can the assistant use Codex Fast mode without my other agents? Yes: with Codex as its provider, Settings > Assistant > Provider and model > "Codex service tier" pins Standard, Fast or Ultrafast for the assistant only (also on the phone's Assistant card). It applies at its next start.
  • I changed the assistant's model but it still answers with the old one. Fixed on 2026-10-19: a change of provider, account, model, effort or launch options in Settings > Assistant (or from the phone) now restarts a running assistant, after its current turn. Same provider and account: same conversation; another provider or account: a fresh conversation. Its standing instructions apply from the next conversation.
  • Why does the title bar button not open the panel any more? Because the assistant is out in its own window: the button brings that window to the front. Reattach it to get the panel back.
  • Assistant specialists: sub-assistants (a running coach, a wealth advisor) with their own tab, instructions and dossier.

  • Voice Mode: the same voice and Voice Mode pane are used inside the assistant's panel and for the spoken announcement.

  • Voice Dictation: the phone's "talk" entry points start the composer's dictation.

  • Agent Delegation: how the assistant puts an agent on a task instead of coding itself.

  • Project Memory: the project and account memories your coding agents share. The assistant keeps its own, apart.

  • Restore Session: the Restore past agent card and which CLIs can resume a conversation.

  • Mobile Companion: the paired phone app and its encrypted link to the desktop.

  • AgentsRoom MCP: the tools the assistant uses to reach every project.

  • Multiple Accounts: the account profiles the assistant can be pinned to.