Tetiva — десктопный клиент для API: HTTP, gRPC, GraphQL и WebSocket в одном окне. Коллекции, окружения, cookies и история запросов лежат в SQLite на вашем компьютере, аккаунт нужен только для синхронизации и публикации, телеметрию приложение не собирает. В документации описано то, что клиент умеет сегодня: установка, первый запрос, четыре протокола, скрипты и тесты, импорт из Postman, Insomnia, Hoppscotch, OpenAPI и HAR, синхронизация, публикация коллекций и MCP-сервер для агентов.
С чего начать
- Установка — DMG для macOS, инсталлятор для Windows,
.debдля Ubuntu и Debian, системные требования. - Быстрый старт — первый запрос за две минуты.
- Переход с Postman — экспорт v2.1, что переносится, а что придётся переписать руками.
Как устроен клиент
Данные лежат локально. База — файл ~/.tetiva/data.db. Коллекции, окружения и история доступны офлайн, без входа и без сервера.
Сеть — только по вашей команде. Клиент обращается наружу в восьми случаях: вы отправили запрос; вы открыли сохранённый GraphQL- или gRPC-запрос, который читает схему с сервера — интроспекцией у GraphQL, рефлексией у gRPC, а локальный файл схемы или .proto читается с диска; включена проверка обновлений, а с ней и скачивание новой версии (два переключателя в настройках); включена синхронизация; вы входите в аккаунт через браузер; вы получаете токен OAuth 2.0 во вкладке Auth; вы в аккаунте и публикуете коллекцию или смотрите статус её страницы во вкладке «Публикация», в панели «Публикации» или в меню коллекции, а пока публикация включена, список публикаций приложение запрашивает и само — при запуске и смене воркспейса; вы импортируете опубликованную коллекцию по ссылке или кнопкой «Открыть в Tetiva» — тогда приложение скачивает её с api.tetiva.app. Аналитики и отчётов об использовании нет.
Четыре протокола — один интерфейс. Вкладки, коллекции, окружения и авторизация работают одинаково для HTTP, gRPC, GraphQL и WebSocket; различается только редактор запроса.
Скрипты изолированы. Pre-request и post-response скрипты выполняет движок goja: без файловой системы, без сети, с таймаутом в 5 секунд — подробности на странице Скрипты.
Импорт и экспорт. Коллекции приходят из Postman v2.1, Insomnia, Hoppscotch, спецификаций OpenAPI и Swagger и HAR-файлов, окружения — из файлов Postman и Hoppscotch. Выгружаются они в Postman v2.1 и файлы окружений Postman, так что уйти можно в любой момент — см. Импорт и экспорт.
Русский интерфейс — в бете. Язык выбирается в настройках, по умолчанию — как в системе. На русский переведены сами настройки, всё про публикацию, дерево коллекций с поиском, контекстные меню с их диалогами, обзор коллекции и редактор описания, импорт, окружения, история, сравнение ответов и сохранение примеров, кнопки редактора скриптов, окно синхронизации, панель «Публикации» и страницы после входа и OAuth; экран приветствия и «Что нового» тоже показываются на выбранном языке. Всё остальное в редакторе запросов и в приложении пока на английском, поэтому их кнопки и вкладки в документации названы так, как они выглядят в приложении: Send, Params, Body.
Десктоп-клиент бесплатен и open source — скачать. Разделы документации перечислены ниже: каждая страница закрывает одну тему целиком.