heyhank 0.1.0

package/README.md

@@ -0,0 +1,40 @@
+# HeyHank
+
+Self-hosted web UI for running Claude Code and Codex agents. Multi-session management with streaming, tool call visibility, and permission control.
+
+## Install
+
+```bash
+bunx heyhank
+```
+
+Requires [Bun](https://bun.sh) v1.0+.
+
+## Usage
+
+```bash
+# Start the server
+heyhank serve
+
+# Install as background service
+heyhank install
+
+# Check status
+heyhank status
+```
+
+## Features
+
+- **Multi-Session Chat** — Run multiple Claude Code / Codex sessions simultaneously
+- **Gemini Live Voice Assistant** — Hands-free voice control with tool calling
+- **Scheduled Agents** — Cron-based agent automation
+- **Media Generation** — Image (Imagen 4) and video (Veo 3.1) generation
+- **Social Media** — Multi-backend posting (Postiz, Buffer, Ayrshare)
+- **Telephony** — Voice calls via FreeSWITCH SIP integration
+- **Federation** — Connect multiple HeyHank instances across machines
+- **Tailscale Funnel** — Public HTTPS access without port forwarding
+- **PWA** — Installable on mobile and desktop
+
+## License
+
+MIT

package/bin/cli.ts

@@ -0,0 +1,168 @@
+#!/usr/bin/env bun
+import { dirname, resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+
+// Package root so the server can find dist/ regardless of CWD
+const __dirname = dirname(fileURLToPath(import.meta.url));
+process.env.__COMPANION_PACKAGE_ROOT = resolve(__dirname, "..");
+
+const command = process.argv[2];
+
+// Management subcommands that delegate to ctl.ts
+const CTL_COMMANDS = new Set([
+  "sessions", "envs", "cron", "skills", "settings", "assistant", "ctl-help",
+]);
+
+function printUsage(): void {
+  console.log(`
+Usage: heyhank [command]
+
+Server commands:
+  (none)      Start the server in foreground (default)
+  serve       Start the server in foreground
+  start       Start the background service
+  install     Install as a background service (launchd/systemd)
+  stop        Stop the background service
+  restart     Restart the background service
+  uninstall   Remove the background service
+  status      Show service status (or use 'companion status' when server is running)
+  logs        Tail service log files
+  help        Show this help message
+
+Management commands (requires running server):
+  sessions    Manage sessions (list, create, kill, relaunch, archive, rename, send-message)
+  envs        Manage environment profiles (list, get, create, update, delete)
+  cron        Manage scheduled jobs (list, get, create, update, delete, toggle, run)
+  skills      Manage Claude Code skills (list, get, create, update, delete)
+  settings    Manage settings (get, set)
+  assistant   Manage the Companion Assistant (status, launch, stop, config)
+
+Options:
+  --port <n>  Override the default port (default: 3456)
+`);
+}
+
+switch (command) {
+  case "help":
+  case "-h":
+  case "--help":
+    printUsage();
+    break;
+
+  case "serve": {
+    process.env.NODE_ENV = process.env.NODE_ENV || "production";
+    await import("../server/index.ts");
+    break;
+  }
+
+  case "start": {
+    // Internal service process should stay in foreground server mode.
+    const forceForeground = process.argv.includes("--foreground");
+    const launchedByInit = (() => {
+      if (process.ppid === 1) return true;
+      // User-level systemd (systemctl --user) spawns services from a
+      // per-user systemd process whose ppid != 1.  Detect it via /proc.
+      try {
+        const { readFileSync } = require("node:fs");
+        const comm = readFileSync(`/proc/${process.ppid}/comm`, "utf-8").trim();
+        return comm === "systemd";
+      } catch {
+        return false;
+      }
+    })();
+    if (forceForeground || launchedByInit) {
+      process.env.NODE_ENV = process.env.NODE_ENV || "production";
+      await import("../server/index.ts");
+      break;
+    }
+    const { start } = await import("../server/service.js");
+    await start();
+    break;
+  }
+
+  case "install": {
+    const { install } = await import("../server/service.js");
+    const portIdx = process.argv.indexOf("--port");
+    const rawPort = portIdx !== -1 ? Number(process.argv[portIdx + 1]) : undefined;
+    const port = rawPort && !Number.isNaN(rawPort) ? rawPort : undefined;
+    await install({ port });
+    break;
+  }
+
+  case "uninstall": {
+    const { uninstall } = await import("../server/service.js");
+    await uninstall();
+    break;
+  }
+
+  case "status": {
+    // Try management API first (server running), fall back to service status
+    try {
+      const { handleCtlCommand } = await import("./ctl.js");
+      await handleCtlCommand("status", process.argv.slice(3));
+    } catch {
+      // Server not running — show service status
+      const { status } = await import("../server/service.js");
+      const result = await status();
+      if (!result.installed) {
+        console.log("The Companion is not installed as a service.");
+        console.log("Run: companion install");
+      } else if (result.running) {
+        console.log(`The Companion is running (PID: ${result.pid})`);
+        console.log(`  URL: http://localhost:${result.port}`);
+      } else {
+        console.log("The Companion is installed but not running.");
+        console.log("Check logs at ~/.heyhank/logs/");
+      }
+    }
+    break;
+  }
+
+  case "stop": {
+    const { stop } = await import("../server/service.js");
+    await stop();
+    break;
+  }
+
+  case "restart": {
+    const { restart } = await import("../server/service.js");
+    await restart();
+    break;
+  }
+
+  case "logs": {
+    const { join } = await import("node:path");
+    const { homedir } = await import("node:os");
+    const { spawn } = await import("node:child_process");
+    const logFile = join(homedir(), ".heyhank/logs/heyhank.log");
+    const errFile = join(homedir(), ".heyhank/logs/heyhank.error.log");
+    const { existsSync } = await import("node:fs");
+    if (!existsSync(logFile) && !existsSync(errFile)) {
+      console.error("No log files found at ~/.heyhank/logs/");
+      console.error("The service may not have been started yet.");
+      process.exit(1);
+    }
+    console.log("Tailing logs from ~/.heyhank/logs/");
+    const tail = spawn("tail", ["-f", logFile, errFile], { stdio: "inherit" });
+    tail.on("exit", () => process.exit(0));
+    break;
+  }
+
+  case undefined: {
+    // Default: start server in foreground
+    process.env.NODE_ENV = process.env.NODE_ENV || "production";
+    await import("../server/index.ts");
+    break;
+  }
+
+  default: {
+    if (command && CTL_COMMANDS.has(command)) {
+      const { handleCtlCommand } = await import("./ctl.js");
+      await handleCtlCommand(command, process.argv.slice(3));
+    } else {
+      console.error(`Unknown command: ${command}`);
+      printUsage();
+      process.exit(1);
+    }
+  }
+}