mirror of
https://github.com/wu736139669/hapi.git
synced 2026-08-05 06:24:37 +00:00
Introduce runtime path abstraction for Bun-compiled binaries that extracts
assets to ~/.happy/runtime/{version} instead of using project paths. This
enables proper distribution of CLI as a self-contained binary with embedded
tools (ripgrep, difftastic) and scripts that are extracted at runtime.
hapi
Code on the go controlling Claude Code from your mobile device.
Free. Open source. Code anywhere.
Installation
npm install -g hapi
Usage
hapi
This will:
- Start a Claude Code session
- Register the session with your
hapi-serverinstance - Allow real-time session control from the Telegram Mini App
Commands
hapi auth– Manage authenticationhapi codex– Start Codex modehapi connect– Not available in direct-connect modehapi notify– Not available in direct-connect modehapi daemon– Manage background servicehapi doctor– System diagnostics & troubleshooting
Options
-h, --help- Show help-v, --version- Show version-m, --model <model>- Claude model to use (default: sonnet)-p, --permission-mode <mode>- Permission mode: auto, default, or plan--claude-env KEY=VALUE- Set environment variable for Claude Code--claude-arg ARG- Pass additional argument to Claude CLI
Environment Variables
HAPPY_BOT_URL- Bot URL (default: http://localhost:3006)CLI_API_TOKEN- Shared secret for bot authentication (required)HAPPY_HOME_DIR- Custom home directory for hapi data (default: ~/.happy)HAPPY_EXPERIMENTAL- Enable experimental features (set totrue,1, oryes)
Requirements
- Node.js >= 20.0.0
- Required by
eventsource-parser@3.0.5, which is required by@modelcontextprotocol/sdk, which we used to implement permission forwarding to mobile app
- Required by
- Claude CLI installed & logged in (
claudecommand available in PATH)
License
MIT