Updating and Uninstalling
AITerm's direct download channel uses Sparkle for app updates. You can also reinstall manually from the latest DMG.
Update with Sparkle
Use Check for Updates… in Settings ▸ Terminal ▸ Software Update, which also shows your current version and two toggles:
- Check for updates automatically — on by default: an hourly background check, surfaced as a gentle "Update ready" badge in the status bar. If you ever declined the old system dialog that asked about automatic checks, AITerm turns checking back on once so this toggle is in charge from then on; switch it off here any time and that choice sticks.
- Automatically install updates — off by default: instead of installing on its own, AITerm shows the badge and lets you install when you choose.
Homebrew users can update with:
brew upgrade --cask ai-term
If that stops with "Refusing to load cask ai-term from untrusted tap", run brew trust vega-llc/aiterm once and try again. Homebrew 6 requires taps outside its own core to be trusted before it will load them, and the requirement applies to upgrades as well as first installs.
A newly released version does not change the copy already installed on your Mac until you actually update — so if you just saw an announcement but still see the old version, that's expected; run the updater or the Homebrew command above.
Manual reinstall
To reinstall manually:
- Download the latest DMG from ai-term.com.
- Quit AITerm.
- Open the DMG.
- Drag AITerm into Applications, replacing the old copy.
- Launch AITerm.
An installed app does not change just because a new DMG exists online. You still need Sparkle, Homebrew, or a manual reinstall.
Uninstall
To remove the app, quit AITerm and move it from Applications to Trash.
AITerm stores app data under the app data directory used by AppDataDirectory. That directory contains configuration, history, audit logs, runbooks, workspace data, and local sidecar files. The exact location can change through migration code, so use the app's Reveal actions where available before deleting data manually.
Provider secrets are stored in the macOS Keychain. Removing the app bundle does not necessarily remove Keychain items.
Related pages: Troubleshooting and FAQ.