Auto-update

  • Desktop app
  • All plans

What it does

The desktop app checks for a new version on its own, downloads it in the background and installs it the next time you quit AgentsRoom. A small indicator in the footer shows the state: Checking for updates…, Downloading update… 42%, v1.2.3 is ready, and, when the app has failed to update several times in a row, a labelled Update blocked chip with the raw reason so the machine is no longer the last to know. The phone can also trigger a desktop update remotely.

The app keeps checking every hour while it stays open, even once an update is downloaded: when a newer release comes out, it replaces the one waiting, so the update you restart into is the latest one. Clicking restart also checks one last time: if an even newer release is out, AgentsRoom downloads it first, then restarts on its own, so your agents relaunch only once.

On Windows, an update left pending after a shutdown can also be recovered at the next launch, after the updater validates it again. Recovery only restarts an idle app in a writable installation, with one automatic attempt per version. It never runs after a crash or a forced close: the update then waits for your next quit, like any other. The footer also receives the latest update state when its interface finishes loading.

Going back to a previous version

If a new version causes problems, you can return to one of the 5 previous versions. Click the version number in the footer, then Go back to a previous version, pick a version and confirm Restart on vX: AgentsRoom downloads it, restarts on it and restores your agents. When the app crashes, the crash screen offers the same thing with one button, Go back to vX, for the version just before yours.

The version you left does not reinstall itself: updates are skipped until a newer version comes out, which then installs normally because it may hold the fix. To get the skipped version anyway, use Resume updates in the same window. If the automatic install does not go through, a button downloads the installer so you can run it yourself. The versions offered start at 1.248.0, the first one that knows how to stay on the version you chose, so the list fills up with the next releases.

Automatic updates (install without you)

By default a downloaded update waits for you to restart. Settings > Global settings > Automatic updates lets AgentsRoom install it by itself:

  • Off (default): nothing changes, the update waits for a restart.
  • Every day at a set time: the update is installed at the chosen time (local time of the desktop). If agents are still working, AgentsRoom waits for them to finish, up to 6 hours after that time, then waits for the next day. Tick Restart even if agents are working to restart at the exact time: agents in progress are stopped and restored after the restart.
  • As soon as no agent is working: the update is installed once it is downloaded and no agent has worked for 3 minutes.

Whoever is at the keyboard is never surprised. A card shows for one minute before the restart, in every window: AgentsRoom restarts in 60 s, with Restart now and Later. Later refuses this restart: the update then installs when you quit, or the next day's time or the next release asks again. Nobody there, as on an unattended machine: the restart goes ahead when the minute is up. And it never happens over unsaved changes: while a file open in AgentsRoom has unsaved changes the update waits, even with Restart even if agents are working ticked, and the footer tooltip says so. It installs at the next check once the file is saved.

When it installs, your phone gets a push AgentsRoom is updating before the restart, then AgentsRoom is back once the app runs again (or Update not installed if the install failed and the app came back on the same version). The restart takes the same path as clicking restart: it lands on the newest release, and the session restore brings your agents back (see Restore Session). Made for an unattended machine (a Mac mini running night agents).

Where to find it

  • Footer, right side: the Update indicator next to the Version number (click the version to read the changelog).
  • Mobile app: Settings > Check desktop update. Right under it, Restart desktop quits and reopens the desktop app from the phone without installing anything (see Remote Agent Control).
  • Settings > Global settings > Automatic updates (desktop), or Settings > Automatic updates on the phone, in the Desktop section.
  • Settings > Beta joins the beta programme, which receives features still being tested.

How to use it

  1. Nothing to do: the check runs at launch and periodically while the app is open.
  2. When Update ready appears, click its icon: a small menu offers Install and restart (AgentsRoom reopens on the new version and your agents come back) or Install and close (AgentsRoom closes, installs the update and stays closed). You can also simply quit: the update installs on its own at the next quit, and closing the main window quits too. If a file or a sketch has unsaved changes, AgentsRoom asks first; Install and close also asks when agents are working, since they do not come back until you reopen the app. After either choice, the indicator may briefly show Checking for updates…, or a download, with "AgentsRoom restarts by itself as soon as the latest version is ready." (or "closes by itself" for Install and close): a newer release came out, and the app fetches it first. If the check fails (offline), the update already downloaded is installed as before.
  3. From the phone: when the paired desktop has downloaded an update, the home screen shows a Desktop update available card ("AgentsRoom v1.2.3 is downloaded on <desktop> and installs on the next restart.") with Update now and Not now, and Settings > Check desktop update shows v1.2.3 available. Before restarting, the phone asks for confirmation, says how many agents are working right now ("Agents working right now: 2. The restart will interrupt what they are doing.") and warns when a file or a sketch has unsaved changes on the desktop. Not now hides the card until the next release or the next app launch; the Settings row stays available. Without a known download, Settings > Check desktop update checks first, then installs (confirmation only when agents are working or changes are unsaved). The desktop shows a Remote update dialog through the phases (Checking, Downloading, ready to install, restarting); the phone is briefly disconnected while the desktop relaunches.
  4. Update available / Update required window: when AgentsRoom tells you a new version is out, this window follows the in-app updater instead of sending you to the website. While the update downloads it shows a progress bar with "Downloading in the background, you can keep working." and a greyed Downloading… 42% button; once downloaded, the button becomes Reboot to install v1.2.3, with a reminder that terminals, dev servers and SSH tabs close on restart, next to Close and update. Download update (a link to agentsroom.dev) only remains when the updater cannot do the job itself (an error, or an install type the release does not serve). An Update required window has no Later button: you must update to continue.
  5. If Update blocked shows, hover it to read the reason and click to retry the check.

Settings

  • autoUpdateMode (global, Settings > Global settings > Automatic updates): { mode: "off" | "scheduled" | "idle", time: "HH:MM", forceAtTime: boolean }, default { mode: "off", time: "04:00", forceAtTime: false }. Synced with the account: every desktop of the account follows it, and the phone edits it too.

  • betaFeatureOptOut (global, Settings > Beta): beta-programme features this account switched off for itself.

  • uiElements.footer.update / uiElements.footer.version (global, Settings > Interface elements): hide the indicator or the version number.

Agent tools (MCP)

settings_set with key autoUpdateMode switches the automatic update mode.

Providers

Not related to agent CLIs. Updating the CLIs themselves is a separate notice: see CLI Update Notice.

Mobile

The phone updates through the App Store and Google Play. For the desktop, the phone shows Desktop update available on its home screen as soon as the paired desktop has downloaded a release, with an Update now button that warns about working agents and unsaved changes, then installs and restarts the desktop through the same path as its own restart button. Settings > Check desktop update on the phone drives the desktop updater and shows its result, including the raw error message when it fails. The card appears within an hour of a release: the desktop checks at launch and then every hour.

Limits

  • Normally the update installs on a real quit. Users who never quit keep running the old version with an update waiting; Windows can also recover an earlier pending update at launch under the conditions below.
  • macOS: an app launched from the downloaded disk image or a translocated (quarantined) location cannot replace itself; drag AgentsRoom into /Applications first.
  • Windows: quitting installs the update in the background, in under a minute, and the shortcut keeps working throughout. If you click it during those seconds, nothing opens right away: AgentsRoom opens by itself when the install is done, on the new version. In the second or so while the program file itself is rewritten, Windows may show its own error; click again.
  • Windows: clicking restart installs silently (no installer wizard) and reopens the app. During a Windows shutdown, installation is deferred because the OS may terminate the installer. At the next launch, recovery requires the same update still offered by the current channel, no active terminals and a writable install folder. Installs requiring administrator approval keep the normal update action. An installer quarantined by an antivirus may still prevent installation, but recovery will not repeatedly restart the app for the same version; see Windows and Linux.
  • Linux: an AppImage updates itself and reopens on the new version a few seconds after the old one has quit, including when it runs through appimage-run (NixOS) or another sandbox that closes with its parent (the new version is started through systemd-run --user when it is available); a .deb or .rpm install updates through its package and may ask for your system password when installing. If a release does not ship the package your install needs, the app says so and points you to agentsroom.dev instead of retrying forever.
  • macOS 12 (Monterey) or later is required since the move to Electron 43 (2026-10-12). A Mac still on macOS 11 (Big Sur) is not offered the update: it keeps its working version instead of downloading one that would not start. Update macOS to get new versions.
  • macOS: a disk cleaner that empties ~/Library/Caches (CleanMyMac, a cleanup script) also deletes a downloaded update. Since 2026-10-31 AgentsRoom checks the update is still on disk before closing anything: if it is gone, it downloads it again once and then restarts by itself; if it is still missing, the restart is cancelled with an error and the app stays open. If the install fails after the windows have closed, the app reopens on its current version instead of staying closed.
  • macOS: an Intel Mac needs an Intel build in the release; when it is missing, the app says so and points you to agentsroom.dev.
  • The Update blocked chip appears after two consecutive failures (about an hour of checks) and is shown even if the update indicator is hidden.
  • When data sharing is on, only a closed-vocabulary failure code is reported (network, disk full, permissions, signature...), never a path or a message.

Common questions

  • Can I install AgentsRoom with Homebrew or winget? On macOS, yes since 2026-10-23: brew install --cask agentsroomdev/tap/agentsroom installs the same signed app as the download page. The app then updates itself exactly as described here; brew upgrade leaves it alone (the recipe declares that the app updates itself), and the recipe follows each release within a few hours. On Windows, winget install AgentsRoom.AgentsRoom works once Microsoft has accepted the package (submitted on 2026-10-23); the download page shows the command only from then on.

  • Windows says the shortcut no longer points to the program, or the app closes right after I reopen it. The first one came from versions before 1.226, whose update removed the program while installing: wait a minute and click again, it does not come back once you are past that version. The second came from reopening the app during an update, which closed it again; since 2026-11-03 it waits for the install and opens by itself. If the app closes by itself at any other time, the next launch reports how it ended (when data sharing is on), so tell us roughly when it happened.

  • Can AgentsRoom update itself without me, for example at night? Yes: Settings > Global settings > Automatic updates, pick "Every day at a set time" or "As soon as no agent is working". The phone is notified before the restart and when the app is back.

  • After an automatic update on Linux, AgentsRoom stayed closed. Fixed on 2026-10-28: the AppImage started the new version while the old one was still quitting, and the new one gave up at once (or was closed with the old one under appimage-run). It now waits for the old instance to quit, outside its process tree.

  • I clicked Update now on my phone, the Mac app closed and never came back (and was not up to date when I reopened it). Fixed on 2026-10-31: a disk cleaner had deleted the downloaded update, and the install failed after the app had already closed its windows. The app now checks the update before restarting, downloads it again if it is gone, and reopens itself if the install still fails.

  • The automatic update restarted the app again in the morning. Fixed on 2026-10-28: a daily slot used to be forgotten by the restart it caused, so a release downloaded later in the same 6-hour window restarted the app a second time. A slot is now served only once, restarts included.

  • AgentsRoom restarted by itself while I was editing a file, and my changes were gone. Fixed on 2026-11-04. An automatic restart now waits as long as a file has unsaved changes and shows a one-minute notice with a Later button. And unsaved changes in the file editor are kept on disk as you type, so they survive any restart, crash or quit: at the next launch a card lists them, and opening the file brings them back (see File Preview).

  • How do I stop AgentsRoom from restarting on its own? Settings > Global settings > Automatic updates > Off: the update then waits until you quit or click restart. To refuse one restart only, click Later on the notice.

  • Will an automatic update kill my running agents? Not by default: at the set time it waits until no agent is working (up to 6 hours). Only "Restart even if agents are working" restarts at once, and those agents are restored after the restart.

  • I am several versions behind and never saw an update. Quit the app fully (not just the window) so the pending update installs; if Update blocked shows, read its reason.

  • Update blocked showed up right after a new release, then went away. Fixed on 2026-10-09: a single failed check was counted twice, so one network miss was enough to show the chip. It now needs two failed attempts in a row, and only a check that finds the app up to date or an update ready resets the count.

  • Can I check manually? Click the update indicator to retry, or from the phone with Check desktop update.

  • Can I install an update without AgentsRoom reopening? Yes: click the Update ready icon in the footer and choose Install and close, or click Close and update in the update window. The app takes the newest release, closes and stays closed. Your session comes back the next time you open it, unless restore on exit is set to never. Quitting normally does the same with the download already on disk, without looking for a newer release. The phone keeps Update now, which reopens the desktop: a closed desktop cannot be reopened from the phone.

  • Can I update my desktop from my phone? Yes. When the desktop has an update downloaded, the phone's home screen shows Desktop update available with Update now. The phone first tells you how many agents are working (the restart interrupts them, then restores them), then installs and restarts the desktop. No card? The desktop has not downloaded the release yet (it checks every hour): use Settings > Check desktop update.

  • The update window used to send me to the website, now it shows a progress bar. Since 2026-09-25 it follows the download already running in the background and then offers Reboot to install. No need to download an installer by hand.

  • My Mac on macOS 11 Big Sur no longer gets updates. AgentsRoom now runs on Electron 43, which needs macOS 12 or later. The installed version keeps working; update macOS to receive new versions.

  • The update offered was older than the latest release, and I had to restart twice. Fixed on 2026-10-19: the hourly check used to stop once an update was downloaded, so an app left open for days kept offering the first release it had fetched. It now keeps checking, replaces a stale download with the newest release, and the restart click checks one last time before restarting.

  • Where is the changelog? Click the version number in the footer. Since 2026-11-07 that window shows the same changelog as the site: a Shipping record block (releases, changes shipped, releases per day, user reports shipped, features, bug fixes, UI improvements, with Open the public backlog), a Search every release field that searches the whole history ("No release matches this search." when nothing fits), each release split into Feature, UI and Bug fix lines with Show screenshot where a capture exists, and older releases loaded as you scroll down. On the phone, Settings > About > Changelog opens the site's changelog page in your browser.

  • Are the release notes translated into my language? Yes, since 2026-10-31: each release's notes are translated when it is published, into every language of the app and of the site, and the changelog window and the site's changelog page show them in your language. A release whose translation is missing or out of date is shown in English (the original), and the line "Release notes are written in English." appears only when none of the notes shown is translated. The custom message of the update window, typed at release time, stays in English.

  • Can I watch a video of a new feature from the changelog? Yes: a changelog line that added a tutorial video to the app ends with Watch the tutorial, which opens that video on YouTube (in the app's changelog window and on the site's changelog page).

  • AgentsRoom closed unexpectedly and installed an update when I reopened it, with automatic updates off. Fixed on 2026-10-27: after a crash or a forced close, the app no longer installs the waiting update at launch. It installs when you quit, as "Off" promises.

  • Can I go back to an earlier version? Yes, one of the 5 previous versions, from the version number in the footer (Go back to a previous version) or from the crash screen (Go back to vX). The app restarts on it and restores your agents. It stays there until a version newer than the one you left comes out.

  • I went back to an older version. Will it update itself right back? No. The version you left is skipped; the next release installs normally. Resume updates, in the same window, lifts the skip. The update button in chat answers "up to date" in the meantime.

  • The list of previous versions is empty. It only offers versions from 1.248.0 on, and needs a connection to the site.

  • How do I get features earlier? Join the beta programme in Settings > Beta; see Beta Programme.