HAPI — локальная платформа для удалённого управления AI-агентами

HAPI — это локальное-first приложение, которое запускает официальные сессии Claude Code, Codex, Cursor Agent, Grok Build, OpenCode, Kimi, Copilot, Antigravity и Pi прямо на вашей машине, а управлять ими позволяет удалённо — через Web, PWA или Telegram Mini App. Проект позиционируется как локальная альтернатива сервису Happy (название «HAPI» — китайская транслитерация слова Happy), но с ключевым отличием: агент остаётся на вашей машине, а вы получаете к нему доступ с любого устройства.

Главная идея — «оборачивать», а не заменять AI-агента. Тот же терминал, те же команды, та же привычная работа, но с возможностью переключаться между локальной и удалённой сессией без потери контекста. Источник материала — официальный README репозитория tiann/hapi.

Ключевые возможности

Seamless Handoff (бесшовная передача работы). Работайте локально, переключайтесь на удалённое управление, когда нужно отойти от компьютера, и возвращайтесь обратно в любой момент. Никакой потери контекста и перезапуска сессий.

Native First (нативность). HAPI — это обёртка поверх вашего агента, а не его замена. То же окружение, тот же опыт, те же привычные движения. Софт и инструменты, к которым вы привыкли, продолжают работать как раньше.

AFK Without Stopping (работа вдали от клавиатуры). Нужно отойти от стола? Одобряйте запросы AI-агента с телефона буквально одним касанием. Агент продолжает работать, пока вы не за компьютером.

Your AI, Your Choice (свобода выбора агента). Claude Code, Codex, Cursor Agent, Grok Build, OpenCode, Kimi, Copilot, Antigravity, Pi — разные агенты, но единый унифицированный рабочий процесс. Стек агента больше не влияет на способ взаимодействия.

Terminal Anywhere (терминал где угодно). Выполняйте команды прямо с телефона или из браузера — они выполняются на рабочей машине, к которой подключён HAPI.

Voice Control (голосовое управление). Разговаривайте со своим AI-агентом без помощи рук: встроенный голосовой ассистент позволяет управлять сессией голосом.

Workspace Browser (просмотр файлов). Опциональная функция, включаемая через один или несколько флагов hapi runner start --workspace-root <path>. Позволяет просматривать файловые деревья из веба (в рамках разрешённых директорий) и запускать сессии в допустимых подпапках.

Как это работает

В основе архитектуры лежит концепция «хаб» (hub): центральная точка, которая обслуживает сессии агентов и принимает команды от удалённых клиентов. Relay используется для безопасного соединения между устройствами, и он использует WireGuard + TLS для сквозного шифрования — данные шифруются от вашего устройства до вашей машины и не доступны третьим лицам.

Для самохостинга предусмотрены альтернативные варианты (Cloudflare Tunnel, Tailscale), что делает HAPI гибким в настройке под разные сетевые окружения.

Установка и запуск

Запуск сводится к двум командам:

npx @twsxtd/hapi hub --relay    # запустить хаб со сквозным шифрованием через relay
npx @twsxtd/hapi                 # запустить claude code

Команда hapi server по-прежнему поддерживается как алиас. После запуска терминал выводит URL и QR-код: отсканируйте QR-код телефоном или откройте URL в браузере, чтобы получить доступ к интерфейсу управления.

Поддерживаемые агенты

HAPI поддерживает работу со следующими агентами (полный список — в документации docs/guide/agents.md):

• Claude Code — от Anthropic;
• Codex — от OpenAI;
• Cursor Agent — от Cursor (Anysphere);
• Grok Build — от xAI;
• OpenCode — открытый терминальный агент;
• Kimi — от Moonshot AI;
• Copilot — агент GitHub Copilot;
• Antigravity — агент от Google;
• Pi — агент, разработанный в эшелоне Happy.

Подход «один хаб — много агентов» означает, что при переходе между проектами или инструментами не нужно осваивать новый способ удалённого управления — интерфейс HAPI остаётся одним и тем же.

Сценарии использования

Практически HAPI закрывает несколько типичных задач:

1. Сессия работает, пока вы в пути. Запустили долгую задачу по рефакторингу, ушли на встречу — и вернулись к результату: запросы на подтверждение были отклонены или одобрены с телефона в один кивок.
2. Работа из браузера. Если под рукой нет установленного клиента — открываете веб-версию (PWA) по ссылке из терминала и продолжаете сессию.
3. Голосовое управление на фоне. Пока заняты руками, командами агентами управляете голосом через встроенный ассистент.
4. Просмотр файлов с телефона. При включении флагов --workspace-root можно просматривать дерево файлов проекта прямо из веб-интерфейса и запускать сессии в разрешённых директориях.
5. Доступ через Telegram Mini App. Управление прямо внутри мессенджера, без установки дополнительных приложений.

Модель безопасности

Безопасность в HAPI строится по принципу «локально, но защищённо»:

• сессии агентов выполняются на вашей машине;
• удалённый доступ идёт через hub и relay;
• канал шифруется с помощью WireGuard + TLS — сквозное шифрование от вашего устройства до рабочей машины;
• для приватных сценариев доступны самохостинг-варианты: Cloudflare Tunnel или Tailscale;
• нативные клиенты подключаются только по QR-коду из терминала, что делает несанкционированное подключение сложным.

При этом важно помнить: надёжность развёртывания в боевых условиях зависит от настроек сети и используемого transport-канала, поэтому перед продакшн-использованием стоит прочитать документацию по установке и безопасности.

Сборка из исходников

Для разработки и самостоятельной сборки используется Bun:

bun install
bun run build:single-exe

Скрипт build:single-exe позволяет собрать единый исполняемый файл.

Нативные приложения (iOS / Android)

Кроме веб-приложения и Telegram Mini App, в репозитории активно разрабатываются полностью нативные клиенты:

• iOS — SwiftUI (ios/),
• Android — Kotlin Compose (android/).

Нативные клиенты подключаются к хабу, сканируя тот же QR-код из терминала, что и веб-приложение, и работают по тому же протоколу. Контракт клиента описан в документации docs/api/client-contract/index.md.

Экосистема документации

В репозитории есть полноценная документация:

• App — описание PWA-приложения (docs/guide/pwa.md),
• How it Works — внутреннее устройство (docs/guide/how-it-works.md),
• Supported Agents — список поддерживаемых агентов (docs/guide/agents.md),
• Voice Assistant — настройка голосового ассистента (docs/guide/voice-assistant.md),
• Why HAPI — сравнение с Happy и обоснование альтернативы (docs/guide/why-hapi.md),
• FAQ — ответы на частые вопросы (docs/guide/faq.md),
• контракты клиентов (docs/api/client-contract/index.md),
• инструкции по установке, включая самохостинг через Cloudflare Tunnel и Tailscale (docs/guide/installation.md).

Почему HAPI, а не Happy

Основное позиционирование проекта — «local-first альтернатива Happy». В то время как Happy предполагает облачную инфраструктуру для удалённого доступа к агентам, HAPI держит всё на вашей машине и передаёт управление наружу через защищённый канал с сквозным шифрованием. Это важно для тех, кто:

• не хочет отправлять данные и код разработки в сторонние облака;
• нуждается в работе без перерыва — с одобрением запросов с телефона;
• использует несколько разных AI-агентов и хочет единый рабочий процесс;
• работает в команде и ценит возможность удалённо продолжать сессию.

Для кого подходит

HAPI будет полезен следующим категориям разработчиков:

1. Разработчикам, много работающим в терминале с AI-агентами (Claude Code, Codex, Cursor Agent, OpenCode и др.) — им хочется сохранить привычное окружение и одновременно получить мобильный контроль.
2. Тех, кто часто отходит от рабочего места — командам или фрилансерам, которые хотят, чтобы агент не простаивал, пока они в дороге.
3. Энтузиастам приватности — тем, кто предпочитает локальное развёртывание и сквозное шифрование вместо облачных сервисов.
4. Пользователям нескольких агентов — тем, кто переключается между Claude Code, Codex, OpenCode и другими и хочет один интерфейс управления.

Что стоит учитывать

При выборе HAPI стоит учитывать, что проект позиционирует себя как альтернатива существующему сервису Happy и находится в активной разработке: нативные iOS и Android клиенты ещё в разработке, а экосистема инструментов (включая голосовой ассистент и workspace browser) расширяется. Для продакшн-сценариев стоит изучить документацию по безопасности и самохостингу, прежде чем разворачивать HAPI в боевом окружении.

Выводы

HAPI — интересный пример направления «агентные харнесы» (agent harness): инструменты, которые не заменяют AI-агентов, а делают их использование удобнее. Ключевые тезисы:

• Локальность: вся работа выполняется на вашей машине, наружу уходит только управление.
• Совместимость: поддержка широкого спектра агентов и единый унифицированный интерфейс.
• Мобильность: удалённое управление через Web, PWA и Telegram Mini App с одобрением запросов одной кнопкой.
• Безопасность: сквозное шифрование через WireGuard + TLS, варианты самохостинга.

Ссылка на проект: https://github.com/tiann/hapi