@twsxtd/hapi 0.1.0

package/README.md

@@ -0,0 +1,131 @@
+# hapi CLI
+
+Run Claude Code, Codex, or Gemini sessions from your terminal and control them remotely through the hapi server.
+
+## What it does
+
+- Starts Claude Code sessions and registers them with hapi-server.
+- Starts Codex mode for OpenAI-based sessions.
+- Starts Gemini mode via ACP (Anthropic Code Plugins).
+- Provides an MCP stdio bridge for external tools.
+- Manages a background daemon for long-running sessions.
+- Includes diagnostics and auth helpers.
+
+## Typical flow
+
+1. Start the server and set env vars (see ../server/README.md).
+2. Set the same CLI_API_TOKEN on this machine or run `hapi auth login`.
+3. Run `hapi` to start a session.
+4. Use the web app or Telegram Mini App to monitor and control.
+
+## Commands
+
+### Session commands
+
+- `hapi` - Start a Claude Code session (passes through Claude CLI flags). See `src/index.ts`.
+- `hapi codex` - Start Codex mode. See `src/codex/runCodex.ts`.
+- `hapi gemini` - Start Gemini mode via ACP. See `src/agent/runners/runAgentSession.ts`.
+
+### Authentication
+
+- `hapi auth status` - Show authentication configuration and token source.
+- `hapi auth login` - Interactively enter and save CLI_API_TOKEN.
+- `hapi auth logout` - Clear saved credentials.
+
+See `src/commands/auth.ts`.
+
+### Daemon management
+
+- `hapi daemon start` - Start daemon as detached process.
+- `hapi daemon stop` - Stop daemon gracefully.
+- `hapi daemon status` - Show daemon diagnostics.
+- `hapi daemon list` - List active sessions managed by daemon.
+- `hapi daemon stop-session <sessionId>` - Terminate specific session.
+- `hapi daemon logs` - Print path to latest daemon log file.
+- `hapi daemon install` - Install daemon as system service.
+- `hapi daemon uninstall` - Remove daemon system service.
+
+See `src/daemon/run.ts`.
+
+### Diagnostics
+
+- `hapi doctor` - Show full diagnostics (version, daemon status, logs, processes).
+- `hapi doctor clean` - Kill runaway HAPI processes.
+
+See `src/ui/doctor.ts`.
+
+### Other
+
+- `hapi mcp` - Start MCP stdio bridge. See `src/codex/happyMcpStdioBridge.ts`.
+- `hapi server` - Start the bundled server (single binary workflow).
+
+## Configuration
+
+See `src/configuration.ts` for all options.
+
+### Required
+
+- `CLI_API_TOKEN` - Shared secret; must match the server. Can be set via env or `~/.hapi/settings.json` (env wins).
+- `HAPI_BOT_URL` - Server base URL (default: http://localhost:3006).
+
+### Optional
+
+- `HAPI_HOME` - Config/data directory (default: ~/.hapi).
+- `HAPI_EXPERIMENTAL` - Enable experimental features (true/1/yes).
+- `HAPI_CLAUDE_PATH` - Path to a specific `claude` executable.
+- `HAPI_HTTP_MCP_URL` - Default MCP target for `hapi mcp`.
+
+### Daemon
+
+- `HAPI_DAEMON_HEARTBEAT_INTERVAL` - Heartbeat interval in ms (default: 60000).
+- `HAPI_DAEMON_HTTP_TIMEOUT` - HTTP timeout for daemon control in ms (default: 10000).
+
+### Gemini/Agent
+
+- `HAPPY_GEMINI_COMMAND` - Gemini executable command (default: gemini).
+- `HAPPY_GEMINI_ARGS` - Gemini arguments (default: --acp).
+
+## Storage
+
+Data is stored in `~/.hapi/` (or `$HAPI_HOME`):
+
+- `settings.json` - User settings (machineId, token, onboarding flag). See `src/persistence.ts`.
+- `daemon.state.json` - Daemon state (pid, port, version, heartbeat).
+- `logs/` - Log files.
+
+## Requirements
+
+- Claude CLI installed and logged in (`claude` on PATH).
+- Bun for building from source.
+
+## Build from source
+
+From the repo root:
+
+```bash
+bun install
+bun run build:cli
+bun run build:cli:exe
+```
+
+For an all-in-one binary that also embeds the web app:
+
+```bash
+bun run build:single-exe
+```
+
+## Source structure
+
+- `src/api/` - Bot communication (Socket.IO + REST).
+- `src/claude/` - Claude Code integration.
+- `src/codex/` - Codex mode integration.
+- `src/agent/` - Multi-agent support (Gemini via ACP).
+- `src/daemon/` - Background service.
+- `src/commands/` - CLI command handlers.
+- `src/ui/` - User interface and diagnostics.
+- `src/modules/` - Tool implementations (ripgrep, difftastic, git).
+
+## Related docs
+
+- `../server/README.md`
+- `../web/README.md`

package/bin/hapi.js

@@ -0,0 +1,48 @@
+#!/usr/bin/env node
+
+const { execFileSync } = require('child_process');
+const path = require('path');
+
+const platform = process.platform;
+const arch = process.arch;
+const pkgName = `@twsxtd/hapi-${platform}-${arch}`;
+
+function getBinaryPath() {
+    try {
+        // Try to find the platform-specific package
+        const pkgPath = require.resolve(`${pkgName}/package.json`);
+        const binName = platform === 'win32' ? 'hapi.exe' : 'hapi';
+        return path.join(path.dirname(pkgPath), 'bin', binName);
+    } catch (e) {
+        return null;
+    }
+}
+
+const binPath = getBinaryPath();
+
+if (!binPath) {
+    console.error(`Unsupported platform: ${platform}-${arch}`);
+    console.error('');
+    console.error('Supported platforms:');
+    console.error('  - darwin-arm64 (macOS Apple Silicon)');
+    console.error('  - darwin-x64 (macOS Intel)');
+    console.error('  - linux-arm64');
+    console.error('  - linux-x64');
+    console.error('  - win32-x64');
+    console.error('');
+    console.error('You can download the binary manually from:');
+    console.error('  https://github.com/anthropics/hapi/releases');
+    process.exit(1);
+}
+
+try {
+    execFileSync(binPath, process.argv.slice(2), { stdio: 'inherit' });
+} catch (e) {
+    // If the binary execution fails, exit with the same code
+    if (e.status !== undefined) {
+        process.exit(e.status);
+    }
+    // For other errors (e.g., binary not found), print and exit
+    console.error(`Failed to execute ${binPath}:`, e.message);
+    process.exit(1);
+}

package/package.json

@@ -0,0 +1,90 @@
+{
+  "name": "@twsxtd/hapi",
+  "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/tiann/hapi",
+  "bugs": "https://github.com/tiann/hapi/issues",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/tiann/hapi",
+    "directory": "cli"
+  },
+  "bin": {
+    "hapi": "bin/hapi.js"
+  },
+  "files": [
+    "bin/hapi.js"
+  ],
+  "imports": {
+    "#embedded-assets": {
+      "bun": "./src/runtime/embeddedAssets.bun.ts",
+      "default": "./src/runtime/embeddedAssets.stub.ts"
+    }
+  },
+  "optionalDependencies": {
+    "@twsxtd/hapi-darwin-arm64": "0.1.0",
+    "@twsxtd/hapi-darwin-x64": "0.1.0",
+    "@twsxtd/hapi-linux-arm64": "0.1.0",
+    "@twsxtd/hapi-linux-x64": "0.1.0",
+    "@twsxtd/hapi-win32-x64": "0.1.0"
+  },
+  "scripts": {
+    "typecheck": "tsc --noEmit",
+    "build:exe": "bun run scripts/build-executable.ts",
+    "build:exe:all": "bun run scripts/build-executable.ts --all",
+    "build:exe:allinone": "bun run scripts/build-executable.ts --with-web-assets",
+    "build:exe:allinone:all": "bun run scripts/build-executable.ts --with-web-assets --all",
+    "prepare-npm-packages": "bun run scripts/prepare-npm-packages.ts",
+    "prepack": "bun run prepare-npm-packages",
+    "publish-npm": "bun run scripts/publish-npm.ts",
+    "publish-npm:dry-run": "bun run scripts/publish-npm.ts --dry-run",
+    "tools:unpack": "bun run scripts/unpack-tools.ts",
+    "test": "tsx --env-file .env.integration-test node_modules/.bin/vitest run",
+    "test:win": "vitest run",
+    "dev": "tsx src/index.ts",
+    "dev:local-server": "tsx --env-file .env.dev-local-server src/index.ts",
+    "dev:integration-test-env": "tsx --env-file .env.integration-test src/index.ts"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.22.0",
+    "@types/cross-spawn": "^6.0.6",
+    "@types/ps-list": "^6.2.1",
+    "@types/react": "^19.2.7",
+    "@types/tmp": "^0.2.6",
+    "axios": "^1.13.2",
+    "chalk": "^5.6.2",
+    "cross-spawn": "^7.0.6",
+    "fastify": "^5.6.2",
+    "fastify-type-provider-zod": "4.0.2",
+    "ink": "^6.5.1",
+    "ps-list": "^8.1.1",
+    "react": "^19.2.0",
+    "react-devtools-core": "^7.0.1",
+    "socket.io-client": "^4.8.1",
+    "tar": "^7.5.2",
+    "zod": "^3.23.8"
+  },
+  "devDependencies": {
+    "@eslint/compat": "^1",
+    "@types/node": ">=20",
+    "bun-types": "^1.3.5",
+    "cross-env": "^10.1.0",
+    "dotenv": "^16.6.1",
+    "eslint": "^9",
+    "eslint-config-prettier": "^10",
+    "shx": "^0.3.3",
+    "ts-node": "^10",
+    "tsx": "^4.20.6",
+    "typescript": "^5",
+    "vitest": "^3.2.4"
+  },
+  "resolutions": {
+    "whatwg-url": "14.2.0",
+    "parse-path": "7.0.3",
+    "@types/parse-path": "7.0.3"
+  },
+  "packageManager": "bun@1.3.4"
+}