Auto-Updates
Kangentic checks for updates automatically so you’re always on the latest version.
How Updates Work
Section titled “How Updates Work”The app checks for new versions every four hours via electron-updater, which looks at published GitHub Releases. When an update is available, behavior depends on your platform:
| Platform | Update Mechanism | User Action |
|---|---|---|
| Windows | electron-updater (NSIS) | None — downloads in background, installs on next restart |
| macOS | electron-updater | Click “Restart to update” when prompted |
| Linux | None (no built-in auto-update) | Re-run npx kangentic or download from GitHub Releases |
Installing a Specific Version
Section titled “Installing a Specific Version”To install a specific version:
npx kangentic@0.2.0The launcher version matches the app version. This downloads the exact matching release.
Rollback
Section titled “Rollback”To roll back to a previous version, run npx kangentic@X.Y.Z with the desired version number. On Windows, the NSIS installer replaces the current version. On macOS, the .app is replaced in ~/Applications/.
Troubleshooting
Section titled “Troubleshooting”Update Not Appearing
Section titled “Update Not Appearing”- Verify the release is published (not a draft) on GitHub
- The app checks every four hours — restart the app to trigger an immediate check
- On macOS, check System Settings → General → Software Update for pending restarts
Clearing Update Cache
Section titled “Clearing Update Cache”Delete %LOCALAPPDATA%\Kangentic\packages\ and restart the app.
Delete ~/Library/Caches/Kangentic/ and restart the app.