mirror of
https://github.com/wu736139669/hapi.git
synced 2026-08-05 06:24:37 +00:00
60 lines
1.6 KiB
Markdown
60 lines
1.6 KiB
Markdown
# hapi
|
||
|
||
Code on the go controlling Claude Code from your mobile device.
|
||
|
||
Free. Open source. Code anywhere.
|
||
|
||
## Installation
|
||
|
||
```bash
|
||
npm install -g hapi
|
||
```
|
||
|
||
## Usage
|
||
|
||
```bash
|
||
hapi
|
||
```
|
||
|
||
This will:
|
||
1. Start a Claude Code session
|
||
2. Register the session with your `hapi-server` instance
|
||
3. Allow real-time session control from the Telegram Mini App
|
||
|
||
## Commands
|
||
|
||
- `hapi auth` – Manage authentication
|
||
- `hapi codex` – Start Codex mode
|
||
- `hapi connect` – Not available in direct-connect mode
|
||
- `hapi notify` – Not available in direct-connect mode
|
||
- `hapi daemon` – Manage background service
|
||
- `hapi 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 to `true`, `1`, or `yes`)
|
||
|
||
## 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
|
||
- Claude CLI installed & logged in (`claude` command available in PATH)
|
||
|
||
## License
|
||
|
||
MIT
|