Updates and channels

Channels

A build knows its channel at compile time: Stable, Nightly or Dev. Stable and Nightly each read their own manifest at https://dl.sirioai.app/. Stable checks at launch and then once a day, Nightly at launch and then every hour. Dev builds never check for updates.

What an update check does

1. Read the channel manifest.
2. If the manifest lists a newer version, download its artifact for this platform. Stable downloads it in the background; Nightly downloads it when you choose to update.
3. Recompute the SHA-256 and verify the Ed25519 signature against the keys compiled into the app. Sirio refuses to apply a build that fails verification.
4. Apply per platform: swap the app bundle on macOS, rename over the AppImage on Linux, run the installer silently on Windows. Restart to update relaunches Sirio into the new version on every platform. On macOS and Linux, Install without restarting lets the running Sirio carry on until you next start it. Sirio refuses to apply when it cannot locate its own install, such as a copied binary or a build run from source, and points you to the download page instead.

The update card

When a new version is available, at launch or when a check finds one while you work, a card in the bottom-right corner offers it. A card that appears while you work never takes the keyboard.

• Restart to update downloads, verifies and installs the version, then relaunches Sirio into it. On Windows the button reads “Update and restart”, because the installer closes Sirio.
• Install without restarting appears on macOS and Linux when agents are at work. The new version waits for the next launch, and the card warns that a restart would stop them.
• Later hides the card for that version until the next launch.

After Install without restarting, the card says the new version is installed and waits for a restart, with Later and Restart now.

While a download or an install runs, you can close the card. The status bar’s indicator says “Updating…” and brings the card back. A failed update shows its reason and offers Retry when a retry can help.

The indicator

Settings → General shows the Version, the Channel and the Update status under About: when Sirio last checked, and what it found. Under Updates, the Automatic updates switch turns checking and downloading on or off.

When a newer version is available or ready, a quiet indicator reading “Update available” appears in the status bar. While an update runs it reads “Updating…”, once an update waits for a restart it reads “Restart to update”, and after a failure it reads “Update failed”. Clicking it brings back the update card. Settings → General names the version too, shows its release notes when the manifest carries them, and offers its own button to install it: “Update and keep working” on macOS and Linux, “Update and restart Sirio” on Windows. A Nightly build shows “Nightly builds track main” in place of release notes.