HAPI
Remote control for Claude Code, Codex and other coding agent sessions from your phone via native apps and web
High risk
We rate an entry high when the tool writes to external systems, handles money, production databases or secrets, or runs arbitrary commands. The CLI installs it only with your consent.
Why this level
- Grants remote access to the work machine and agent sessions from a phone
- By default traffic passes through a shared third-party relay server
Install
Manual install
npx @twsxtd/hapi hub --relayStarts the hub with the encrypted relay.
This is third-party code. Review the repository files before installing.
What it does
HAPI runs a hub on your work machine that wraps an already installed coding agent, such as Claude Code, Codex, Cursor Agent or OpenCode, and exposes it to your phone or browser. A session starts locally in the terminal as usual, then can be picked up from iOS, Android, the web, or a Telegram Mini App without losing context or restarting. Approving the agent's requests, dictating, and browsing files can all be done remotely, with the connection encrypted over WireGuard and TLS; HAPI itself does not replace the agent, it only relays its input and output through a relay or a self-hosted tunnel.
Who it is for. For developers who run long coding agent tasks and want to step away from the computer without losing the session.
Good fit when
- You need to approve an agent's request or check task progress from your phone
- You want to continue a Claude Code or Codex session on another device without restarting
- You need voice input for a coding agent when your hands are busy with something else
Not a fit when
- You always work at the same computer and never need remote access
- You do not want to expose your work machine even through an encrypted relay
Example request
Start a Claude Code session through HAPI and show the QR code to connect from my phoneLimitations
Using the default shared relay means session traffic passes through a third-party server, even though it is encrypted. Fully self-hosted setups require running Cloudflare Tunnel or Tailscale separately. Some agents require a specific minimum version, for example Codex 0.154.0 or newer for shared sessions.
How to disable. Stop the hub process and remove the package with npm uninstall -g @twsxtd/hapi; the installed native phone apps can be removed like any other app.
Security check
- Grants remote access to the work machine and agent sessions from a phone
- By default traffic passes through a shared third-party relay server
README in short
The README describes HAPI as a local hub that wraps official Claude Code, Codex, Cursor Agent and other agent sessions and exposes them remotely through native iOS and Android apps, the web, or a Telegram Mini App. It highlights shared Codex sessions between terminal and phone, a voice assistant, a workspace file browser, and end-to-end encryption over WireGuard and TLS. The author positions the project as a local-first alternative to Happy. AGPL-3.0 licensed.
FAQ
Which agents does HAPI support?
Claude Code, Codex, Cursor Agent, Grok Build, OpenCode, Kimi, Copilot, Antigravity, Pi and DeepSeek Harness; a specific agent is launched with hapi <agent>.
Can I avoid the shared relay?
Yes, the README documents self-hosted setups through Cloudflare Tunnel or Tailscale instead of HAPI's default relay.
Related
A skills library that gives coding agents a development process: brainstorming, planning, TDD, subagents and code review
Skills for real engineers by Matt Pocock
Skills For Real Engineers
Small composable skills for engineering with agents: plan grilling, TDD, bug diagnosis, code review and architecture
GitHub toolkit for spec-driven development: the specify CLI adds agent commands and skills to a project, from principles to implementation
Reference MCP servers
Model Context Protocol servers
Official reference MCP servers: Filesystem, Fetch, Git, Memory, Sequential Thinking, Time and Everything