convez.ai
PluginDesenvolvimento WebIntermediário
tiann

HAPI – Controle Remoto para Sessões de Coding com IA

tiann/hapi

Rode IA local, controle de qualquer lugar—sem perder contexto

Ver no GitHub
Muito bomPluginScore · de 0 a 100

Plugin que permite executar sessões de Claude Code, Codex, Gemini e OpenCode localmente, controlando-as remotamente via Web, PWA ou Telegram Mini App. Oferece transição perfeita entre trabalho local e remoto sem perda de contexto, com suporte a voz, aprovação de requisições via smartphone e navegação de workspace.

Instalação

$npx convez-ai tiann/hapi

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
5,4 mil
Forks
659
Acompanhando
14
Saúde
71%
Último commit
há 1 dia
Versão
v0.36.5
Issues abertas
348
Contribuidores
75

Casos de uso

  • Trabalhar em sessões de coding IA e aprová-las remotamente do celular
  • Alternar entre ambiente local e remoto mantendo o contexto intacto
  • Executar comandos no terminal via Web/PWA/Telegram enquanto afastado da máquina
  • Usar controle por voz para interagir com o agente IA hands-free

Veredito

HAPI é um wrapper robusto e bem-pensado para agentes de IA, focado em mobilidade e continuidade de contexto. Ideal para desenvolvedores que precisam transitar entre ambientes sem interrupção, mas exige conforto com CLI e tunelamento de rede.

README

A tradução para o português deste README ainda está na fila.

HAPI

Run official Claude Code / Codex / Gemini / OpenCode sessions locally 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

  • Seamless Handoff - Work locally, switch to remote when needed, switch back anytime. No context loss, no session restart.
  • Native First - HAPI wraps your AI agent instead of replacing it. Same terminal, same experience, same muscle memory.
  • AFK Without Stopping - Step away from your desk? Approve AI requests from your phone with one tap.
  • Your AI, Your Choice - Claude Code, Codex, Cursor Agent, Gemini, OpenCode—different models, one unified workflow.
  • Terminal Anywhere - Run commands from your phone or browser, directly connected to the working machine.
  • Voice Control - Talk to your AI agent hands-free using the built-in voice assistant.
  • Workspace Browser - Opt-in via one or more hapi runner start --workspace-root <path> flags: browse scoped file trees from the web and start sessions in allowed subdirectories.

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

Build from source

bun install
bun run build:single-exe

Credits

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

Ver o original no GitHub

Bom para

Relacionados