mirror of
https://github.com/wu736139669/hapi.git
synced 2026-10-17 20:56:35 +00:00
66 lines
3.1 KiB
Markdown
66 lines
3.1 KiB
Markdown
# 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?](docs/guide/why-hapi.md) for the key differences.
|
|
|
|
## Features
|
|
|
|
- **Seamless Handoff** - Work locally, switch to remote when needed, switch back anytime. No context loss, no session restart.
|
|
- **Shared Codex Sessions** - Use Codex from your terminal and phone at the same time. Requires Codex 0.154.0+. [Usage and limits](docs/guide/codex-shared-sessions.md).
|
|
- **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, Grok Build, OpenCode, Kimi, Copilot, Antigravity, Pi, DeepSeek Harness—different agents, 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
|
|
|
|
```bash
|
|
npx @twsxtd/hapi hub --relay # start hub with E2E encrypted relay
|
|
npx @twsxtd/hapi # choose an agent and start a session
|
|
```
|
|
|
|
`hapi server` remains supported as an alias.
|
|
|
|
Use `hapi <agent> [options]` to start an agent directly, for example `hapi claude`
|
|
or `hapi codex`. Scripts must specify the agent explicitly. `hapi --help` shows
|
|
HAPI's commands and supported agents.
|
|
|
|
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/guide/installation.md)
|
|
|
|
## Docs
|
|
|
|
- [App](docs/guide/pwa.md)
|
|
- [How it Works](docs/guide/how-it-works.md)
|
|
- [Supported Agents](docs/guide/agents.md)
|
|
- [Voice Assistant](docs/guide/voice-assistant.md)
|
|
- [Why HAPI](docs/guide/why-hapi.md)
|
|
- [FAQ](docs/guide/faq.md)
|
|
|
|
## Native apps (iOS / Android)
|
|
|
|
Fully native SwiftUI and Kotlin Compose clients are in development under `ios/` and `android/`, with chat, approvals, session creation, files, dictation, and push notifications. Pair using the companion QR code printed by the hub or shown in web Settings, or enter the hub URL and token manually. See the [client contract docs](docs/api/client-contract/index.md).
|
|
|
|
## Build from source
|
|
|
|
Requires Bun 1.4.0.
|
|
|
|
```bash
|
|
bun install
|
|
bun run build:single-exe
|
|
```
|
|
|
|
## Credits
|
|
|
|
HAPI means "哈皮" a Chinese transliteration of [Happy](https://github.com/slopus/happy). Great credit to the original project.
|