Notifications

Know When Agents Finish

Running multiple Claude sessions means output happens in terminals you are not watching. AgentsRoom marks unread agents, sends native notifications on completion, and shows badge counts so nothing gets missed.

Screenshots

Real captures of the app, added as this feature evolves.

  • An agent restarted on a blank conversation, with no leftover fast reply above its input box
    A restarted agent starts clean: earlier fast replies stay in the list.
  • Notification settings with the Lean session file option
    Stop agents from rewriting their session file every turn when you do not need the per-turn summary.
1 / 2
AgentsRoom sidebar showing unread indicators with green-tinted rows, badge counts per project, and WhatsApp-style last message previews

Sidebar with unread counts per project, green-tinted unread rows, and last message preview on hover.

How Notifications Work

From in-app unread indicators to native OS alerts and mobile push.

Unread Count Badges

Each project in the sidebar shows a badge with the number of agents that produced output since you last viewed them. At a glance, you see which projects need attention.

Last Message Preview

Hover over a project to see a WhatsApp-style preview: the agent name followed by the last line of output. Useful for deciding which agent to check first without switching tabs.

Native Desktop Notifications

When an agent completes its work and you are not viewing that terminal, AgentsRoom sends a native desktop notification. Click it to navigate directly to that agent.

Dock Badge Count

The AgentsRoom dock icon shows the total unread count across all projects. Even when the app is in the background, you can see how many agents produced new output.

Mobile Push Notifications

Push notifications reach your iOS or Android device unless you are really at the desktop: the window in front and recent keyboard or mouse activity. The phone itself can override that and choose to be notified always, or never. Each push carries the avatar of the agent that spoke, and a 5-second deduplication window prevents repeated alerts from the same agent.

Choose Which Agents Reach Your Phone

Set each agent, each project or your whole account to All, Summary, Only when it needs you, or Off, from the desktop or straight from the phone. Run a busy pipeline, mute it, and keep hearing from the one agent that coordinates it.

Agents Can Message Your Phone

An agent working without you, such as a scheduled run that keeps your board moving, can send a push with its own words when it needs a decision. The notification is titled with the agent and the project, and it still arrives when that agent is set to Summary or Only when it needs you.

Focus Mode and Quiet Hours

Keep personal and work projects apart. A folder of projects can go silent while Focus mode is on, during its own quiet hours, or for good. Turn Focus mode on in one click or on a schedule. Its agents keep working: only the phone push, banner, sound and dock bounce wait, and an agent's question can still get through.

Rolling out on iOS and Android

The agent avatar in your notification center

A push used to arrive with the app icon on it. Every agent produced the same grey line, and finding out which one had finished meant unlocking the phone and opening the app.

Each push now carries the identity of the agent that spoke: its avatar as the sender photo, its name as the title, the project underneath. On iOS the notification is rendered as a message from a contact, and several pushes from the same agent stack into one thread instead of scrolling past each other. On Android the same avatar becomes the notification icon.

What decides whether a push leaves at all has not changed. It only goes out when you are not really at the desktop, meaning the window in front and recent keyboard or mouse activity, and the phone can override that in either direction: always, or never. Notifications that belong to a project or an account rather than an agent keep the app icon.

iOS notification center showing two AgentsRoom push notifications, each with the agent avatar as the sender photo: Running Performance Coach reporting that the agent has completed its work, and Mobile DevOps reporting a process completed and waiting for a follow-up commit
Two agents finishing on the same phone. The avatar says which one before you unlock.

The desktop side ships in AgentsRoom 1.164.0. The matching mobile build is in review at the App Store and Google Play, so the avatars appear on your phone as soon as the update lands.

Fast replies

Ask a quick question, get a short answer

Some questions are not worth scrolling the terminal for: how much time is left, did the tests pass, which branch are you on. The agent answers them with a fast reply, one or two sentences, instead of burying the answer in the middle of its output.

The answer shows up in a bubble on the agent, and your recent fast replies stay in a feed you open from that bubble. Depending on your setting, it also reaches your phone as a push, lands in the Mail tab of your developer inbox, or both.

Fast replies are on by default. You can turn them off for the whole account, for one project or for a single agent. When you want the answer to come back short for sure, press the button left of Send: the agent then answers that message with a fast reply.

While a Live Activity shows the room on your iPhone, it replaces the per-agent pushes for a finished turn or a waiting question, so the same event does not reach you twice. The Android live notification stays silent, so those pushes keep arriving there.

Live agents on your phone

From Output to Alert

Four steps between an agent producing output and you seeing it.

1

Agent produces output

While you are viewing a different agent's terminal, another agent writes new output. AgentsRoom detects this activity in the background.

2

Session marked unread

The agent row gets a green-tinted background and bold text. The project's sidebar badge increments. The dock icon updates its total count.

3

Notification sent

A native desktop notification fires with the agent name and project. Unless you are really at the desktop, or you turned that agent's phone notifications off, a push notification goes to your phone as well.

4

Unread cleared on view

Open the agent's terminal and the unread flag clears automatically. The badge count decrements. No manual dismiss required.

When does a session get marked as unread?
When an agent produces new terminal output and you are not currently viewing that agent's terminal. If you are already looking at the agent, nothing is marked unread.
Do mobile push notifications work without an account?
They work best with an account, which routes notifications through the server API. Without an account, AgentsRoom falls back to a local Expo push token if available.
Can I disable notifications?
Yes. Desktop notifications use your operating system's own notification permissions: System Settings on macOS, System > Notifications on Windows, your desktop environment's notification settings on Linux. Mobile push notifications can be toggled off in the app or in your device settings.
How does deduplication work for mobile push?
AgentsRoom waits 5 seconds after the first push-eligible event before sending. If the same agent produces more output within that window, it is grouped into a single notification instead of sending multiple alerts.
Does a push notification show which agent finished?
Yes. The push carries the agent avatar as the sender photo, the agent name as the title and the project below it, so the lock screen is enough to tell two agents apart. Notifications tied to a project or an account rather than an agent keep the app icon. The mobile build carrying this is in store review.
Can I get one summary instead of a push for every agent?
Yes. Set your agents to Summary: their questions and the messages they send you still arrive right away, and everything else is grouped into one push every 5, 10, 15, 30 or 60 minutes (15 by default). While agents on Summary are still busy, a short "still working" update goes out too. Tapping a summary opens that agent, or the Activity tab when it covers several.
Can I hear only from my project assistant?
Yes. Set your agents to Off, or to Only when it needs you, and give the project assistant its own level, for example All. That rule sits above the account and project levels, and an agent you set by hand keeps its own choice. You can change these rules in Settings > Mobile on the desktop or in the notification settings of the mobile app.
Can I stop personal projects from notifying me at work?
Yes. Put them in a folder, set the folder's Notifications to Focus mode, then turn Focus mode on from the projects home or schedule it for your office hours (for example weekdays 9:00 to 18:00), on the desktop or from the phone. Their agents keep running and everything is waiting in the app when you come back. A folder or a project can also have its own quiet hours, or be muted.

A build, a test suite or a Docker image can run for several minutes. You switch to something else, and the terminal sits there finished for ten minutes before you notice. Arm the bell on a terminal tab and AgentsRoom tells you the second the command is done, with the command name and how long it ran.

Get notified when a long command finishes

Not only when an agent finishes. The same channels, desktop banner and phone push, also carry a usage alert when a Claude, Codex, Grok, GitHub Copilot CLI, Kimi, Cursor, Antigravity, OpenCode Go, Z.AI Coding Plan, Command Code or Muse Code quota bar crosses a threshold you chose.

Usage alerts

Want your own scripts, not only your agents, to buzz your phone? A deploy, a backup or a CI job can send a push with one cURL call.

Push Notification API

Stop Checking Terminals Manually

Download AgentsRoom and let notifications tell you when agents finish. Desktop and mobile, with unread indicators built in.

Download AgentsRoomFree

Companion app: monitor your agents on the go

Bring your own: Claude, Codex, Antigravity CLI, or other AI provider.

Push bugs and requests straight to your public backlog.