Desktop App (macOS)
Teak Desktop gives you a native macOS app with automatic updates and the same real-time sync as web and mobile.
Requirements
Section titled “Requirements”- macOS 13.0 or newer
- Apple Silicon Mac (M1, M2, M3, or newer)
- Internet connection for sign-in and sync
Install
Section titled “Install”-
Download the latest macOS build from GitHub Releases.
-
Open the
.dmgfile. -
Drag Teak.app to Applications.
-
Launch Teak from Applications.
First Launch Security Checks
Section titled “First Launch Security Checks”Teak desktop releases are signed and notarized.
If Gatekeeper blocks launch:
-
Open System Settings → Privacy & Security.
-
Find the Teak block message and choose Open Anyway.
-
Relaunch Teak.
Sign In
Section titled “Sign In”Desktop sign-in opens a secure browser-based authentication window and returns you to the app automatically after login.
Teak Menu
Section titled “Teak Menu”The Teak menu in the macOS menu bar exposes these actions:
| Item | What it does |
|---|---|
| About Teak | Shows the installed version, copyright, and app icon |
| Check for Updates… | Manually checks for new versions and shows a notification while checking |
| Settings… | Opens the Settings panel (account info, API keys, billing) |
| Log Out | Signs you out and returns to the login screen |
Settings
Section titled “Settings”Open Teak menu → Settings… to manage your account:
- Account: View your email address and card count.
- Upgrade / Billing: Upgrade to Pro or open the customer portal to manage your subscription.
- API Keys: Generate API keys for the Teak API and Raycast extension.
- Appearance: Switch between Auto, Light, and Dark themes. Auto follows your macOS system appearance.
- Sign Out: Ends your desktop session and returns to the login screen.
- Delete Account: Opens
app.teakvault.com/settingsin your browser to complete account deletion.
Auto Updates
Section titled “Auto Updates”Teak checks for updates on each launch via GitHub Releases.
- If an update is available, you’ll see a prompt asking whether to download now or later.
- During download, a macOS notification and a percent badge on the Dock icon show progress.
- After download completes, you’ll see a prompt to restart now or later to install the update.
- If update checks fail (for example network outage), Teak continues running and retries on next launch.
Manual Update / Recovery
Section titled “Manual Update / Recovery”If you need to update manually or recover from a failed install:
-
Quit Teak.
-
Download the latest release from GitHub Releases.
-
Replace Teak.app in Applications.
-
Relaunch Teak.
Rollback
Section titled “Rollback”If a release is unstable:
-
Download the prior stable release from GitHub Releases.
-
Replace Teak.app in Applications with that version.
-
Relaunch Teak.
Your account data stays in Teak backend storage and local session state is preserved unless you sign out.
Troubleshooting
Section titled “Troubleshooting”App opens but cannot sign in
Section titled “App opens but cannot sign in”- Check network connectivity.
- Confirm your system clock is correct.
- Retry after a minute in case of temporary auth service issues.
Update does not apply
Section titled “Update does not apply”- Relaunch the app and wait for update check.
- Confirm GitHub Releases is reachable from your network.
- If you are on a Tauri-based build (prior to the Electron migration), install the latest release manually from GitHub to switch to the new Electron updater.
Still stuck?
Section titled “Still stuck?”Reach out via Support.