hapi README

The project's README from github.com/tiann/hapi. As one markdown file: README.md.

HAPI

Run official Claude Code / Codex / Cursor Agent / Grok Build / OpenCode / Kimi / Copilot / Antigravity / Pi / DeepSeek Harness sessions and control them remotely through a Web / PWA / Telegram Mini App.

Why HAPI? HAPI is a local-first alternative to Happy. See Why Not Happy? for the key differences.

Features

Demo

https://github.com/user-attachments/assets/38230353-94c6-4dbe-9c29-b2a2cc457546

Getting Started

npx @twsxtd/hapi hub --relay     # start hub with E2E encrypted relay
npx @twsxtd/hapi                 # run claude code

hapi server remains supported as an alias.

The terminal will display a URL and QR code. Scan the QR code with your phone or open the URL to access.

The relay uses WireGuard + TLS for end-to-end encryption. Your data is encrypted from your device to your machine.

For self-hosted options (Cloudflare Tunnel, Tailscale), see Installation

Docs

Native apps (iOS / Android)

Fully native SwiftUI and Kotlin Compose clients are in development under ios/ and android/. They pair with your hub by scanning the same terminal QR code as the web app, and follow the same protocol — see the client contract docs.

Build from source

Requires Bun 1.4.0.

bun install
bun run build:single-exe

Credits

HAPI means "哈皮" a Chinese transliteration of Happy. Great credit to the original project.

hapi (tiann/hapi)

Searching Database…

5.3K ·GitHub
Что это такое?HAPI позволяет запускать на вашем компьютере сеансы официальных агентов для написания кода: Claude Code, Codex, Cursor Agent, Grok Build, OpenCode, Kimi, Copilot, Antigravity, Pi или DeepSeek Harness, а затем управлять ими удалённо из веб-браузера, PWA или Telegram Mini App.
Это замена моему агенту для написания кода или только слой удалённого управления?HAPI не заменяет ваш существующий ИИ-агент, а работает поверх него, поэтому вы сохраняете тот же терминал, привычный опыт и навыки работы, получая при этом удалённый доступ.
Как начать пользоваться?Запустите команду hapi server на своём компьютере: она выводит в терминале URL и QR-код, и после сканирования этого кода (или открытия URL) ваш телефон или браузер подключается к сеансу.
Можно ли уже пользоваться нативными приложениями для iOS и Android?Пока нет: полностью нативные клиенты на SwiftUI (iOS) и Kotlin Compose (Android) ещё в разработке; сейчас подключение идёт через веб-версию и PWA, для этого нужно отсканировать тот же QR-код из терминала.
Работает ли это только с одним агентом для написания кода?Нет, HAPI поддерживает Claude Code, Codex, Cursor Agent, Grok Build, OpenCode, Kimi, Copilot, Antigravity, Pi и DeepSeek Harness, так что смена агента не меняет ваш способ удалённой работы.
Можно ли развернуть это на своём сервере вместо использования стандартного ретранслятора?Да, HAPI описывает варианты самостоятельного развёртывания с Cloudflare Tunnel или Tailscale как альтернативу встроенному ретранслятору.
Шифруются ли данные сеанса при удалённом подключении?Да, соединение с ретранслятором использует WireGuard и TLS, и ваши данные шифруются сквозным образом от вашего устройства до компьютера.
Зачем использовать не оригинальный проект Happy?HAPI описан как локальная альтернатива Happy, а в README есть отдельный документ «Why Not Happy?», который объясняет ключевые различия между ними.
Можно ли ограничить, к каким папкам может обращаться удалённый сеанс?Да, запуск runner с одним или несколькими флагами --workspace-root включает Workspace Browser, который ограничивает удалённый доступ к файлам только разрешёнными подкаталогами.
Поддерживается ли управление голосом без рук?Да, в HAPI есть встроенный голосовой помощник, так что можно говорить с ИИ-агентом без набора текста.
Откуда взялось название HAPI?HAPI означает «哈皮», китайскую транслитерацию слова Happy, и так отдаётся должное оригинальному проекту Happy, который вдохновил этот.
Creator
tiann
Size
108.5 MB
Stars
5.3K
Age
9mo
Commits · 90 Days