Updates

Kumo has a built-in update checker. New versions are detected automatically, and a notification appears when an update is ready. Installation takes one click.

How it works

• Kumo asks GitHub Releases every five minutes whether a newer version exists.
• If there is one, a macOS notification appears with three actions:
  • Install Now — downloads the new version in the background.
  • Remind Me Later — try again in a few hours.
  • Restart Now — appears after the download is finished.
• Kumo verifies the downloaded file, then runs a small installer that replaces Kumo.app and re-launches.

Manual checks are available from Settings → Updates → Check for Updates.

Stable vs beta channel

By default Kumo follows the Stable channel — only finished releases. To test the next version before it ships, switch to the Beta channel from Settings → Updates.

This can be changed back to Stable at any time. Kumo keeps the data even when downgrading from beta to an older stable release.

When auto-update fails

The most common reason: Kumo is not installed in /Applications. Some users keep it in ~/Applications, in a Setapp folder, or on an external disk. In those cases macOS protects the surrounding folder from being written to, and the auto-installer reports an error.

Fix it by:

1. Quitting Kumo.
2. Moving Kumo.app into /Applications (regular /Applications, not ~/Applications).
3. Re-launching and re-running the update.

If that does not resolve it, download the DMG manually from the release page and install over the top. Settings and subscriptions are preserved.

What's next

• See what changed: release notes on GitHub.
• For implementation details, see Auto-update internals in the Advanced track.