Tetiva ships as two artifacts: a DMG for macOS and an installer for Windows, both on the download page and free. No account is required to install or use it — the client works locally out of the box. There is no Linux build yet.
macOS#
Requirements: macOS 11 or newer. The build is universal — one file for Apple Silicon and Intel, roughly 29 MB.
- Download
Tetiva-X.Y.Z-macos-universal.dmg. - Open the image and drag Tetiva into Applications.
- Launch it from Launchpad or Spotlight.
The DMG is signed with a Developer ID certificate and notarized by Apple, so Gatekeeper opens it without a warning and without terminal workarounds. If you do get a warning, the file is most likely damaged or came from somewhere else — download it again from the download page and check Troubleshooting.
Windows#
Requirements: Windows 10 or 11. Two installers are published: x64, roughly 15 MB, and ARM64. If WebView2 is missing, the installer pulls it in.
- Download the installer for your architecture (x64 on most machines).
- Run it and step through the wizard.
The installer is not code-signed yet, so SmartScreen shows its blue "Windows protected your PC" dialog. Click More info → Run anyway. This stays true until the build gets a signing certificate; the download page says so as well.
First launch#
The first start opens a welcome screen with two options: Work locally and Connect an account. Neither choice locks you in — sync can be turned on later, and local work has no limits. A four-screen tour sits next to the choice; both the tour and the welcome screen can be reopened from settings with Show welcome.
Data goes into a single SQLite file, ~/.tetiva/data.db: collections, environments, cookies, history and settings. Point the app somewhere else with the TETIVA_DATA_DIR environment variable. Uninstalling the app leaves that directory alone.
With the app installed, go through the quick start — or, if you are coming from Postman, import your collections first.
Updates#
The client does not update itself; it tells you a new version exists. It checks at most once every 10 days and puts a dot on the settings icon. The Check for updates automatically toggle and the Check now button live in the Updates section of settings — with the toggle off, the app makes no update requests at all.
To upgrade, grab the current build from the download page and install it the same way you did the first time: drag it over the old copy on macOS, run the new installer on Windows. The database in ~/.tetiva is untouched, so collections and environments survive the upgrade.
Linux#
There is no Linux build — the download page lists it as future work. No package, repository or AppImage exists today, so treat any third-party Linux build of Tetiva as not ours.