This commit is contained in:
weishu
2025-12-24 17:35:19 +08:00
parent 2a10ce9675
commit 852c7f4c4e
3 changed files with 20 additions and 31 deletions
+12 -23
View File
@@ -8,18 +8,17 @@ Run Claude Code / Codex / Coding Agent sessions locally and control them remotel
1. Download the prebuilt `hapi` binary for your platform and put it on your PATH.
2. Start the server on a machine you control:
2. Start the server on a machine you control: `hapi server`
```bash
export CLI_API_TOKEN="shared-secret"
export WEBAPP_URL="https://your-domain.example" # required for Telegram Mini App
export TELEGRAM_BOT_TOKEN="..."
export ALLOWED_CHAT_IDS="12345678"
Optional for telegram, add a `.env` file and then start server:
hapi server
```
WEBAPP_URL="https://your-domain.example" # required for Telegram Mini App
TELEGRAM_BOT_TOKEN="..."
ALLOWED_CHAT_IDS="12345678"
```
If you only want the web app + CLI, you can skip TELEGRAM_BOT_TOKEN and ALLOWED_CHAT_IDS.
If you only want the web app + CLI, you can skip these vars.
To enable Telegram later, set TELEGRAM_BOT_TOKEN and WEBAPP_URL, start the server, send `/start`
to the bot to get your chat ID, set ALLOWED_CHAT_IDS, and restart the server.
@@ -37,8 +36,6 @@ export HAPI_BOT_URL="https://your-domain.example"
hapi
```
The CLI will prompt for `CLI_API_TOKEN` and save it locally.
5. Open the UI:
- In Telegram, run `/app` in the bot chat.
- In a browser, open `WEBAPP_URL` and log in with `CLI_API_TOKEN`.
@@ -47,13 +44,6 @@ The CLI will prompt for `CLI_API_TOKEN` and save it locally.
You can store the token in `~/.hapi/settings.json` instead of an env var.
Environment variables take priority over the file.
Example:
```json
{
"cliApiToken": "shared-secret"
}
```
## Requirements
- Claude CLI installed and logged in (`claude` on PATH).
- A Telegram bot token from @BotFather (for Mini App access).
@@ -70,13 +60,12 @@ Build a single binary with embedded web assets:
bun run build:single-exe
```
Build CLI-only binaries:
```bash
bun run build:cli:exe
bun run build:cli:exe:all
```
## Docs
- `cli/README.md` - CLI usage and config
- `server/README.md` - server setup and architecture
- `web/README.md` - web app behavior and dev workflow
## License
- cli: MIT
- others: LGPLv2
+6 -6
View File
@@ -1,15 +1,15 @@
{
"name": "@twsxtd/hapi",
"version": "0.12.0-1",
"description": "Mobile and Web client for Claude Code and Codex",
"author": "Kirill Dubovitskiy",
"version": "0.1.0",
"description": "App for agentic coding - access coding agent anywhere",
"author": "Kirill Dubovitskiy & weishu",
"license": "MIT",
"type": "module",
"homepage": "https://github.com/user/hapi",
"bugs": "https://github.com/user/hapi/issues",
"homepage": "https://github.com/tiann/hapi",
"bugs": "https://github.com/tiann/hapi/issues",
"repository": {
"type": "git",
"url": "https://github.com/user/hapi",
"url": "https://github.com/tiann/hapi",
"directory": "cli"
},
"bin": {
+2 -2
View File
@@ -3,8 +3,8 @@
"private": true,
"version": "0.1.0",
"description": "Telegram Bot client for HAPI - control Claude Code sessions",
"author": "Kirill Dubovitskiy",
"license": "MIT",
"author": "weishu",
"license": "LGPL",
"type": "module",
"scripts": {
"start": "bun run src/index.ts",