@burdenoff/vibe-agent 2.5.0 → 2.7.0

package/README.md

@@ -10,16 +10,16 @@ Remote development environment management CLI with terminal multiplexing, SSH tu
 npm install -g @burdenoff/vibe-agent
 ```
 
-Requires **Node.js >= 18**.
+Requires **Bun >= 1.3**.
 
 ## Quick Start
 
 ```bash
-# Start the agent (auto-detects first run and installs dependencies)
+# Start the agent as a background daemon (default)
 vibe start
 
-# Or start as a background daemon
-vibe start -d
+# Or start in foreground for debugging
+vibe start --foreground
 
 # Verify it's running
 vibe health
@@ -66,8 +66,8 @@ An `.env.example` file is included in the package for reference.
 ### Core Commands
 
 ```bash
-vibe start                      # Start agent (foreground)
-vibe start -d                   # Start as daemon
+vibe start                      # Start as daemon (default)
+vibe start --foreground         # Start in foreground
 vibe start -p 4000              # Start on custom port
 vibe start -n myagent           # Start with instance name
 vibe start --db-path ~/my.db    # Custom database path
@@ -115,18 +115,25 @@ vibe config --set key=value     # Set a config value
 Extend the agent with plugins that add CLI commands, routes, or both.
 
 ```bash
-vibe plugin list                             # List installed plugins
-vibe plugin install @burdenoff/vibe-plugin-ssh  # Install a plugin
-vibe plugin install @burdenoff/vibe-plugin-ai   # Install AI tools plugin
-vibe plugin remove @burdenoff/vibe-plugin-ssh   # Remove a plugin
+vibe plugin list                                # List installed plugins
+vibe plugin install @burdenoff/vibe-plugin-ssh   # Install a plugin
+vibe plugin install @burdenoff/vibe-plugin-ai    # Install AI tools plugin
+vibe plugin remove @burdenoff/vibe-plugin-ssh    # Remove a plugin
+vibe plugin create my-plugin                     # Scaffold a new plugin
+vibe plugin create my-plugin --with-ui           # Scaffold with React UI
+vibe plugin create my-plugin --tag provider      # Set plugin tag
 ```
 
 **Available Plugins:**
 
-| Plugin                       | Description                                            |
-| ---------------------------- | ------------------------------------------------------ |
-| `@burdenoff/vibe-plugin-ssh` | SSH connections & port forwarding                      |
-| `@burdenoff/vibe-plugin-ai`  | AI tool management (Claude Code, Codex, Copilot, etc.) |
+| Plugin                                     | Description                                           |
+| ------------------------------------------ | ----------------------------------------------------- |
+| `@burdenoff/vibe-plugin-ssh`               | SSH connections & port forwarding                     |
+| `@burdenoff/vibe-plugin-ai`                | AI tool detection & prompt management (SQLite + REST) |
+| `@burdenoff/vibe-plugin-session-tmux`      | tmux-based session provider                           |
+| `@burdenoff/vibe-plugin-tunnel-cloudflare` | Cloudflare tunnel provider                            |
+| `@burdenoff/vibe-plugin-ui-ssh`            | Web UI for SSH management                             |
+| `@burdenoff/vibe-plugin-ui-ai`             | Web UI for AI tools & prompt templates                |
 
 ### Tunnel Management
 
@@ -227,24 +234,24 @@ vibe tunnel list --agent-url http://localhost:4000
 
 ## Architecture
 
-The agent runs as a Fastify HTTP server with:
+The agent runs as a Bun + Elysia HTTP server with:
 
-- **SQLite** database for local state (sessions, connections, tunnels, tasks, config)
+- **bun:sqlite** database for local state (sessions, connections, tunnels, tasks, config)
 - **tmux** integration for terminal multiplexing
 - **cloudflared** for secure tunnel management
-- **Plugin system** for extensibility (SSH, AI tools, and custom plugins)
+- **Plugin system** for extensibility (SSH, AI tools, UI plugins, and custom plugins)
 - **WebSocket** proxy for real-time terminal streaming
 - **API key** authentication on all endpoints
-- **Daemon mode** with proper process management (no SIGPIPE crashes)
+- **Daemon mode** by default with proper process management
 
 ### System Dependencies
 
 | Tool        | Purpose               | Required    |
 | ----------- | --------------------- | ----------- |
+| Bun >= 1.3  | Runtime               | Yes         |
 | tmux        | Terminal multiplexing | Yes         |
 | ttyd        | Web-based terminal    | Recommended |
 | cloudflared | Tunnel management     | For tunnels |
-| Node.js 18+ | Runtime               | Yes         |
 
 Run `vibe setup --check` to verify all dependencies.
 
@@ -264,6 +271,8 @@ When the agent is running, it exposes a REST API at `http://localhost:3005/api/`
 - `/api/git/*` - Git repository scanning
 - `/api/bookmarks/*` - Command bookmarks
 - `/api/projects/*` - Project scanning
+- `/api/ai/tools` - AI tool detection
+- `/api/ai/prompts/*` - Prompt template CRUD (via AI plugin)
 
 Authentication: Include `x-agent-api-key` header with your API key.
 
@@ -272,8 +281,8 @@ Authentication: Include `x-agent-api-key` header with your API key.
 ### Development Workflow
 
 ```bash
-# Start agent in the background
-vibe start -d
+# Start agent (daemon mode is the default)
+vibe start
 
 # Set up a dev session
 vibe session create --name frontend --cwd ~/app --command "npm run dev"

package/dist/{app-6d1xq46v.js → app-xz1nde08.js}

@@ -17,7 +17,7 @@ import {
 } from "./index-g8dczzvv.js";
 import {
   PluginManager
-} from "./plugin-system-x4tbwzyq.js";
+} from "./plugin-system-sm1qhmj0.js";
 
 // node_modules/@elysiajs/cors/dist/index.mjs
 var isBun = typeof new Headers()?.toJSON === "function";
@@ -1162,4 +1162,4 @@ async function getPackageVersion() {
 export { createApp };
 
 //# debugId=09014DBE5BA56E4964756E2164756E21
-//# sourceMappingURL=app-6d1xq46v.js.map
+//# sourceMappingURL=app-xz1nde08.js.map

package/dist/cli.js

@@ -33,7 +33,7 @@ import {
 } from "./index-g8dczzvv.js";
 import {
   PluginManager
-} from "./plugin-system-x4tbwzyq.js";
+} from "./plugin-system-sm1qhmj0.js";
 
 // node_modules/commander/lib/error.js
 var require_error = __commonJS((exports) => {
@@ -2145,7 +2145,7 @@ var {
 } = import__.default;
 
 // src/cli.ts
-import { join as join3 } from "path";
+import { join as join4 } from "path";
 
 // src/cli/commands/start.cmd.ts
 import { existsSync } from "fs";
@@ -2228,7 +2228,7 @@ function register(program2) {
         kv("Host", host);
         kv("Database", dbPath);
         blank();
-        const { createApp } = await import("./app-6d1xq46v.js");
+        const { createApp } = await import("./app-xz1nde08.js");
         const appInstance = await createApp({
           port,
           host,
@@ -2502,7 +2502,7 @@ function register8(program2) {
       blank();
       let currentVersion;
       try {
-        const pkg = await import("./package-1bz5z415.js", {
+        const pkg = await import("./package-ah6tacg6.js", {
           with: { type: "json" }
         });
         currentVersion = pkg.default.version || pkg.version;
@@ -2847,6 +2847,310 @@ function register9(program2) {
   });
 }
 
+// src/cli/commands/autostart.cmd.ts
+import { existsSync as existsSync3, mkdirSync as mkdirSync2, writeFileSync as writeFileSync2, unlinkSync as unlinkSync2 } from "fs";
+import { join as join3 } from "path";
+import { homedir as homedir3, platform } from "os";
+function getConfigDir() {
+  return join3(homedir3(), ".vibecontrols");
+}
+function getLogsDir() {
+  return join3(getConfigDir(), "logs");
+}
+function resolveBunPath() {
+  if (process.execPath && process.execPath.includes("bun")) {
+    return process.execPath;
+  }
+  const result = Bun.spawnSync(["which", "bun"]);
+  const path = result.stdout.toString().trim();
+  if (path)
+    return path;
+  throw new Error("Could not find bun binary. Ensure bun is installed and in PATH.");
+}
+function resolveAgentEntryPoint() {
+  return join3(import.meta.dir, "..", "index.js");
+}
+function getSystemdUnitPath(name) {
+  const dir = join3(homedir3(), ".config", "systemd", "user");
+  mkdirSync2(dir, { recursive: true });
+  return join3(dir, `vibecontrols-agent-${name}.service`);
+}
+function generateSystemdUnit(opts) {
+  return `[Unit]
+Description=VibeControls Agent (${opts.name})
+After=network.target
+
+[Service]
+Type=simple
+ExecStart=${opts.bunPath} run ${opts.entryPoint}
+Environment=PORT=${opts.port}
+Environment=DB_PATH=${opts.dbPath}
+Environment=NODE_ENV=production
+Environment=HOME=${homedir3()}
+Environment=PATH=${process.env.PATH}
+WorkingDirectory=${homedir3()}
+Restart=always
+RestartSec=5
+StandardOutput=append:${opts.logFile}
+StandardError=append:${opts.logFile}
+
+[Install]
+WantedBy=default.target
+`;
+}
+async function installSystemd(name, port, dbPath) {
+  const bunPath = resolveBunPath();
+  const entryPoint = resolveAgentEntryPoint();
+  const logFile = join3(getLogsDir(), `${name}.log`);
+  const unitPath = getSystemdUnitPath(name);
+  const serviceName = `vibecontrols-agent-${name}.service`;
+  mkdirSync2(getLogsDir(), { recursive: true });
+  const unit = generateSystemdUnit({
+    name,
+    port,
+    dbPath,
+    bunPath,
+    entryPoint,
+    logFile
+  });
+  writeFileSync2(unitPath, unit);
+  info(`Wrote systemd unit: ${unitPath}`);
+  const cmds = [
+    ["systemctl", "--user", "daemon-reload"],
+    ["systemctl", "--user", "enable", serviceName],
+    ["systemctl", "--user", "start", serviceName]
+  ];
+  for (const cmd of cmds) {
+    const result = Bun.spawnSync(cmd);
+    if (result.exitCode !== 0) {
+      const stderr = result.stderr.toString().trim();
+      warn(`Command failed: ${cmd.join(" ")}${stderr ? ` \u2014 ${stderr}` : ""}`);
+    }
+  }
+  const lingerResult = Bun.spawnSync([
+    "loginctl",
+    "enable-linger",
+    process.env.USER || ""
+  ]);
+  if (lingerResult.exitCode === 0) {
+    info("Enabled user linger (service survives logout)");
+  }
+  success(`Autostart installed for agent '${name}' on port ${port}`);
+  kv("Service", serviceName);
+  kv("Unit file", unitPath);
+  kv("Log file", logFile);
+  blank();
+  info(`Check status: systemctl --user status ${serviceName}`);
+}
+async function uninstallSystemd(name) {
+  const serviceName = `vibecontrols-agent-${name}.service`;
+  const unitPath = getSystemdUnitPath(name);
+  const cmds = [
+    ["systemctl", "--user", "stop", serviceName],
+    ["systemctl", "--user", "disable", serviceName]
+  ];
+  for (const cmd of cmds) {
+    Bun.spawnSync(cmd);
+  }
+  if (existsSync3(unitPath)) {
+    unlinkSync2(unitPath);
+    info(`Removed unit file: ${unitPath}`);
+  }
+  Bun.spawnSync(["systemctl", "--user", "daemon-reload"]);
+  success(`Autostart removed for agent '${name}'`);
+}
+async function statusSystemd(name) {
+  const serviceName = `vibecontrols-agent-${name}.service`;
+  const unitPath = getSystemdUnitPath(name);
+  if (!existsSync3(unitPath)) {
+    info(`Autostart is NOT configured for agent '${name}'`);
+    kv("Expected unit", unitPath);
+    return;
+  }
+  header(`Autostart Status \u2014 ${name}`);
+  kv("Unit file", unitPath);
+  kv("Service", serviceName);
+  blank();
+  const result = Bun.spawnSync(["systemctl", "--user", "status", serviceName]);
+  const output = result.stdout.toString().trim();
+  if (output) {
+    console.log(output);
+  } else {
+    info("Service status unavailable");
+  }
+}
+function getLaunchdPlistPath(name) {
+  const dir = join3(homedir3(), "Library", "LaunchAgents");
+  mkdirSync2(dir, { recursive: true });
+  return join3(dir, `com.vibecontrols.agent.${name}.plist`);
+}
+function generateLaunchdPlist(opts) {
+  return `<?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>com.vibecontrols.agent.${opts.name}</string>
+  <key>ProgramArguments</key>
+  <array>
+    <string>${opts.bunPath}</string>
+    <string>run</string>
+    <string>${opts.entryPoint}</string>
+  </array>
+  <key>EnvironmentVariables</key>
+  <dict>
+    <key>PORT</key>
+    <string>${opts.port}</string>
+    <key>DB_PATH</key>
+    <string>${opts.dbPath}</string>
+    <key>NODE_ENV</key>
+    <string>production</string>
+    <key>HOME</key>
+    <string>${homedir3()}</string>
+    <key>PATH</key>
+    <string>${process.env.PATH}</string>
+  </dict>
+  <key>WorkingDirectory</key>
+  <string>${homedir3()}</string>
+  <key>RunAtLoad</key>
+  <true/>
+  <key>KeepAlive</key>
+  <dict>
+    <key>SuccessfulExit</key>
+    <false/>
+  </dict>
+  <key>StandardOutPath</key>
+  <string>${opts.logFile}</string>
+  <key>StandardErrorPath</key>
+  <string>${opts.logFile}</string>
+  <key>ProcessType</key>
+  <string>Background</string>
+</dict>
+</plist>
+`;
+}
+async function installLaunchd(name, port, dbPath) {
+  const bunPath = resolveBunPath();
+  const entryPoint = resolveAgentEntryPoint();
+  const logFile = join3(getLogsDir(), `${name}.log`);
+  const plistPath = getLaunchdPlistPath(name);
+  mkdirSync2(getLogsDir(), { recursive: true });
+  const plist = generateLaunchdPlist({
+    name,
+    port,
+    dbPath,
+    bunPath,
+    entryPoint,
+    logFile
+  });
+  writeFileSync2(plistPath, plist);
+  info(`Wrote launchd plist: ${plistPath}`);
+  const result = Bun.spawnSync(["launchctl", "load", plistPath]);
+  if (result.exitCode !== 0) {
+    const stderr = result.stderr.toString().trim();
+    warn(`launchctl load failed: ${stderr}`);
+    info("Trying bootstrap method...");
+    const uid = Bun.spawnSync(["id", "-u"]).stdout.toString().trim();
+    Bun.spawnSync(["launchctl", "bootstrap", `gui/${uid}`, plistPath]);
+  }
+  success(`Autostart installed for agent '${name}' on port ${port}`);
+  kv("Plist", plistPath);
+  kv("Log file", logFile);
+}
+async function uninstallLaunchd(name) {
+  const plistPath = getLaunchdPlistPath(name);
+  const label = `com.vibecontrols.agent.${name}`;
+  Bun.spawnSync(["launchctl", "unload", plistPath]);
+  const uid = Bun.spawnSync(["id", "-u"]).stdout.toString().trim();
+  Bun.spawnSync(["launchctl", "bootout", `gui/${uid}/${label}`]);
+  if (existsSync3(plistPath)) {
+    unlinkSync2(plistPath);
+    info(`Removed plist: ${plistPath}`);
+  }
+  success(`Autostart removed for agent '${name}'`);
+}
+async function statusLaunchd(name) {
+  const plistPath = getLaunchdPlistPath(name);
+  const label = `com.vibecontrols.agent.${name}`;
+  if (!existsSync3(plistPath)) {
+    info(`Autostart is NOT configured for agent '${name}'`);
+    kv("Expected plist", plistPath);
+    return;
+  }
+  header(`Autostart Status \u2014 ${name}`);
+  kv("Plist", plistPath);
+  kv("Label", label);
+  blank();
+  const result = Bun.spawnSync(["launchctl", "list"]);
+  const output = result.stdout.toString();
+  const lines = output.split(`
+`).filter((l) => l.includes("vibecontrols"));
+  if (lines.length > 0) {
+    console.log(lines.join(`
+`));
+  } else {
+    info("Service not currently loaded");
+  }
+}
+function register10(program2) {
+  const autostart = program2.command("autostart").description("Configure agent to auto-start on system boot");
+  autostart.command("install").description("Generate and enable system service for auto-start on reboot").option("-n, --name <name>", "Agent instance name", "default").option("-p, --port <port>", "Port to listen on", "3005").option("--db-path <path>", "SQLite database path", "./vibecontrols-agent.db").action(async (opts) => {
+    const os = platform();
+    const port = parseInt(opts.port, 10);
+    header("Installing Autostart");
+    kv("Platform", os);
+    kv("Agent", opts.name);
+    kv("Port", String(port));
+    blank();
+    try {
+      if (os === "linux") {
+        await installSystemd(opts.name, port, opts.dbPath);
+      } else if (os === "darwin") {
+        await installLaunchd(opts.name, port, opts.dbPath);
+      } else {
+        fail(`Autostart is not supported on ${os}. Supported: linux, darwin (macOS).`);
+        process.exit(1);
+      }
+    } catch (err) {
+      fail(`Failed to install autostart: ${err}`);
+      process.exit(1);
+    }
+  });
+  autostart.command("uninstall").description("Stop and remove the system service").option("-n, --name <name>", "Agent instance name", "default").action(async (opts) => {
+    const os = platform();
+    header("Removing Autostart");
+    try {
+      if (os === "linux") {
+        await uninstallSystemd(opts.name);
+      } else if (os === "darwin") {
+        await uninstallLaunchd(opts.name);
+      } else {
+        fail(`Autostart is not supported on ${os}.`);
+        process.exit(1);
+      }
+    } catch (err) {
+      fail(`Failed to uninstall autostart: ${err}`);
+      process.exit(1);
+    }
+  });
+  autostart.command("status").description("Check if autostart is configured and running").option("-n, --name <name>", "Agent instance name", "default").action(async (opts) => {
+    const os = platform();
+    try {
+      if (os === "linux") {
+        await statusSystemd(opts.name);
+      } else if (os === "darwin") {
+        await statusLaunchd(opts.name);
+      } else {
+        fail(`Autostart is not supported on ${os}.`);
+        process.exit(1);
+      }
+    } catch (err) {
+      fail(`Failed to check autostart status: ${err}`);
+      process.exit(1);
+    }
+  });
+}
+
 // src/cli.ts
 if (typeof Bun === "undefined") {
   console.error(`\x1B[31mError:\x1B[0m VibeControls Agent requires the Bun runtime.
@@ -2856,7 +3160,7 @@ if (typeof Bun === "undefined") {
 }
 var packageVersion = "1.0.0";
 try {
-  const packageJsonPath = join3(import.meta.dir, "..", "package.json");
+  const packageJsonPath = join4(import.meta.dir, "..", "package.json");
   const packageJson = await Bun.file(packageJsonPath).json();
   packageVersion = packageJson.version;
 } catch {}
@@ -2871,6 +3175,7 @@ register6(program2);
 register7(program2);
 register8(program2);
 register9(program2);
+register10(program2);
 async function main() {
   const pluginManager = new PluginManager;
   try {
@@ -2913,5 +3218,5 @@ main().catch((err) => {
   process.exit(1);
 });
 
-//# debugId=B3B10A5CB7971CB864756E2164756E21
+//# debugId=E4B4C6E0AF4D6D3B64756E2164756E21
 //# sourceMappingURL=cli.js.map