@chatpanel/bridge 0.1.2 → 0.2.0

package/README.md

@@ -14,22 +14,38 @@ the ones the bridge reports as available.
 
 ## Run it
 
-**No clone, no install** — `npx` fetches the package (and its one dependency) and
-starts the server:
+### Option A — download the app (no Node.js needed)
+
+Grab the standalone binary for your OS from the
+[latest release](https://github.com/chatpanel/chatpanel-bridge/releases/latest) —
+it bundles its own runtime, so **nothing to install**. Run it once to set it up to
+start automatically at login and run in the background:
 
 ```bash
-npx @chatpanel/bridge        # → http://127.0.0.1:4319
+# macOS / Linux (make it executable first on macOS)
+chmod +x chatpanel-bridge-macos-arm64
+./chatpanel-bridge-macos-arm64 --install
+
+# Windows (PowerShell)
+.\chatpanel-bridge-windows-x64.exe --install
 ```
 
-…then leave it running and open the ChatPanel side panel. That's the whole setup.
+That's it — open the ChatPanel side panel and your agents appear. Manage it with
+`--status` (is it set up?) and `--uninstall` (remove auto-start). Run with no flags
+to start it once in the foreground instead.
 
-Prefer a persistent command? Install it globally:
+> Until these binaries are code-signed, macOS Gatekeeper / Windows SmartScreen may
+> warn on first run (on macOS, right-click the file → **Open**). Signing is on the way.
+
+### Option B — via npm (needs Node.js 18+)
 
 ```bash
-npm i -g @chatpanel/bridge
-chatpanel-bridge             # → http://127.0.0.1:4319
+npx @chatpanel/bridge        # → http://127.0.0.1:4319
 ```
 
+…then leave it running and open the ChatPanel side panel. Prefer a persistent
+command? `npm i -g @chatpanel/bridge` then `chatpanel-bridge`.
+
 Prerequisites (the agents you want to use must already be set up):
 
 - **Claude Code**: be signed in (`claude`) or set `ANTHROPIC_API_KEY`.

package/package.json

@@ -1,18 +1,40 @@
 {
   "name": "@chatpanel/bridge",
-  "version": "0.1.2",
+  "version": "0.2.0",
   "type": "module",
   "description": "Local bridge that exposes the AI coding agents installed on your machine — Claude Code (Agent SDK), Codex (CLI), and Gemini CLI — to the ChatPanel Chrome extension over a localhost SSE endpoint. Bring your own agent.",
-  "keywords": ["chatpanel", "claude-code", "codex", "gemini-cli", "chrome-extension", "ai-agents", "bridge"],
+  "keywords": [
+    "chatpanel",
+    "claude-code",
+    "codex",
+    "gemini-cli",
+    "chrome-extension",
+    "ai-agents",
+    "bridge"
+  ],
   "homepage": "https://chatpanel.net",
-  "repository": { "type": "git", "url": "git+https://github.com/chatpanel/chatpanel-bridge.git" },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/chatpanel/chatpanel-bridge.git"
+  },
   "license": "MIT",
-  "bin": { "chatpanel-bridge": "src/server.js" },
-  "files": ["src", "README.md", "LICENSE", ".env.example"],
-  "engines": { "node": ">=18" },
+  "bin": {
+    "chatpanel-bridge": "src/server.js"
+  },
+  "files": [
+    "src",
+    "scripts",
+    "README.md",
+    "LICENSE",
+    ".env.example"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
   "scripts": {
     "start": "node src/server.js",
-    "dev": "node --watch src/server.js"
+    "dev": "node --watch src/server.js",
+    "build:bin": "bash scripts/build-binaries.sh"
   },
   "dependencies": {
     "@anthropic-ai/claude-agent-sdk": "^0.1.0"

package/scripts/build-binaries.sh

@@ -0,0 +1,21 @@
+#!/usr/bin/env bash
+# Compile the bridge into standalone, single-file binaries (no Node required to
+# run them). Needs Bun: https://bun.sh
+set -euo pipefail
+cd "$(dirname "$0")/.."
+mkdir -p dist
+rm -f dist/chatpanel-bridge-*
+
+targets=(
+  "bun-darwin-arm64:chatpanel-bridge-macos-arm64"
+  "bun-darwin-x64:chatpanel-bridge-macos-x64"
+  "bun-linux-x64:chatpanel-bridge-linux-x64"
+  "bun-windows-x64:chatpanel-bridge-windows-x64.exe"
+)
+for t in "${targets[@]}"; do
+  target="${t%%:*}"; out="${t##*:}"
+  echo "→ building dist/$out ($target)"
+  bun build src/server.js --compile --target="$target" --outfile "dist/$out"
+done
+echo "✓ binaries in dist/"
+ls -la dist

package/src/server.js

@@ -18,8 +18,9 @@ import { createServer } from 'node:http';
 import * as claude from './engines/claude.js';
 import * as codex from './engines/codex.js';
 import * as gemini from './engines/gemini.js';
+import { installService, uninstallService, serviceStatus } from './service.js';
 
-const VERSION = '0.1.0';
+const VERSION = '0.2.0';
 const HOST = process.env.CHATPANEL_BRIDGE_HOST || '127.0.0.1';
 const PORT = Number(process.env.CHATPANEL_BRIDGE_PORT) || 4319;
 
@@ -145,11 +146,74 @@ function log(level, msg) {
   fn(`[chatpanel-bridge] ${msg}`);
 }
 
-server.listen(PORT, HOST, async () => {
-  log('info', `listening on http://${HOST}:${PORT}`);
-  for (const [id, { engine, label }] of Object.entries(ENGINES)) {
-    const a = await engine.available().catch(() => ({ ok: false }));
-    log('info', `  ${a.ok ? '✓' : '✕'} ${label}${a.ok ? '' : ' — ' + (a.reason || 'unavailable')}`);
+function startServer() {
+  server.listen(PORT, HOST, async () => {
+    log('info', `listening on http://${HOST}:${PORT}`);
+    for (const [, { engine, label }] of Object.entries(ENGINES)) {
+      const a = await engine.available().catch(() => ({ ok: false }));
+      log('info', `  ${a.ok ? '✓' : '✕'} ${label}${a.ok ? '' : ' — ' + (a.reason || 'unavailable')}`);
+    }
+    log('info', 'Open the ChatPanel side panel; installed agents (Claude Code, Codex, Gemini CLI) appear automatically.');
+  });
+}
+
+function printHelp() {
+  console.log(`ChatPanel Bridge v${VERSION}
+
+Usage:
+  chatpanel-bridge              start the bridge (foreground) on ${HOST}:${PORT}
+  chatpanel-bridge --install    run automatically at login, in the background
+  chatpanel-bridge --uninstall  remove the login auto-start
+  chatpanel-bridge --status     show whether auto-start is set up
+  chatpanel-bridge --version    print the version
+
+Env: CHATPANEL_BRIDGE_HOST, CHATPANEL_BRIDGE_PORT`);
+}
+
+// Handle CLI commands before starting the server. Returns true if a command ran.
+function runCli() {
+  const argv = process.argv;
+  const has = (...flags) => flags.some((f) => argv.includes(f));
+
+  if (has('--help', '-h')) {
+    printHelp();
+    return true;
   }
-  log('info', 'Open the ChatPanel side panel; installed agents (Claude Code, Codex, Gemini CLI) appear automatically.');
-});
+  if (has('--version', '-v')) {
+    console.log(VERSION);
+    return true;
+  }
+  if (has('--install')) {
+    try {
+      installService();
+      log('info', 'Installed. The bridge now starts automatically at login and is running in the background.');
+    } catch (e) {
+      log('error', 'Install failed: ' + (e?.message || e));
+      process.exitCode = 1;
+    }
+    return true;
+  }
+  if (has('--uninstall')) {
+    try {
+      uninstallService();
+      log('info', 'Removed the login auto-start.');
+    } catch (e) {
+      log('error', 'Uninstall failed: ' + (e?.message || e));
+      process.exitCode = 1;
+    }
+    return true;
+  }
+  if (has('--status')) {
+    let on = false;
+    try {
+      on = serviceStatus();
+    } catch (e) {
+      log('error', String(e?.message || e));
+    }
+    log('info', `auto-start: ${on ? 'installed' : 'not installed'}`);
+    return true;
+  }
+  return false;
+}
+
+if (!runCli()) startServer();

package/src/service.js

@@ -0,0 +1,147 @@
+// Background auto-start for the ChatPanel Bridge.
+//
+// So non-technical users never touch a terminal: download the app, run it once
+// with --install, and it launches at login and stays running.
+//
+//   chatpanel-bridge --install     register login auto-start + start now
+//   chatpanel-bridge --uninstall   remove it
+//   chatpanel-bridge --status      is it registered?
+//
+// macOS → LaunchAgent · Windows → Scheduled Task (ONLOGON) · Linux → systemd user.
+
+import os from 'node:os';
+import path from 'node:path';
+import { mkdirSync, writeFileSync, rmSync, existsSync } from 'node:fs';
+import { spawnSync } from 'node:child_process';
+
+const LABEL = 'net.chatpanel.bridge';
+const DISPLAY = 'ChatPanel Bridge';
+
+// The command that launches THIS bridge. A compiled single-file binary launches
+// itself (no args); running under node/bun launches the interpreter + this script.
+export function resolveLaunch() {
+  const exe = process.execPath;
+  const base = path.basename(exe).toLowerCase();
+  const underInterpreter = base.startsWith('node') || base.startsWith('bun');
+  if (underInterpreter && process.argv[1]) {
+    return { program: exe, args: [path.resolve(process.argv[1])] };
+  }
+  return { program: exe, args: [] };
+}
+
+function logPaths() {
+  const dir = path.join(os.homedir(), '.chatpanel');
+  mkdirSync(dir, { recursive: true });
+  return { out: path.join(dir, 'bridge.log'), err: path.join(dir, 'bridge.err.log') };
+}
+
+function run(cmd, args, opts = {}) {
+  return spawnSync(cmd, args, { encoding: 'utf8', ...opts });
+}
+
+// ---------------------------------------------------------------- macOS
+const macPlist = () => path.join(os.homedir(), 'Library', 'LaunchAgents', `${LABEL}.plist`);
+
+function macInstall() {
+  const { program, args } = resolveLaunch();
+  const { out, err } = logPaths();
+  const progArgs = [program, ...args].map((a) => `      <string>${a}</string>`).join('\n');
+  const plist = `<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+  <dict>
+    <key>Label</key><string>${LABEL}</string>
+    <key>ProgramArguments</key>
+    <array>
+${progArgs}
+    </array>
+    <key>RunAtLoad</key><true/>
+    <key>KeepAlive</key><true/>
+    <key>StandardOutPath</key><string>${out}</string>
+    <key>StandardErrorPath</key><string>${err}</string>
+  </dict>
+</plist>
+`;
+  const p = macPlist();
+  mkdirSync(path.dirname(p), { recursive: true });
+  writeFileSync(p, plist);
+  run('launchctl', ['unload', p]); // ignore if not loaded
+  const r = run('launchctl', ['load', '-w', p]);
+  if (r.status !== 0) throw new Error((r.stderr || '').trim() || 'launchctl load failed');
+}
+function macUninstall() {
+  const p = macPlist();
+  run('launchctl', ['unload', '-w', p]);
+  if (existsSync(p)) rmSync(p);
+}
+function macStatus() {
+  return (run('launchctl', ['list']).stdout || '').includes(LABEL);
+}
+
+// ---------------------------------------------------------------- Windows
+const WIN_TASK = 'ChatPanelBridge';
+
+function winInstall() {
+  const { program, args } = resolveLaunch();
+  const tr = [`"${program}"`, ...args.map((a) => `"${a}"`)].join(' ');
+  const r = run('schtasks', ['/Create', '/TN', WIN_TASK, '/TR', tr, '/SC', 'ONLOGON', '/RL', 'LIMITED', '/F']);
+  if (r.status !== 0) throw new Error((r.stderr || '').trim() || 'schtasks create failed');
+  run('schtasks', ['/Run', '/TN', WIN_TASK]); // start now
+}
+function winUninstall() {
+  run('schtasks', ['/Delete', '/TN', WIN_TASK, '/F']);
+}
+function winStatus() {
+  return run('schtasks', ['/Query', '/TN', WIN_TASK]).status === 0;
+}
+
+// ---------------------------------------------------------------- Linux (systemd user)
+const linUnit = () => path.join(os.homedir(), '.config', 'systemd', 'user', 'chatpanel-bridge.service');
+
+function linInstall() {
+  const { program, args } = resolveLaunch();
+  const exec = [program, ...args].map((a) => (/\s/.test(a) ? `"${a}"` : a)).join(' ');
+  const unit = `[Unit]
+Description=${DISPLAY}
+After=network.target
+
+[Service]
+ExecStart=${exec}
+Restart=on-failure
+
+[Install]
+WantedBy=default.target
+`;
+  const p = linUnit();
+  mkdirSync(path.dirname(p), { recursive: true });
+  writeFileSync(p, unit);
+  run('systemctl', ['--user', 'daemon-reload']);
+  const r = run('systemctl', ['--user', 'enable', '--now', 'chatpanel-bridge']);
+  if (r.status !== 0) throw new Error((r.stderr || '').trim() || 'systemctl enable failed');
+}
+function linUninstall() {
+  run('systemctl', ['--user', 'disable', '--now', 'chatpanel-bridge']);
+  const p = linUnit();
+  if (existsSync(p)) rmSync(p);
+}
+function linStatus() {
+  return (run('systemctl', ['--user', 'is-enabled', 'chatpanel-bridge']).stdout || '').trim() === 'enabled';
+}
+
+// ---------------------------------------------------------------- dispatch
+function byPlatform(mac, win, lin) {
+  if (process.platform === 'darwin') return mac();
+  if (process.platform === 'win32') return win();
+  if (process.platform === 'linux') return lin();
+  throw new Error(`Auto-start isn't supported on ${process.platform} yet — run the bridge directly.`);
+}
+
+export function installService() {
+  return byPlatform(macInstall, winInstall, linInstall);
+}
+export function uninstallService() {
+  return byPlatform(macUninstall, winUninstall, linUninstall);
+}
+export function serviceStatus() {
+  return byPlatform(macStatus, winStatus, linStatus);
+}