client

A test build of what's coming after 1.3.1. It's a separate app, Tetiva Preview, with a gray icon. It installs next to Tetiva and keeps its own data in ~/.tetiva-preview, so your regular collections stay untouched. It starts empty and has no sign-in, sync or publishing, and it doesn't update itself. The app still reports version 1.3.1, the release it's built on.

What's new

• Path variables (#1): :name segments in the URL get a Path Variables table under Query Params, in sync with the URL. Values can use {{variables}}. Postman url.variable, Insomnia path parameters and OpenAPI in: path parameters are imported into the table, and cURL, Copy as and the Postman export keep them.
• Duplicate (#2) in a request's context menu makes <name> (copy) and opens it in a tab. The MCP server got duplicate_request, which can set the copy's name, method and URL in the same call.
• Image and HTML previews in the response. HTML preview runs without scripts and loads nothing from the network.
• The sidebar is sorted by name.
• Fixes: SF Mono instead of Courier in the URL bar and editors on macOS, clean shutdown of sync and the database, valid GraphQL SDL view, and a few smaller ones. Full list in CHANGELOG.md.

Downloads

• macOS (Apple Silicon and Intel, notarized): Tetiva-Preview-1.3.1-macos-universal.dmg
• Windows x64 and ARM64: Tetiva-Preview-1.3.1-windows-*-installer.exe. The installer isn't signed, so SmartScreen will ask before running it. It installs into %LOCALAPPDATA%\Programs\Tetiva Preview.
• Linux x64: Tetiva-Preview-1.3.1-linux-amd64.deb, package tetiva-preview.

AI agents over MCP now work with the open app: what an agent changes shows up right away, and a save in the app no longer wipes it.

Added

• set_active_environment lets an agent switch the active environment of a workspace, and the environment picker in the app follows. send_request says which environment it ran with under environment.
• update_request and update_collection say in their descriptions that a [redacted] value can be sent back as it is to keep the stored secret, and list what they kept under kept_secrets.

Changed

• What an MCP agent changes shows up in the open app right away: collections and requests it creates, edits, moves or deletes appear in the sidebar, inside an expanded collection too; an open tab or detached window shows its edits and closes when it deletes the request; environments it creates, deletes or makes active reach the environment picker.
• MCP errors and descriptions say what to do next: an id that is not a UUID, a version conflict (with the current version), send_request on a WebSocket request and a missing token each name the fix. Tool descriptions show how to write {{variables}}, the auth_data shape of each auth type, that delete_variable can't be undone and that an omitted workspace_id means the Default Workspace.

Fixed

• Saving a request tab no longer writes over a change made to the request in the meantime by an MCP agent or a teammate through sync. The tab takes their changes and keeps your unsaved edits to the rest; where both of you changed the same part of the request, theirs wins.

Before you upgrade

• Tetiva 1.2.1 and newer on macOS and Windows offer this update inside the app. From 1.2.0 and older, install it once from this page or tetiva.app/download.

Downloads

On Linux you can also install from the signed APT repository at apt.tetiva.app; see installation. The Windows installers and the Linux packages are not code-signed yet, so SmartScreen will warn on Windows.

Full list of changes: CHANGELOG.md

Compare two responses side by side, and bring collections over from Insomnia, Hoppscotch, OpenAPI and HAR.

Added

• Compare responses. Compare in the response status bar shows what changed since the previous send; its menu compares with any of the last ten sends or a saved example, side by side or in one column. Normalize JSON ignores key order and volatile values such as *_at and Date. In History, select two records to compare them. Secret headers show only whether they were sent.
• Import from other clients. Import File… in the sidebar reads Insomnia, Hoppscotch, OpenAPI / Swagger and HAR files as well as Postman ones. Before anything is saved, a preview shows what comes in, which hosts the requests call and what stays behind.
• gRPC over TLS. Start the address with grpcs:// or https://; the lock before the address switches the mode.
• GraphQL: Attach schema loads the schema from a .graphql file or a saved introspection JSON when the server does not answer introspection.
• Postman scripts more often run as they are: pm.expect and pm.response.to work as in Postman, and so do btoa, atob and pm.variables.
• The Auth tab of a sub-collection says Inherit instead of No Auth and shows which scheme it inherits and from which collection.
• The Russian interface (beta) now covers importing, environments, history, the collection overview and the script tabs.

Changed

• pm.response.status is now the reason phrase, "OK"; the number is in pm.response.code, as in Postman.
• A pre-request script that fails stops the send: the response pane says Request not sent and shows the error, its line, whose script it was and what it logged. The request used to go out without what the script would have added.

Fixed

• Cancel stops the request itself: the server sees the client go away, and the cancelled send leaves nothing in History.
• Search in a response or request body highlights every match and counts them, and Cmd+F (Ctrl+F on Windows and Linux) in a body opens its search.
• A file in a form is sent straight from disk, so a large upload no longer takes its size in memory.
• Credentials no longer end up in History replay drafts, in send error messages or in the script output that AI agents see over MCP.
• Pasting a cURL command into the URL bar keeps Inherit auth unless the command has credentials of its own.
• Cmd+Enter (Ctrl+Enter) sends without adding a blank line to the body, script or query.
• Windows open on the background of your theme instead of flashing navy, and on Windows a crashed page renderer recovers instead of leaving a blank window.

Before you upgrade

• gRPC over TLS: update Tetiva on every device that syncs these requests. Version 1.2.1 and older can't call an address with a scheme (too many colons in address).
• Scripts that compare pm.response.status with a number should use pm.response.code instead.
• Tetiva 1.2.1 on macOS and Windows offers this update inside the app. From 1.2.0 and older, install it once from this page or tetiva.app/download.

Downloads

On Linux you can also install from the signed APT repository at apt.tetiva.app; see installation. The Windows installers and the Linux packages are not code-signed yet, so SmartScreen will warn on Windows.

Full list of changes: CHANGELOG.md

Tetiva now updates itself. From this version on, new releases reach macOS and Windows without a trip to the website.

Added

• Updates inside the app (macOS and Windows). When a new version is out, Tetiva downloads it in the background, checks it against our ed25519 signature and its checksum, and offers Restart to update on a card at the bottom of the sidebar. The tabs you had open come back after the restart. Settings → Updates has a new Download updates automatically switch, on by default. On Linux the card shows the apt command instead.
• Postman collection variables come in with the collection as an environment named after it. Postman environment and globals files import from Import File… in the sidebar.
• pm.collectionVariables works in scripts: get, set and unset use the active environment.

Changed

• Windows installs Tetiva for the current user (%LOCALAPPDATA%\Programs\Tetiva) without an administrator prompt. A copy in Program Files is removed after one confirmation, and uninstalling no longer deletes the app's settings.
• The update check sends the app version and OS (latest.json?v=1.2.1&os=darwin), nothing else.

Fixed

• Changes made in a cloud workspace while sync was off now reach the server once sync starts.
• The selected environment stays selected after a change on another device or the first sign-in, and variables keep the same order on every device (needs server 0.20).
• Environment import keeps disabled variables disabled, accepts numbers and other non-text values, and no longer leaves a half-filled environment behind.
• The update dot and the sync warnings on the left rail no longer fade.

Before you upgrade

Versions up to 1.2.0 can't update themselves: install 1.2.1 from this page or tetiva.app/download once. Later versions arrive inside the app. On Windows the installer asks once for permission to remove the old copy in Program Files; if you decline, both copies stay, and the old one can be removed in Settings → Apps.

Downloads

On Linux you can also install from the signed APT repository at apt.tetiva.app; see installation. The Windows installers and the Linux packages are not code-signed yet, so SmartScreen will warn on Windows.

Full list of changes: CHANGELOG.md