HAPI Personal Fork

Run official Claude Code / Codex / Cursor Agent / Grok Build / OpenCode / Kimi / Copilot / Antigravity / Pi / DeepSeek Harness sessions and control them remotely through native iOS / Android apps, Web / PWA, or Telegram Mini App.

本项目 fork 自 tiann/hapi。

我的改动

• 增加独立的“临时上下文”入口，长文本可以作为 .txt 附件与输入框中的问题一起发送。
• 粘贴文本达到默认 3000 字符或超过 60 行时自动转换为附件，两个阈值可以在“设置 → 聊天 → 输入”中自定义。
• 支持直接粘贴普通文件，不再只处理图片。
• User 消息超过 15 行时默认折叠，展开后立即显示完整内容。
• 运行中默认需要在 2 秒内按两次 Esc 才中断任务，首次按下会提示；可在“设置 → 聊天 → 输入”改为按一次。

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.
• 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's browser or desktop web app, directly connected to the working machine.
• Voice Control - Use dictation in native apps, or talk to your AI agent hands-free with the web 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.

使用

npm install -g @youngfine/hapi --registry=https://registry.npmjs.org
hapi hub --relay
hapi runner start --workspace-root ~/git-repository

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 hub displays a URL and two QR codes. Open the web URL in a browser, or pair a native app using the companion QR. See Native apps for build and pairing instructions.

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

• Native apps (iOS / Android)
• Web / PWA
• How it Works
• Supported Agents
• Voice Assistant
• Why HAPI
• FAQ

Native apps (iOS / Android)

The repository includes SwiftUI/UIKit and Kotlin Compose clients with chat, approvals, session creation, files, dictation, and push notifications. See the native app guide for capabilities, platform differences and pairing. Build instructions: iOS and Android. Developer protocol: client contract.

Build from source

Requires Bun 1.4.0.

bun install
bun run build:single-exe

Credits

HAPI means "哈皮" a Chinese transliteration of Happy. Great credit to the original project.