mirror of
https://github.com/wu736139669/hapi.git
synced 2026-08-05 06:24:37 +00:00
zrq8andGitHub
2646df346e
Windows global installs expose codex as codex.cmd; spawning 'codex' without shell hits ENOENT. Enable shell to align with Claude's Windows behavior and resolve PATH lookup. Shell spawn makes cmd.exe strip TOML double quotes in -c arrays, so args become a string. Switch mcp args to TOML literal (single-quoted) arrays to preserve types; update tests.
HAPI
HAPI means "哈皮" a Chinese transliteration of Happy. Great credit to the original project.
Run Claude Code / Codex / Gemini 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? for the key differences.
Features
- Seamless Handoff - Work locally with native Claude Code or Codex, switch to remote when needed, switch back anytime.
- AFK Without Stopping - Step away from your desk? Keep approving AI requests from your phone. HAPI pushes permission requests to Telegram or your browser—approve or deny with one tap.
- See What AI Sees - Browse project files and Git diffs directly in the web app. No SSH needed—just open the session and check what changed.
- Stay in the Loop - Real-time todo progress shows you exactly where AI is in a multi-step task. No more guessing if it's stuck or making progress.
- Your AI, Your Choice - Switch between Claude Code, Codex, and Gemini from the same interface. Different models for different tasks, one unified workflow.
- Terminal Anywhere - Need to run a quick command? Access a real terminal session from your phone or browser, directly connected to the working machine.
Getting Started
npx @twsxtd/hapi server # start the server locally
npx @twsxtd/hapi # run claude code
Open http://<server-ip>:3006 and login with the token, if you need to access it remotely, see Remote access
More options: Quick Start | Installation
Docs
Build from source
bun install
bun run build:single-exe