Repolode
Submit
tiann

tiann/hapi

Remote control for AI coding agents like Claude Code and Codex, running sessions on your machine and driving them from phones or the web.

Open-source alternative to:Happy

View on GitHubWebsite
Stars
5,269
Forks
616
Open issues
364
Last commit
19 hours ago

What is it?

HAPI wraps official AI coding agents such as Claude Code, Codex, Cursor Agent, OpenCode and Pi, so sessions keep running on your own machine while you monitor and control them from a native iOS or Android app, a web or PWA client, or a Telegram Mini App.

The workflow is built around handoff: you can start work in the local terminal, switch to a phone when you step away, and switch back without losing context or restarting the session. Approval requests from the agent can be answered with one tap. Setup starts with a hub command that displays a URL and QR codes for pairing, and an optional E2E encrypted relay or self-hosted tunnels such as Cloudflare Tunnel or Tailscale can carry the connection.

HAPI also includes a terminal view in the browser, voice input, and an opt-in workspace browser that exposes only the directories you allow via runner flags.

Key features

  • 01Hand off sessions between local terminal and phone or web without restarting.
  • 02Approve agent requests from a mobile device with one tap.
  • 03Supports Claude Code, Codex, Cursor Agent, OpenCode, Kimi, Copilot and other agents.
  • 04Native iOS and Android clients with chat, approvals, files and push notifications.
  • 05Browse permitted workspace directories and start sessions in them from the web.

Use cases

  • Checking on a long-running coding agent from your phone while away from your desk.
  • Approving agent tool requests remotely without returning to the workstation.
  • Running coding agents on a home or office machine and accessing them from anywhere.

Quick start

  1. 1

    Start the hub with E2E encrypted relay

    npx @twsxtd/hapi hub --relay
  2. 2

    Choose an agent and start a session

    npx @twsxtd/hapi
  3. 3

    Open the web URL shown by the hub in a browser, or pair a native app with the companion QR code

Things to know

  • Building from source requires Bun 1.4.0.
  • Remote access through the relay or self-hosted tunnels requires setup beyond the basic command.
  • Licensed under AGPL-3.0, a copyleft license that requires sharing modified source code for network use.

Topics

#ai-agent#claude-code#codex#remote-control#developer-tools#mobile#pwa#self-hosted#app#gemini-cli

FAQ

What is hapi?
Remote control for AI coding agents like Claude Code and Codex, running sessions on your machine and driving them from phones or the web. HAPI wraps official AI coding agents such as Claude Code, Codex, Cursor Agent, OpenCode and Pi, so sessions keep running on your own machine while you monitor and control them from a native iOS or Android app, a web or PWA client, or a Telegram Mini App.
Is hapi free to use? What license does it have?
hapi is open source under the AGPL-3.0 license. Check the license terms before using it in commercial products.
Is hapi still maintained?
Actively maintained. The last commit to hapi was on Oct 19, 2026.
What can I use hapi for?
Checking on a long-running coding agent from your phone while away from your desk. Approving agent tool requests remotely without returning to the workstation. Running coding agents on a home or office machine and accessing them from anywhere.
How do I install hapi?
Start the hub with E2E encrypted relay: npx @twsxtd/hapi hub --relay Choose an agent and start a session: npx @twsxtd/hapi Open the web URL shown by the hub in a browser, or pair a native app with the companion QR code
Where can I get hapi?
The source code and installation instructions are on GitHub: https://github.com/tiann/hapi

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects