mirror of
https://github.com/wu736139669/hapi.git
synced 2026-08-05 06:24:37 +00:00
SSU-WEI HUANGandGitHub
b9eed7c071
* test: define Grok Build integration behavior * feat: add Grok Build agent integration * test: cover Grok permissions and resume paths * docs: add Grok Build setup guide * fix: scope Grok ACP discovery to session cwd * fix: align Grok permission UI semantics * docs: clarify Grok runner setup * test: require Grok create model and effort options * feat: add Grok create model and effort pickers * test: define Grok runtime parity behavior * feat: add Grok runtime ACP controls and discovery * fix: tighten Grok runtime controls * fix: suppress nonfatal Grok title quota errors * feat: support Grok Auto permission mode * feat: forward ACP native session titles for Grok * fix: guard Grok Windows shell arguments
56 lines
2.2 KiB
Markdown
56 lines
2.2 KiB
Markdown
# HAPI
|
|
|
|
Run official Claude Code / Codex / Cursor Agent / Grok Build / 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?](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.
|
|
- **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—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 # 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/guide/installation.md)
|
|
|
|
## Docs
|
|
|
|
- [App](docs/guide/pwa.md)
|
|
- [How it Works](docs/guide/how-it-works.md)
|
|
- [Cursor Agent](docs/guide/cursor.md)
|
|
- [Grok Build](docs/guide/grok.md)
|
|
- [Voice Assistant](docs/guide/voice-assistant.md)
|
|
- [Why HAPI](docs/guide/why-hapi.md)
|
|
- [FAQ](docs/guide/faq.md)
|
|
|
|
## Build from source
|
|
|
|
```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.
|