HAPI CLI
Remote control for Claude Code, Codex and other coding agent sessions from your phone via native apps and web
- 5,404 ★ on the repository
- Last commit
- AGPL-3.0
Broad access
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
- Works in
- Services
Manual install
npx @twsxtd/hapi hub --relayStarts the hub with the encrypted relay.
Access and checks
How we reviewBroad accessThe tool can change data, run commands or handle secrets.
- Grants remote access to the work machine and agent sessions from a phone
- By default traffic passes through a shared third-party relay server
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.
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.
Discussion
No questions or reviews yet.
Related
All Telegram toolsSelf-hosted monitoring and remote approvals for Claude Code and Codex via Telegram, Feishu or a web terminal
A Claude Code plugin that gives the agent a name, a personality and memory across sessions, plus chat channels.
A compact OpenClaw alternative: a personal assistant on Claude Agent SDK with agents in isolated containers and messengers added via skills
Claude-to-IM
claude-to-im
A bridge between Claude Code or Codex and messengers: talk to the agent from Telegram, Discord, Feishu, QQ or WeChat
A Telegram bridge for the Pi coding agent: continue sessions from your phone and hand them back to the terminal
A local daemon assembles Claude Code, Codex and OpenCode into a team: tasks, separate worktrees, checks and merging.
Comparison with similar tools
Cards that share the main search query, and how they differ.
| Tool | Official | Repository stars | Main difference |
|---|---|---|---|
| HAPI (this card) | no | 5,404 | |
| Alook | no | 1,494 | alook gives local Claude Code |
| OpenCode Telegram Bot | no | 1,352 | a Telegram bot for OpenCode |
| botmux | no | 1,975 | botmux connects Lark and Feishu to Claude Code |
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.