gooneyryan/scarf
1
0
Fork 0
mirror of https://github.com/awizemann/scarf.git synced 2026-05-08 02:14:37 +00:00
Code Issues Packages Projects Releases Wiki Activity
Page: Updating
Pages
ACP Subprocess Adding a Feature Module Adding a Service Architecture Overview Build and Run Chat Contributing Core Services Dashboard Data Model Design System First Run Gateway Cron Health Logs Hermes Paths Hermes Version Compatibility Home Insights and Activity Installation Keyboard Shortcuts Localization MCP Servers Plugins Webhooks Tools Memory and Skills Performance Monitoring Platform Differences Platforms Personalities QuickCommands Privacy Policy Project Templates Projects and Profiles Release Notes Index Release Process Roadmap ScarfCore Package ScarfGo Onboarding ScarfGo Roadmap ScarfGo Servers and Remote Sidebar and Navigation Slash Commands Support Template Catalog Template Ideas Test Harness Testing Transport Layer Troubleshooting Slow Chat Startup Uninstalling Updating Wiki Maintenance
Clone
3
Updating
Alan Wizemann edited this page 2026-04-27 13:00:18 +02:00
Table of Contents

Updating

ScarfGo updates differently. The iOS app updates through TestFlight (and, in future, the App Store) — Apple's standard update channel. The Sparkle flow described below is macOS only.

Scarf uses Sparkle to deliver automatic updates from a GitHub-Pages-hosted appcast at https://awizemann.github.io/scarf/appcast.xml. Each release is EdDSA-signed by the maintainer's private key; Scarf refuses any update whose signature doesn't verify against the embedded SUPublicEDKey.

Automatic updates

By default, Scarf checks for updates on launch and every 24 hours after that. When a new version is available, Sparkle pops up its standard dialog with the release notes and asks whether to install.

To disable automatic checks, open Settings → General → Updates. You can re-enable later from the same place.

Manual check

Two ways to force a check:

  • Settings → General → Updates → Check for Updates Now
  • Menu bar → Check for Updates

Beta / draft releases

Scarf does not ship beta channels — the appcast only carries the latest published release. Drafts pushed via ./scripts/release.sh <ver> --draft are uploaded to GitHub but not added to the appcast, so they don't reach existing installs until promoted manually.

Downgrading

There's no in-app downgrade. To run an older build:

  1. Quit Scarf.
  2. Move the current Scarf.app to the Trash.
  3. Download the older zip from Releases and drag it to /Applications.
  4. Disable automatic checks in Settings → General → Updates, otherwise Sparkle will offer to update you back.

App preferences live in ~/Library/Preferences/com.scarf.app.plist and are forward/backward compatible across versions in normal cases.

Update fails to apply

If Sparkle reports a signature mismatch or download error, see the Health view for details. Re-trigger the check; if it persists, file an issue with the Sparkle log content.

Last updated: 2026-04-25 — Scarf v2.5.0 (clarified macOS-only Sparkle vs ScarfGo TestFlight)

Getting Started

ScarfGo (iOS)

User Guide

Architecture

Developer Guide

Reference

Troubleshooting

Contributing

Release History

Legal & Support

Wiki edited via the local .wiki-worktree/ clone. See Wiki Maintenance for the workflow. Last sync: 2026-04-20.