RunHuddleFind the current release
Use the RunHuddle releases page for available builds and their release notes, including previews. The website deliberately does not pin a versioned download link.
These guides describe the 0.36.1 workspace. If the public download or your installed version is older, some controls will differ. Check the release notes for the build you are installing.
Update in the app
Choose Check for Updates… from RunHuddle’s menu. Automatic update checks can be configured in Settings; installation remains your choice. Release updates use the signed Sparkle feed, and release installers use Developer ID signing and Apple notarization.
Updates preserve running terminals and reconnect them after relaunch. Saved notes and session metadata remain in place. A provider process may still need restarting after a tracking-hook change; check Connections if tracking is stale.
Update manually
Download the desired DMG from releases. Quit RunHuddle through its menu rather than only closing the window. Replace the app in the same Applications folder and reopen it. Avoid leaving multiple installed copies or switching between an installed build and a development copy.
Source builds and public releases can differ. Do not assume a screenshot of the development build means every shown feature is in the current downloadable release.
Uninstall
- Disable opening at login if enabled.
- Quit and choose to end sessions if you want RunHuddle-owned terminals stopped.
- Remove the installed RunHuddle app from Applications.
- If removing tracking, remove only RunHuddle’s Copilot hook file and Claude hook entries. Preserve unrelated agent settings.
The Copilot hook file is normally ~/.copilot/hooks/agent-session-manager.json. Claude hooks are entries invoking RunHuddle’s claude_bridge.py in ~/.claude/settings.json, or the configured Claude directory. Do not delete the entire settings file.
RunHuddle consolidates local notes, metadata, caches and attachments in ~/Library/Application Support/RunHuddle/. Existing data migrates automatically when the updated app starts. Fully quit the older app before starting the updated build. Only remove that directory if you intend to erase that local data; export or back up important notes first. Uninstalling RunHuddle itself does not delete provider conversations.