@polderlabs/bizar 3.9.1 → 3.11.0

package/README.md

@@ -143,7 +143,9 @@ npx bizar
 
 The interactive installer walks you through component selection, agent choice, install mode, API key setup, and auto-restarts opencode.
 
-### Source — git clone (contributors)
+> **Windows users:** the `npm install -g @polderlabs/bizar` command above is the recommended path on Windows. The installer uses `irm | iex` for uv, `py -m pip` for the pip fallback, `taskkill` for forced kills, and JS `setTimeout` instead of `sleep` — so it works on both Windows PowerShell and POSIX shells. See the [Windows](#-windows) section below for prerequisites, known limitations, and the optional graph feature install.
+
+### Source — git clone (Linux/macOS contributors)
 
 ```bash
 git clone git@github.com:DrB0rk/BizarHarness.git
@@ -154,6 +156,50 @@ chmod +x install.sh
 
 Copies agent definitions and config to `~/.config/opencode/`, merges `opencode.json`, and prints next steps. Use this if you want to hack on BizarHarness itself.
 
+> This `install.sh` script is bash-only and does **not** run on Windows natively. Windows contributors should use the npm path above instead.
+
+### Windows
+
+The `bizar` CLI is cross-platform — the npm install runs a Node.js installer that handles `curl | sh` redirects, signal handling, and temp paths on Windows PowerShell automatically.
+
+**Prerequisites**
+
+- [Node.js 18+](https://nodejs.org/) on `PATH`
+- [Python 3.10+](https://www.python.org/downloads/windows/) (only required for the optional `bizar graph` knowledge-graph feature)
+- [Git for Windows](https://git-scm.com/download/win) — only needed if you want to run the bash `install.sh` from a Git Bash shell
+
+**Install**
+
+```powershell
+npm install -g @polderlabs/bizar
+bizar
+```
+
+**Optional: graph feature (knowledge graph + per-project .bizar/)**
+
+The `bizar graph build` subcommand uses [graphify](https://github.com/bretbhomas/graphify). Install uv and graphify from PowerShell:
+
+```powershell
+# Install uv (Python package manager) — Windows-native PowerShell installer
+powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
+
+# Install graphify
+uv tool install graphifyy
+```
+
+Then build the project graph from any repo:
+
+```powershell
+bizar graph build
+```
+
+**Known Windows limitations**
+
+- The `blessed` TUI library may render with quirks inside Windows Terminal; if you see garbled output in the TUI, use the browser UI via `bizar dash start --bg` and open http://localhost:4321 instead.
+- Some shell scripts under `config/skills/embedded-esp-idf/` are bash-only and require Git Bash (or WSL).
+- The bash `install.sh` does not run on Windows cmd/PowerShell; use the `npm install -g` path above.
+- RTK (Rust Token Killer) ships a bash-only installer. On Windows, install it manually via [Cargo](https://github.com/rtk-ai/rtk#installation) or a [prebuilt binary](https://github.com/rtk-ai/rtk/releases), then run `rtk init -g --opencode`.
+
 ### Prerequisites
 
 - [opencode CLI](https://opencode.ai) installed and on `$PATH`

package/cli/bin.mjs

@@ -2,20 +2,17 @@
 /**
  * cli/bin.mjs
  *
- * v3.0.0 — `bizar` runtime CLI.
+ * v3.10.0 — `bizar` runtime CLI.
  *
  * Architecture:
  *   - `bizar` is the core runtime + installer + audit/init/export/update/plan
- *     + service commands.
- *   - The dashboard lives in a separate package, `@polderlabs/bizar-dash`.
- *     If it's installed, `bizar dashboard` / `bizar --web*` will defer to it.
- *     If not, the user is told to install it.
+ *     + service + dash commands.
+ *   - The dashboard lives in `@polderlabs/bizar-dash` as a library.
+ *     Commands live under `bizar dash <subcommand>` (new canonical form).
+ *     `bizar dashboard` is a deprecated alias (still works, prints warning).
  *
- * Subcommands (unchanged from v2.7.0):
- *   install, audit, init, export, plan, update, test-gate, service
- *
- * Flags (unchanged):
- *   --web / --no-web / --web-only / --bg / --detach
+ * Subcommands:
+ *   install, audit, init, export, plan, update, test-gate, service, dash
  */
 import { existsSync } from 'node:fs';
 import { readFileSync } from 'node:fs';
@@ -77,36 +74,34 @@ function showHelp() {
   Bizar — Norse Pantheon Agent System for opencode
 
   Usage:
-    bizar                       Launch the TUI dashboard (auto-runs first-time setup if needed)
-    bizar --web                 Launch TUI + auto-open web dashboard
-    bizar --no-web              Launch TUI only (no browser)
-    bizar --web-only            Web dashboard only (no TUI, in browser)
-    bizar --bg, --detach        Launch web dashboard in background, return to shell
-    bizar install               Run the interactive installer
-    bizar audit                 Run security audit on agent configuration
-    bizar init                  Initialize .bizar/ in current project
-    bizar export [target]       Export agents/rules to another harness
-    bizar plan <subcommand>     Manage visual plans
-    bizar graph                 Per-project knowledge graph (powered by graphify)
-    bizar test-gate             Detect & run the project's test suite
-    bizar update                Update opencode, bizar, and/or bizar-plugin
-    bizar service               Manage the background service daemon
-    bizar dashboard             Launch the web dashboard (uses bizar)
-    bizar --setup               Re-run setup manually (agents, plugin, RTK, Semble, Skills CLI)
-    bizar --check               Print setup status as JSON, exit 1 if setup needed
-    bizar --version             Show package version
-    bizar --help                Show this help
+    bizar <command> [options]
+
+  Commands:
+    install             Run the interactive installer
+    audit               Run security audit on agent configuration
+    init                Initialize .bizar/ in current project
+    export [target]     Export agents/rules to another harness
+    plan <subcommand>  Manage visual plans
+    graph               Per-project knowledge graph (powered by graphify)
+    test-gate           Detect & run the project's test suite
+    update              Update opencode, bizar, and/or bizar-plugin
+    service             Manage the background service daemon
+    dash <subcommand>   Manage the dashboard (start/stop/status/tui)
+
+  Examples:
+    bizar install
+    bizar audit
+    bizar dash start
+    bizar dash start --bg
+    bizar dash stop
+    bizar dash status
+
+  Run \`bizar <command> --help\` for per-command help.
 
   Install:
     npm install -g @polderlabs/bizar          Install globally
-    npm install -g @polderlabs/bizar-dash     Optional companion dashboard
+    npm install -g @polderlabs/bizar-dash     Optional dashboard package
     npm install -g @polderlabs/bizar-plugin   Bizar opencode plugin
-
-  Notes:
-    The TUI is the default command — press 1-8 for tabs, q to quit.
-    \`bizar --bg\` launches the dashboard detached; \`bizar dashboard stop\`
-    terminates it. The web dashboard lives in the \`@polderlabs/bizar-dash\`
-    package — if it's not installed, you'll be prompted to install it.
   `);
 }
 
@@ -181,7 +176,7 @@ function showInstallHelp() {
 
 function showUpdateHelp() {
   console.log(`
-  bizar update — Update opencode, bizar, bizar-dash, and/or bizar-plugin
+  bizar update — Update opencode, bizar, and/or bizar-plugin
 
   Usage:
     bizar update                       Interactive prompt for components
@@ -207,7 +202,7 @@ function showUpdateHelp() {
     • Sends SIGTERM, waits up to 5s, escalates to SIGKILL if needed.
     • Re-runs the install script so the deployed plugin source matches
       the just-upgraded npm version (avoids the version-skew trap).
-    • If the dashboard was running and bizar / bizar-dash were updated,
+    • If the dashboard was running and bizar or dash was updated,
       spawns a fresh detached dashboard process with the new code
       (skipped with --no-restart).
 
@@ -244,19 +239,35 @@ function showServiceHelp() {
   `);
 }
 
-function showDashboardHelp() {
+function showDashHelp() {
   console.log(`
-  bizar dashboard — Launch the web dashboard (uses @polderlabs/bizar-dash)
+  bizar dash — Manage the Bizar dashboard
 
   Usage:
-    bizar dashboard             Start the dashboard
-    bizar dashboard start       Same
-    bizar dashboard stop        Kill the running dashboard
-    bizar dashboard status      Show port + URL
+    bizar dash <subcommand> [options]
 
-  Description:
-    The dashboard lives in a separate package. If it's not installed,
-    you'll see an install hint pointing at @polderlabs/bizar-dash.
+  Subcommands:
+    start [--bg] [--port N]   Start the dashboard (default port 4321)
+    stop                       Stop the running dashboard
+    status                     Show dashboard port and URL
+    tui [--no-web]             Launch the TUI
+
+  Options:
+    --bg                       Detach and run in background (for start)
+    --port N                   Override the default port
+    --no-web                   Skip launching the web UI (for tui)
+
+  Examples:
+    bizar dash start
+    bizar dash start --bg
+    bizar dash stop
+    bizar dash status
+    bizar dash tui
+    bizar dash tui --no-web
+
+  Note:
+    \`bizar dashboard\` is a deprecated alias for \`bizar dash\` and still
+    works, but new code should use \`bizar dash\`.
   `);
 }
 
@@ -420,35 +431,131 @@ async function main() {
   } else if (args[0] === 'service') {
     if (isHelpRequest) showServiceHelp();
     else await runServiceCommand(args[1]);
-  } else if (args[0] === 'dashboard' || args[0] === 'start' || args[0] === 'stop' || args[0] === 'status' || args[0] === 'tui') {
-    if (isHelpRequest) showDashboardHelp();
-    else await delegateToDash(args.slice(1));
-  } else if (args.includes('--bg') || args.includes('--detach')) {
-    // Delegate to bizar-dash
-    await delegateToDash(['--bg']);
-  } else if (args.includes('--web-only')) {
-    await delegateToDash(['--web-only']);
+  } else if (args[0] === 'dash' || args[0] === 'dashboard') {
+    // `bizar dashboard` is a deprecated alias for `bizar dash`
+    if (args[0] === 'dashboard') {
+      console.warn(chalk.yellow('  ⚠ `bizar dashboard` is deprecated, use `bizar dash` instead.'));
+    }
+    const dashArgs = args.slice(1); // everything after 'dash' or 'dashboard'
+    if (dashArgs.length === 0 || isHelpRequest) {
+      showDashHelp();
+    } else {
+      await runDash(dashArgs);
+    }
   } else if (isHelpRequest) {
     showHelp();
   } else {
-    // Default: launch the TUI dashboard. The TUI lives in bizar-dash.
-    const dashPath = await findBizarDash();
-    if (dashPath) {
-      const skipWeb = args.includes('--no-web');
-      const forceWeb = args.includes('--web');
-      const settingAuto = await readAutoLaunchWeb();
-      const launchWeb = !skipWeb && (forceWeb || settingAuto);
-      await delegateToDash(['tui', ...(launchWeb ? [] : ['--no-web'])]);
+    // No args — show help (breaking: previously launched TUI)
+    showHelp();
+    process.exit(1);
+  }
+}
+
+// ── Dashboard subcommand ───────────────────────────────────────────────────────
+
+/**
+ * Parse dash-specific options from an array of args.
+ * Returns { opts, remaining } where opts have --bg / --port stripped.
+ */
+function parseDashOpts(dashArgs) {
+  const opts = { bg: false, port: null, noWeb: false };
+  const remaining = [];
+  for (let i = 0; i < dashArgs.length; i++) {
+    const a = dashArgs[i];
+    if (a === '--bg') {
+      opts.bg = true;
+    } else if (a === '--no-web') {
+      opts.noWeb = true;
+    } else if (a === '--port' && i + 1 < dashArgs.length) {
+      opts.port = Number(dashArgs[i + 1]);
+      i++;
     } else {
-      console.log('The Bizar dashboard is in a separate package:');
-      console.log(chalk.cyan('  npm install -g @polderlabs/bizar-dash'));
-      console.log('');
-      console.log('Or run the installer to set up everything:');
-      console.log(chalk.cyan('  npx -y @polderlabs/bizar install'));
+      remaining.push(a);
     }
   }
+  return { opts, remaining };
 }
 
+/**
+ * Try to load the dashboard CLI module.
+ * Try 1: import via the package exports map (@polderlabs/bizar-dash/dash-cli)
+ * Try 2: file path probing for older installs or dev trees
+ */
+async function loadDashCli() {
+  // Try 1: import via exports map (requires Tyr's package.json changes)
+  try {
+    const mod = await import('@polderlabs/bizar-dash/dash-cli');
+    return mod;
+  } catch (_e) {
+    // fall through to file probing
+  }
+
+  // Try 2: file path probing
+  const { join } = await import('node:path');
+  const { homedir } = await import('node:os');
+  const candidates = [
+    // npm global install
+    join(homedir(), '.npm-global', 'lib', 'node_modules', '@polderlabs', 'bizar-dash', 'src', 'cli.mjs'),
+    // nvm
+    join(homedir(), '.nvm', 'versions', 'node'),
+    // relative to current process
+    join(process.execPath, '..', '..', 'lib', 'node_modules', '@polderlabs', 'bizar-dash', 'src', 'cli.mjs'),
+    // local node_modules
+    join(process.cwd(), 'node_modules', '@polderlabs', 'bizar-dash', 'src', 'cli.mjs'),
+  ];
+
+  const { pathToFileURL } = await import('node:url');
+  for (const p of candidates) {
+    try {
+      const url = pathToFileURL(p).href;
+      const mod = await import(url);
+      return mod;
+    } catch (_e) {
+      // try next
+    }
+  }
+  return null;
+}
+
+/**
+ * Dispatch a dashboard subcommand by loading the dashboard module and
+ * calling the appropriate exported function.
+ */
+async function runDash(dashArgs) {
+  const { opts, remaining } = parseDashOpts(dashArgs);
+  const sub = remaining[0];
+  const subOpts = { ...opts, subArgs: remaining.slice(1) };
+
+  const dashModule = await loadDashCli();
+  if (!dashModule) {
+    console.error(chalk.red('  ✗ Dashboard not installed.'));
+    console.error(chalk.dim('  Run: npm install -g @polderlabs/bizar-dash'));
+    console.error(chalk.dim('  Or: npx -y @polderlabs/bizar install'));
+    process.exit(1);
+  }
+
+  switch (sub) {
+    case 'start':
+      await dashModule.start(subOpts);
+      break;
+    case 'stop':
+      await dashModule.stop(subOpts);
+      break;
+    case 'status':
+      await dashModule.status(subOpts);
+      break;
+    case 'tui':
+      await dashModule.tui(subOpts);
+      break;
+    default:
+      console.error(chalk.red(`  ✗ Unknown subcommand: ${sub}`));
+      showDashHelp();
+      process.exit(1);
+  }
+}
+
+// ── Main ──────────────────────────────────────────────────────────────────────
+
 await main().catch((err) => {
   console.error(chalk.red(`bizar: ${err && err.message ? err.message : String(err)}`));
   process.exit(1);

package/cli/copy.mjs

@@ -356,6 +356,9 @@ export async function installRtk() {
   const spinner = ora({ text: 'Installing RTK (Rust Token Killer)...', color: 'magenta' }).start();
 
   if (process.platform === 'win32') {
+    // RTK ships a bash-only installer; no PowerShell equivalent. On
+    // Windows the user must install RTK manually (e.g. via Cargo or
+    // prebuilt binary) and re-run `rtk init -g --opencode`.
     spinner.fail(chalk.red('Automatic RTK install not supported on Windows. Install manually from https://github.com/rtk-ai/rtk'));
     return false;
   }
@@ -392,13 +395,17 @@ export async function installSemble() {
     spinner.text = 'Installing uv (Python package manager)...';
     try {
       if (process.platform === 'win32') {
-        spinner.fail(chalk.red('Automatic uv install not supported on Windows. Install from https://docs.astral.sh/uv'));
-        return false;
+        // Windows: use the official PowerShell installer
+        execSync(
+          'powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"',
+          { stdio: 'pipe', timeout: 60000 },
+        );
+      } else {
+        execSync(
+          'curl -LsSf https://astral.sh/uv/install.sh | sh',
+          { stdio: 'pipe', timeout: 60000 },
+        );
       }
-      execSync(
-        'curl -LsSf https://astral.sh/uv/install.sh | sh',
-        { stdio: 'pipe', timeout: 60000 },
-      );
       spinner.text = 'Setting up Semble...';
     } catch {
       spinner.fail(chalk.red('uv install failed. Install manually from https://docs.astral.sh/uv'));

package/cli/graph.mjs

@@ -20,13 +20,18 @@ export const GRAPHIFY_OUT_ENV = 'GRAPHIFY_OUT';
 /**
  * Find a Python 3 interpreter on PATH.
  * Returns the absolute path string, or null if none found.
+ *
+ * On Windows the `py` launcher is the most reliable option; on Unix
+ * we prefer python3 then python.
  */
 export function findPython() {
-  // Prefer python3, fall back to python
-  for (const name of ['python3', 'python']) {
+  const candidates = process.platform === 'win32'
+    ? ['py', 'python', 'python3']
+    : ['python3', 'python'];
+  for (const name of candidates) {
     try {
       const result = spawnSync(name, ['--version'], { encoding: 'utf8', timeout: 5000 });
-      if (result.status === 0 && result.stdout.includes('Python 3')) {
+      if (result.status === 0 && result.stdout.includes('Python')) {
         return name;
       }
     } catch {
@@ -37,10 +42,33 @@ export function findPython() {
 }
 
 /**
- * Check whether graphify is available via `python3 -m graphify --version`.
+ * Check whether graphify is available.
+ *
+ * Strategy:
+ *  1. Probe PATH for the `graphify` binary (uv tool install puts a shim at
+ *     ~/.local/bin/graphify — invisible to the isolated python -m lookup).
+ *  2. Fall back to `python -m graphify --version` for pip/pipx installs.
+ *
  * Returns true if available, false otherwise.
  */
 function checkGraphify(python) {
+  // Try 1: check for the graphify binary on PATH (uv tool install shim).
+  // On Windows the Python launcher `py` is not on PATH by default, but the
+  // graphify shim is placed next to pip/pipx so a plain `where` works.
+  const whichCmd = process.platform === 'win32' ? 'where' : 'which';
+  try {
+    const whichResult = spawnSync(whichCmd, ['graphify'], {
+      encoding: 'utf8',
+      timeout: 5000,
+    });
+    if (whichResult.status === 0 && (whichResult.stdout || '').trim().length > 0) {
+      return true;
+    }
+  } catch {
+    // fall through to python -m check
+  }
+
+  // Try 2: check via python -m (catches pip/pipx installs into system python)
   try {
     const result = spawnSync(python, ['-m', 'graphify', '--version'], {
       encoding: 'utf8',
@@ -219,19 +247,33 @@ async function cmdInstall() {
     return 1;
   }
 
-  console.log(chalk.dim('  Installing graphify via pip...\n'));
+  // Prefer uv (handles PEP 668 isolated installs cleanly); fall back to pip.
+  const { detectUv } = await import('./utils.mjs');
+  const hasUv = await detectUv();
 
-  // pip install graphifyy
-  console.log(chalk.dim('  $ pip install graphifyy'));
-  let result = spawnSync('pip', ['install', 'graphifyy'], { stdio: 'inherit' });
-  if (result.status !== 0) {
-    console.log(chalk.red('  ✗ pip install graphifyy failed.\n'));
-    return 1;
+  if (hasUv) {
+    console.log(chalk.dim('  Installing graphify via uv...\n'));
+    const result = spawnSync('uv', ['tool', 'install', 'graphifyy'], { stdio: 'inherit' });
+    if (result.status !== 0) {
+      console.log(chalk.red('  ✗ uv tool install graphifyy failed.\n'));
+      return 1;
+    }
+  } else {
+    console.log(chalk.dim('  Installing graphify via pip...\n'));
+    // On Windows `pip` may not be on PATH; use `py -m pip` as the fallback.
+    const pipCmd = process.platform === 'win32'
+      ? [python, '-m', 'pip']
+      : ['pip'];
+    const result = spawnSync(pipCmd[0], pipCmd.slice(1).concat(['install', 'graphifyy']), { stdio: 'inherit' });
+    if (result.status !== 0) {
+      console.log(chalk.red('  ✗ pip install graphifyy failed.\n'));
+      return 1;
+    }
   }
 
   // graphify install --platform opencode --project
   console.log(chalk.dim('\n  $ graphify install --platform opencode --project'));
-  result = spawnSync('graphify', ['install', '--platform', 'opencode', '--project'], {
+  const result = spawnSync('graphify', ['install', '--platform', 'opencode', '--project'], {
     stdio: 'inherit',
   });
   if (result.status !== 0) {

package/cli/init.mjs

@@ -154,12 +154,22 @@ ${stack.runner ? `- Dev: \`${stack.runner}\`` : ''}
   // Soft step: never fails init. If graphify is missing or build errors,
   // the user can retry manually with `bizar graph build`.
   console.log(chalk.bold('\n--- Graph ---\n'));
-  const detectGraphify = spawnSync('python3', ['-c', 'import graphify; print(graphify.__version__)'], {
-    cwd,
-    encoding: 'utf8',
-    timeout: 5000,
-  });
-  const graphifyAvailable = detectGraphify.status === 0 && (detectGraphify.stdout || '').trim().length > 0;
+
+  // Check for the graphify binary on PATH first (uv tool install shim).
+  // Falls back to python -m for pip/pipx installs.
+  const whichCmd = process.platform === 'win32' ? 'where' : 'which';
+  const whichCheck = spawnSync(whichCmd, ['graphify'], { encoding: 'utf8', timeout: 5000 });
+  let graphifyAvailable = whichCheck.status === 0 && (whichCheck.stdout || '').trim().length > 0;
+
+  if (!graphifyAvailable) {
+    const python = process.platform === 'win32' ? 'py' : 'python3';
+    const detectGraphify = spawnSync(python, ['-c', 'import graphify; print(graphify.__version__)'], {
+      cwd,
+      encoding: 'utf8',
+      timeout: 5000,
+    });
+    graphifyAvailable = detectGraphify.status === 0 && (detectGraphify.stdout || '').trim().length > 0;
+  }
 
   if (!graphifyAvailable) {
     console.log(chalk.yellow('  graphify not detected — skipping project graph build.'));

package/cli/install.mjs

@@ -395,8 +395,12 @@ async function promptGraphifyInstall() {
   console.log();
   sectionHeading('Knowledge Graph (graphify)');
 
-  // 1. Detect graphify already installed
-  const detect = spawnSync('python3', ['-c', 'import graphify; print(graphify.__version__)'], {
+  // 1. Detect graphify already installed. Windows users typically have
+  // `py` on PATH (the Python launcher) rather than `python3`, so probe
+  // the right binary per platform. A failed probe just means we will
+  // prompt to install below.
+  const pythonBin = process.platform === 'win32' ? 'py' : 'python3';
+  const detect = spawnSync(pythonBin, ['-c', 'import graphify; print(graphify.__version__)'], {
     cwd: process.cwd(),
     encoding: 'utf8',
     timeout: 5000,
@@ -408,6 +412,26 @@ async function promptGraphifyInstall() {
     return;
   }
 
+  // Install graphify via pip as a fallback when uv is unavailable or the
+  // user declined the uv-based install. On Windows, `pip` is often not
+  // on PATH, so we invoke it as a `py -m pip` module instead. Returns
+  // the spawn result so the caller can log success/failure.
+  const installGraphifyWithPip = () => {
+    if (process.platform === 'win32') {
+      return spawnSync('py', ['-m', 'pip', 'install', 'graphifyy'], {
+        stdio: 'inherit',
+        timeout: 120000,
+      });
+    }
+    return spawnSync('pip', ['install', 'graphifyy'], {
+      stdio: 'inherit',
+      timeout: 120000,
+    });
+  };
+  const pipManualHint = process.platform === 'win32'
+    ? 'py -m pip install graphifyy'
+    : 'pip install graphifyy';
+
   // 2. Non-interactive: print hint and exit
   if (!stdin.isTTY || !stdout.isTTY) {
     console.log(chalk.dim('  graphify not detected. Install later with:'));
@@ -469,7 +493,12 @@ async function promptGraphifyInstall() {
 
         console.log('  Installing uv...');
         try {
-          execSync('curl -LsSf https://astral.sh/uv/install.sh | sh', { stdio: 'inherit', timeout: 60000 });
+          if (process.platform === 'win32') {
+            // Windows: use the official PowerShell installer
+            execSync('powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"', { stdio: 'inherit', timeout: 60000 });
+          } else {
+            execSync('curl -LsSf https://astral.sh/uv/install.sh | sh', { stdio: 'inherit', timeout: 60000 });
+          }
         } catch (err) {
           console.log(chalk.red(`  uv install failed: ${err.message}`));
           console.log(chalk.dim('  Install manually from https://docs.astral.sh/uv'));
@@ -480,12 +509,12 @@ async function promptGraphifyInstall() {
             rl2.close();
             if (pipAnswer === '' || pipAnswer.startsWith('y')) {
               console.log('  Installing graphify via pip...');
-              const result = spawnSync('pip', ['install', 'graphifyy'], { stdio: 'inherit', timeout: 120000 });
+              const result = installGraphifyWithPip();
               if (result.status === 0) {
                 console.log(chalk.green('  graphify installed. Run `bizar graph build` to populate .bizar/graph/.'));
               } else {
                 console.log(chalk.red(`  pip install failed (exit ${result.status}).`));
-                console.log(chalk.dim('  Install manually: pip install graphifyy'));
+                console.log(chalk.dim(`  Install manually: ${pipManualHint}`));
               }
             } else {
               console.log(chalk.dim('  Skipped.'));
@@ -513,12 +542,12 @@ async function promptGraphifyInstall() {
           rl2.close();
           if (pipAnswer === '' || pipAnswer.startsWith('y')) {
             console.log('  Installing graphify via pip...');
-            const result = spawnSync('pip', ['install', 'graphifyy'], { stdio: 'inherit', timeout: 120000 });
+            const result = installGraphifyWithPip();
             if (result.status === 0) {
               console.log(chalk.green('  graphify installed. Run `bizar graph build` to populate .bizar/graph/.'));
             } else {
               console.log(chalk.red(`  pip install failed (exit ${result.status}).`));
-              console.log(chalk.dim('  Install manually: pip install graphifyy'));
+              console.log(chalk.dim(`  Install manually: ${pipManualHint}`));
             }
           } else {
             console.log(chalk.dim('  Skipped.'));
@@ -578,12 +607,18 @@ export async function runPostInstall() {
   if (!rtkPresent) {
     console.log('BizarHarness: installing RTK (token optimizer)...');
     try {
-      execSync(
-        'curl -fsSL https://raw.githubusercontent.com/rtk-ai/rtk/refs/heads/master/install.sh | sh',
-        { stdio: 'pipe', timeout: 60000 },
-      );
-      execSync('rtk init -g --opencode', { stdio: 'pipe' });
-      console.log('BizarHarness: RTK installed and configured.');
+      if (process.platform === 'win32') {
+        // RTK ships a bash-only installer; on Windows the user installs it
+        // manually (e.g. `cargo install --git https://github.com/rtk-ai/rtk`).
+        console.log('BizarHarness: RTK bash installer does not run on Windows. Install manually from https://github.com/rtk-ai/rtk');
+      } else {
+        execSync(
+          'curl -fsSL https://raw.githubusercontent.com/rtk-ai/rtk/refs/heads/master/install.sh | sh',
+          { stdio: 'pipe', timeout: 60000 },
+        );
+        execSync('rtk init -g --opencode', { stdio: 'pipe' });
+        console.log('BizarHarness: RTK installed and configured.');
+      }
     } catch {
       console.log('BizarHarness: RTK install failed. Install manually from https://github.com/rtk-ai/rtk');
     }
@@ -601,13 +636,21 @@ export async function runPostInstall() {
   if (!semblePresent) {
     console.log('BizarHarness: installing Semble (code search)...');
     try {
-      const hasUv = await detectUv();
-      if (!hasUv) {
+    const hasUv = await detectUv();
+    if (!hasUv) {
+      if (process.platform === 'win32') {
+        // Windows: use the official PowerShell installer
+        execSync(
+          'powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"',
+          { stdio: 'pipe', timeout: 60000 },
+        );
+      } else {
         execSync(
           'curl -LsSf https://astral.sh/uv/install.sh | sh',
           { stdio: 'pipe', timeout: 60000 },
         );
       }
+    }
       execSync('uv tool install "semble[mcp]"', { stdio: 'pipe', timeout: 60000 });
       console.log('BizarHarness: Semble installed.');
     } catch {

package/cli/update.mjs

@@ -121,23 +121,30 @@ export function readLivePid(pidFile) {
  * We treat any successful signal delivery as success; if SIGKILL is
  * sent, the original process is certainly dead (uncatchable).
  *
+ * Cross-platform note: Node.js 14+ maps `process.kill(pid)` without an
+ * explicit signal to the platform-appropriate default (`SIGTERM` on
+ * POSIX, `TerminateProcess` on Windows). We drop the signal argument so
+ * the same code works on both platforms. For the forced-kill phase on
+ * Windows we use `taskkill /F /PID <pid>` because `SIGKILL` is not
+ * delivered the same way there.
+ *
  * Exported for testability.
  */
-export function killAndWait(pid, { timeoutMs = 5000, label = 'process' } = {}) {
+export async function killAndWait(pid, { timeoutMs = 5000, label = 'process' } = {}) {
   if (!pid) return true;
 
-  // Phase 1: graceful SIGTERM
+  // Phase 1: graceful SIGTERM (or platform default on Windows)
   let sigtermOk = false;
   try {
-    process.kill(pid, 'SIGTERM');
+    process.kill(pid);
     sigtermOk = true;
   } catch (err) {
     if (err.code === 'ESRCH') return true; // already dead
-    console.log(chalk.yellow(`    ! could not SIGTERM ${label} (pid ${pid}): ${err.message}`));
+    console.log(chalk.yellow(`    ! could not signal ${label} (pid ${pid}): ${err.message}`));
     return false;
   }
 
-  // Best-effort poll for graceful exit. Note: a SIGTERM-handling process
+  // Best-effort poll for graceful exit. Note: a signal-handling process
   // (Express dashboard, Node sleeper) usually exits within ~100ms. We
   // poll for up to `timeoutMs`; if anything responds to kill -0 it may be
   // a recycled PID, so we don't treat that as "still our process".
@@ -149,7 +156,7 @@ export function killAndWait(pid, { timeoutMs = 5000, label = 'process' } = {}) {
     } catch (err) {
       if (err.code === 'ESRCH') { sawExit = true; break; }
     }
-    spawnSync('sleep', ['0.1']);
+    await new Promise((resolve) => setTimeout(resolve, 100));
   }
 
   if (sawExit) {
@@ -157,20 +164,26 @@ export function killAndWait(pid, { timeoutMs = 5000, label = 'process' } = {}) {
     return true;
   }
 
-  // Phase 2: escalate to SIGKILL. Even if `kill -0` still succeeds (PID
-  // recycled or process truly stuck), SIGKILL is uncatchable and the
-  // original process — if it was still our PID — is now dead.
+  // Phase 2: escalate to forced kill. Even if `kill -0` still succeeds
+  // (PID recycled or process truly stuck), SIGKILL is uncatchable and
+  // the original process — if it was still our PID — is now dead.
+  // On Windows, use `taskkill /F` because POSIX SIGKILL semantics don't
+  // exist there.
   try {
-    process.kill(pid, 'SIGKILL');
+    if (process.platform === 'win32') {
+      spawnSync('taskkill', ['/F', '/T', '/PID', String(pid)], { stdio: 'ignore' });
+    } else {
+      process.kill(pid, 'SIGKILL');
+    }
     if (sigtermOk) {
-      console.log(chalk.yellow(`    ! ${label} (pid ${pid}) did not exit gracefully; sent SIGKILL`));
+      console.log(chalk.yellow(`    ! ${label} (pid ${pid}) did not exit gracefully; sent forced kill`));
     }
     // Brief settle for the kernel.
-    spawnSync('sleep', ['0.2']);
+    await new Promise((resolve) => setTimeout(resolve, 200));
     return true;
   } catch (err) {
     if (err.code === 'ESRCH') return true;
-    console.log(chalk.red(`    ✗ could not SIGKILL ${label} (pid ${pid}): ${err.message}`));
+    console.log(chalk.red(`    ✗ could not force-kill ${label} (pid ${pid}): ${err.message}`));
     return false;
   }
 }
@@ -272,9 +285,16 @@ function rerunInstallScript() {
     return { ok: false, message: 'setup rerun failed' };
   }
   const installSh = join(pkgRoot, 'install.sh');
-  if (process.platform === 'win32' || !existsSync(installSh)) {
+  if (!existsSync(installSh)) {
     return { ok: false, message: 'could not locate a compatible setup script to re-run' };
   }
+  if (process.platform === 'win32') {
+    // On Windows, the bash install path doesn't apply. The plugin is
+    // already installed globally via the npm install
+    // (see cli/install.mjs:installPluginFromGlobal).
+    console.log(chalk.dim('  Skipping install.sh (Windows uses npm-based plugin install)'));
+    return { ok: true, message: 'install.sh skipped on Windows' };
+  }
   console.log(chalk.dim(`\n  Re-running install script at ${installSh}...`));
   const r = spawnSync('bash', [installSh], { stdio: 'inherit' });
   if (r.status !== 0) {
@@ -349,17 +369,17 @@ async function confirmKill(instances, { assumeYes } = {}) {
   }
 }
 
-function killInstances(instances) {
+async function killInstances(instances) {
   const out = [];
   if (instances.service) {
-    const ok = killAndWait(instances.service.pid, { label: 'bizar service' });
+    const ok = await killAndWait(instances.service.pid, { label: 'bizar service' });
     out.push({ name: 'service', ok });
     if (ok) {
       try { rmSync(SERVICE_PID_FILE, { force: true }); } catch { /* ignore */ }
     }
   }
   if (instances.dashboard) {
-    const ok = killAndWait(instances.dashboard.pid, { label: 'bizar-dash' });
+    const ok = await killAndWait(instances.dashboard.pid, { label: 'bizar-dash' });
     out.push({ name: 'dashboard', ok });
     if (ok) {
       try { rmSync(DASHBOARD_PID_FILE, { force: true }); } catch { /* ignore */ }
@@ -428,7 +448,7 @@ async function promptForUpdates(forceAll) {
       choices: [
         { name: 'opencode (the opencode CLI itself)', value: 'opencode', checked: true },
         { name: `bizar (${PKG_MAIN})`, value: 'bizar', checked: true },
-        { name: `bizar-dash (${PKG_DASH}) — web dashboard`, value: 'dash', checked: true },
+        { name: `bizar dash (${PKG_DASH}) — web dashboard`, value: 'dash', checked: true },
         { name: `plugin (${PKG_PLUGIN})`, value: 'plugin', checked: true },
       ],
     },
@@ -460,14 +480,14 @@ export async function runUpdate(subargs = []) {
       process.exit(1);
     }
     console.log(chalk.cyan('\n  Stopping running instances...'));
-    const kills = killInstances(instances);
+    const kills = await killInstances(instances);
     for (const k of kills) {
       const marker = k.ok ? chalk.green('✓') : chalk.red('✗');
       console.log(`    ${marker} ${k.name} stopped`);
     }
     // Give the kernel a moment to release any open file handles on the
     // npm-global directory before npm tries to replace files.
-    spawnSync('sleep', ['0.5']);
+    await new Promise((resolve) => setTimeout(resolve, 500));
   } else {
     console.log(chalk.dim('  No running Bizar instances detected.'));
   }
@@ -565,7 +585,7 @@ export async function runUpdate(subargs = []) {
       console.log(chalk.green(`  ✓ ${res.message}`));
     } else {
       console.log(chalk.yellow(`  ⚠ ${res.message}`));
-      console.log(chalk.dim('    Start it manually with `bizar-dash start --bg`.'));
+      console.log(chalk.dim('    Start it manually with `bizar dash start --bg`.'));
     }
   }
 

package/config/AGENTS.md

@@ -334,7 +334,7 @@ This section is the single source of truth for every Bizar agent's behavior. It
 > | `bash_tool` | `bash` |
 > | `web_search` | `websearch` (opencode built-in) |
 > | `web_fetch` | `webfetch` (opencode built-in) |
-> | `present_files` | not applicable — Bizar delivers files via the dashboard (`bizar-dash/src/server/routes/artifacts.mjs`) or by writing to the workspace |
+> | `present_files` | not applicable — Bizar delivers files via the dashboard (`@polderlabs/bizar-dash/src/server/routes/artifacts.mjs`) or by writing to the workspace |
 > | `image_search` / `places_*` / `weather_fetch` / `recipe_display_v0` / `fetch_sports_data` / `message_compose_v1` / `recommend_claude_apps` | not available in Bizar — do not assume these exist |
 > | `search_mcp_registry` / `suggest_connectors` | use the `skills` CLI (`skills add <owner/repo> -s <name>`) to discover and install skills instead |
 > | `ask_user_input_v0` | Bizar has a `question` tool — same shape, single high-value question |

package/config/commands/bizar.md

@@ -13,6 +13,6 @@ If the user invoked `/bizar` with arguments, treat them as a request and route a
 - "dashboard" or "open dashboard" → `/bizar` (no args, will launch the dashboard)
 - Otherwise: ask one clarifying question
 
-If the user invoked `/bizar` with no arguments, the dashboard is launching in the background. Visit `http://localhost:<port>/` to access it. The plugin's `chat.message` hook spawns `bizar dashboard start` as a detached child process and surfaces the live URL in its response.
+If the user invoked `/bizar` with no arguments, the dashboard is launching in the background. Visit `http://localhost:<port>/` to access it. The plugin's `chat.message` hook spawns `bizar dash start` as a detached child process and surfaces the live URL in its response.
 
-Common ports: 4321 is preferred; if it's taken, the launcher walks upward and picks the next free port. The PID and port are recorded under `~/.config/bizar/dashboard.{pid,port}` so `bizar dashboard stop` and `bizar dashboard status` can find the running instance.
+Common ports: 4321 is preferred; if it's taken, the launcher walks upward and picks the next free port. The PID and port are recorded under `~/.config/bizar/dashboard.{pid,port}` so `bizar dash stop` and `bizar dash status` can find the running instance.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@polderlabs/bizar",
-  "version": "3.9.1",
+  "version": "3.11.0",
   "description": "Norse-pantheon multi-agent system for opencode — 13 agents across 4 cost tiers with cost-aware routing, plans, and a configurable agent harness.",
   "type": "module",
   "bin": {
@@ -33,7 +33,7 @@
     "ora": "^8.1.0"
   },
   "peerDependencies": {
-    "@polderlabs/bizar-dash": ">=3.0.0"
+    "@polderlabs/bizar-dash": "^3.10.0"
   },
   "peerDependenciesMeta": {
     "@polderlabs/bizar-dash": {