@polderlabs/bizar 10.0.7 → 10.1.0

package/bizar-dash/src/server/api.mjs

@@ -32,6 +32,7 @@ import { createArtifactsRouter } from './routes/artifacts.mjs';
 import { createSchedulesRouter } from './routes/schedules.mjs';
 import { createModsRouter } from './routes/mods.mjs';
 import { createAgentsRouter } from './routes/agents.mjs';
+import { createModelRouterRouter } from './routes/model-router.mjs';
 import { createBackgroundRouter } from './routes/background.mjs';
 import { createActivityRouter } from './routes/activity.mjs';
 import { createHistoryRouter } from './routes/history.mjs';
@@ -58,7 +59,6 @@ import { createEnvVarsRouter } from './routes/env-vars.mjs';
 import { createUpdateRouter } from './routes/update.mjs';
 import { createSpawnRouter } from './routes/spawn.mjs';
 import { createUsageRouter } from './routes/usage.mjs';
-import { createHeadroomRouter } from './routes/headroom.mjs';
 import { createEvalRouter } from './routes/eval.mjs';
 import { createWorkspacesRouter } from './routes/workspaces.mjs';
 import { createUsersRouter } from './routes/users.mjs';
@@ -125,6 +125,7 @@ export async function createApiRouter({
   router.use(createSchedulesRouter({ broadcast }));
   router.use(createModsRouter());
   router.use(createAgentsRouter({ state, broadcast }));
+  router.use(createModelRouterRouter({ state }));
   router.use(createBackgroundRouter({ broadcast }));
   // Sprint S10 — live CC agents + SSE stream for the dashboard output panel.
   router.use(createCCAgentsRouter({ broadcast }));
@@ -181,11 +182,6 @@ export async function createApiRouter({
   router.use(createArtifactsRouter({ state, broadcast, projectRoot }));
   router.use(createMinimaxRouter({ state, broadcast }));
   router.use(createUsageRouter());
-  // v5.0.0 — Headroom context compression endpoints.
-  // Mounted at /api/headroom/* so the mount-prefix stripping works correctly.
-  // Each route handler inside the router is at its bare path (e.g. '/status'),
-  // which becomes '/api/headroom/status' at the top level.
-  router.use('/headroom', createHeadroomRouter());
   // v5.0.0 — Eval framework endpoints.
   router.use(createEvalRouter({ state, broadcast }));
   // v5.0.0 — Workspace and user management endpoints.

package/bizar-dash/src/server/diagnostics-store.mjs

@@ -119,10 +119,7 @@ export function getRecentErrors({ since = 0, limit = 200 } = {}) {
 }
 
 /**
- * v6.0.0 — Probe the local headroom proxy on `host:port`. Returns a
- * `{ running, port?, error? }` shape so the Doctor page can show a
- * "Headroom proxy on 8787 ✓" line without forcing the route to
- * swallow a 1.5s timeout on every poll.
+ * v6.0.0 — Generic TCP probe used by the Doctor page.
  *
  * @param {string} host
  * @param {number} port
@@ -184,23 +181,6 @@ async function probeLightRAG() {
   }
 }
 
-async function probeHeadroom() {
-  // Headroom's default port — matches headroom.mjs's
-  // DEFAULT_HEADROOM_PORT. Settings override takes precedence.
-  let port = 8787;
-  let host = '127.0.0.1';
-  try {
-    const settingsPath = join(HOME, '.config', 'bizar', 'settings.json');
-    if (existsSync(settingsPath)) {
-      const parsed = JSON.parse(readFileSync(settingsPath, 'utf8'));
-      port = Number(parsed?.headroom?.port) || port;
-      host = String(parsed?.headroom?.host) || host;
-    }
-  } catch { /* ignore */ }
-  const result = await probeTcp(host, port, 800);
-  return { ...result, port, host };
-}
-
 /**
  * v6.0.0 — Probe whether the cline plugin's `serve-info.json` is
  * reachable on disk and parseable. The dashboard reads serve-info to
@@ -321,12 +301,11 @@ async function runConfigChecks() {
 }
 
 /**
- * v6.0.0 — Service health checks. TCP probes for headroom and
- * lightrag (both best-effort), cline plugin file probe, and the
- * dashboard itself (always `ok` — we're running because we got here).
+ * v6.0.0 — Service health checks. TCP probe for lightrag
+ * (best-effort), cline plugin file probe, and the dashboard itself
+ * (always `ok` — we're running because we got here).
  */
 async function runServiceChecks() {
-  const headroom = await probeHeadroom();
   const lightrag = await probeLightRAG();
   const serveInfo = clineServeInfo();
   const checks = [
@@ -335,13 +314,6 @@ async function runServiceChecks() {
       status: 'ok',
       message: `running on pid ${process.pid}, up ${Math.floor(process.uptime())}s`,
     },
-    {
-      name: 'headroom',
-      status: headroom.running ? 'ok' : 'warn',
-      message: headroom.running
-        ? `proxy on ${headroom.host}:${headroom.port}`
-        : `not running on ${headroom.host}:${headroom.port}${headroom.error ? ` (${headroom.error})` : ''}`,
-    },
     {
       name: 'lightrag',
       status: lightrag.running ? 'ok' : 'warn',
@@ -447,7 +419,7 @@ export async function health() {
  *   uptime: number,
  *   memory: NodeJS.MemoryUsage,
  *   disk: { exists: boolean, path: string, sizeBytes: number },
- *   services: { dashboard: object, headroom: object, lightrag: object, cline: object },
+ *   services: { dashboard: object, lightrag: object, cline: object },
  *   counts: ReturnType<typeof collectCounts>,
  *   recentErrors: ReturnType<typeof getRecentErrors>,
  *   configHealth: Array<{ name: string, status: string, message: string }>,
@@ -467,7 +439,6 @@ export async function collectDiagnostics() {
   let status = 'ok';
   if (issues.some((c) => c.status === 'fail')) status = 'fail';
   else if (issues.length > 0) status = 'warn';
-  const headroom = await probeHeadroom();
   const lightrag = await probeLightRAG();
   const serveInfo = clineServeInfo();
   const clineConfig = providersStore.CLINE_JSON;
@@ -505,7 +476,6 @@ export async function collectDiagnostics() {
         logPath: dashboardLogPath,
         logExists: dashboardLogExists,
       },
-      headroom,
       lightrag,
       cline: serveInfo,
     },

package/bizar-dash/src/server/mod-security.mjs

@@ -22,7 +22,7 @@
  *      Path-traversal attacks (e.g. `../`) are blocked.
  *   3. **Subprocess allowlist** — only whitelisted binaries
  *      (`bizar`, `cline`, `python3`, `graphify`, `git`, `node`,
- *      `npm`, `pip`, `pipx`, `uv`, `headroom`) can be spawned. Custom
+ *      `npm`, `pip`, `pipx`, `uv`) can be spawned. Custom
  *      binaries require an explicit `process:spawn:<bin>` permission.
  *   4. **Audit log** — every privileged operation (fs read/write,
  *      process spawn, network fetch) is logged to
@@ -73,7 +73,6 @@ export const ALLOWED_BINARIES = new Set([
   'npm',
   'npx',
   'git',
-  'headroom',
   'jq',
 ]);
 

package/bizar-dash/src/server/providers-store.mjs

@@ -164,7 +164,7 @@ export { readClineJsonCached, invalidateClineJsonCache, CLINE_JSON_CACHE_TTL_MS
 // MAX_ROTATION_ATTEMPTS: bound on the number of times `withKeyRotation`
 // will retry the user's fn with a different key before throwing. With
 // `cooldown` skipping, this matches the typical "1 primary + 1 backup"
-// deployment (2 attempts) with headroom for a 3rd emergency key.
+// deployment (2 attempts) with a 3rd emergency key.
 //
 // ROTATION_ERROR_PATTERNS: substring match against the lowercased error
 // message — used as a fallback when no structured `status` is present

package/bizar-dash/src/server/routes/_shared.mjs

@@ -148,22 +148,6 @@ export const DEFAULT_SETTINGS = {
     baseUrl: 'https://www.minimax.io',
     chatBaseUrl: 'https://api.minimax.io/v1',
   },
-  // v5.0.0 — Headroom context compression integration.
-  // Headroom sits between cline and LLM providers, compressing tool
-  // outputs, logs, RAG chunks, and conversation history by 60–95%.
-  headroom: {
-    enabled: true,
-    autoInstall: true,
-    port: 8787,
-    host: '127.0.0.1',
-    outputShaper: false,
-    telemetry: false,
-    budget: 0,
-    backend: 'anthropic',
-    autoStart: true,
-    autoWrap: true,
-    routeAllProviders: true,
-  },
 };
 
 /**
@@ -190,7 +174,6 @@ export function mergeSettings(existing) {
   merged.agents = { ...DEFAULT_SETTINGS.agents, ...(existing.agents || {}) };
   merged.systemLlm = { ...DEFAULT_SETTINGS.systemLlm, ...(existing.systemLlm || {}) };
   merged.minimax = { ...DEFAULT_SETTINGS.minimax, ...(existing.minimax || {}) };
-  merged.headroom = { ...DEFAULT_SETTINGS.headroom, ...(existing.headroom || {}) };
   // Always use the package version — never let user settings override it
   merged.about.version = DEFAULT_SETTINGS.about.version;
   return merged;

package/bizar-dash/src/server/routes/model-router.mjs

@@ -0,0 +1,103 @@
+/**
+ * src/server/routes/model-router.mjs
+ *
+ * Surfaces the local model-router configuration and live model list.
+ *
+ *   GET /api/model-router                 — full policy + agent→model map
+ *   GET /api/model-router/models          — live model list from the local router
+ *   GET /api/model-router/agents          — agent→model map only
+ *
+ * The local router URL defaults to ANTHROPIC_BASE_URL or
+ * BIZAR_MODEL_ROUTER_URL or `http://localhost:20128/v1`.
+ */
+import { Router } from 'express';
+import { readFile } from 'node:fs/promises';
+import { resolve, dirname } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { wrap } from './_shared.mjs';
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+// .claude/model-router.json — repo root.
+// From src/server/routes/ up to repo root is 3 levels (routes -> server -> src -> repo).
+const ROUTER_POLICY_PATH = resolve(__dirname, '../../../../.claude/model-router.json');
+
+const DEFAULT_ENDPOINT = 'http://localhost:20128/v1';
+
+function resolveEndpoint(state) {
+  const fromEnv =
+    process.env.BIZAR_MODEL_ROUTER_URL ||
+    process.env.ANTHROPIC_BASE_URL ||
+    state?.config?.modelRouterUrl;
+  return (fromEnv || DEFAULT_ENDPOINT).replace(/\/+$/, '');
+}
+
+async function loadPolicy() {
+  try {
+    const raw = await readFile(ROUTER_POLICY_PATH, 'utf8');
+    return JSON.parse(raw);
+  } catch {
+    return {
+      version: '0.0.0',
+      endpoint: DEFAULT_ENDPOINT,
+      tiers: {},
+      agents: {},
+      policies: {},
+    };
+  }
+}
+
+async function fetchLiveModels(endpoint) {
+  try {
+    const res = await fetch(`${endpoint}/models`, {
+      signal: AbortSignal.timeout(2000),
+    });
+    if (!res.ok) return { reachable: false, error: `HTTP ${res.status}` };
+    const body = await res.json();
+    return {
+      reachable: true,
+      endpoint,
+      models: Array.isArray(body?.data) ? body.data : [],
+    };
+  } catch (err) {
+    return {
+      reachable: false,
+      endpoint,
+      error: err instanceof Error ? err.message : String(err),
+    };
+  }
+}
+
+/**
+ * @param {object} deps
+ * @param {object} deps.state
+ * @returns {import('express').Router}
+ */
+export function createModelRouterRouter({ state }) {
+  const router = Router();
+
+  router.get('/model-router', wrap(async (_req, res) => {
+    const policy = await loadPolicy();
+    const endpoint = resolveEndpoint(state);
+    const live = await fetchLiveModels(endpoint);
+    res.json({
+      endpoint,
+      policy,
+      live,
+      agents: policy.agents || {},
+      tiers: policy.tiers || {},
+    });
+  }));
+
+  router.get('/model-router/models', wrap(async (_req, res) => {
+    const endpoint = resolveEndpoint(state);
+    const live = await fetchLiveModels(endpoint);
+    res.json(live);
+  }));
+
+  router.get('/model-router/agents', wrap(async (_req, res) => {
+    const policy = await loadPolicy();
+    res.json({ agents: policy.agents || {}, tiers: policy.tiers || {} });
+  }));
+
+  return router;
+}

package/bizar-dash/src/server/routes/model-router.test.mjs

@@ -0,0 +1,76 @@
+/**
+ * Smoke test for /api/model-router. Verifies:
+ *  - the route resolves and returns the agent→model map
+ *  - live model probe gracefully degrades when the endpoint is unreachable
+ *  - the policy file is read from `.claude/model-router.json`
+ *
+ * Run with: bun test src/server/routes/model-router.test.mjs
+ * or:       node --test src/server/routes/model-router.test.mjs
+ */
+import { test } from 'node:test';
+import assert from 'node:assert/strict';
+import express from 'express';
+import { createModelRouterRouter } from './model-router.mjs';
+
+function buildApp() {
+  const app = express();
+  // Mount under /api to match the dashboard's mount prefix.
+  app.use('/api', createModelRouterRouter({ state: {} }));
+  return app;
+}
+
+async function getJson(app, path) {
+  const server = app.listen(0);
+  try {
+    const port = server.address().port;
+    const res = await fetch(`http://127.0.0.1:${port}${path}`);
+    return { status: res.status, body: await res.json() };
+  } finally {
+    await new Promise((r) => server.close(r));
+  }
+}
+
+test('GET /api/model-router returns agent→model map from .claude/model-router.json', async () => {
+  const app = buildApp();
+  const { status, body } = await getJson(app, '/api/model-router');
+  assert.equal(status, 200);
+  assert.ok(typeof body.endpoint === 'string' && body.endpoint.length > 0, 'endpoint present');
+  assert.ok(body.policy, 'policy present');
+  assert.ok(body.agents, 'agents map present');
+  // Forseti / Baldr / Vidarr must be GPT (premium tier per the routing rules).
+  assert.match(body.agents.forseti.model, /gpt-5\.6-sol/, 'forseti uses premium GPT');
+  assert.match(body.agents.baldr.model, /gpt-5\.6-sol/, 'baldr uses premium GPT');
+  assert.match(body.agents.vidarr.model, /gpt-5\.6-sol/, 'vidarr uses premium GPT');
+  // Tyr + Odin use the high-tier terra model.
+  assert.match(body.agents.tyr.model, /gpt-5\.6-terra/, 'tyr uses high-tier GPT');
+  assert.match(body.agents.odin.model, /gpt-5\.6-terra/, 'odin uses high-tier GPT');
+  // Everyday default agents use MiniMax-M3.
+  assert.equal(body.agents.frigg.model, 'bizar/MiniMax-M3', 'frigg uses default');
+  assert.equal(body.agents.hermod.model, 'bizar/MiniMax-M3', 'hermod uses default');
+  // Vor uses the budget tier.
+  assert.match(body.agents.vor.model, /mimo|deepseek/, 'vor uses budget tier');
+});
+
+test('GET /api/model-router/agents returns just the agents+tiers map', async () => {
+  const app = buildApp();
+  const { status, body } = await getJson(app, '/api/model-router/agents');
+  assert.equal(status, 200);
+  assert.ok(body.agents.thor, 'thor present');
+  assert.ok(body.tiers.default, 'default tier present');
+});
+
+test('GET /api/model-router/models probe handles unreachable endpoint gracefully', async () => {
+  // Override env to a guaranteed-unreachable port.
+  const prev = process.env.BIZAR_MODEL_ROUTER_URL;
+  process.env.BIZAR_MODEL_ROUTER_URL = 'http://127.0.0.1:1';
+  try {
+    const app = buildApp();
+    const { status, body } = await getJson(app, '/api/model-router/models');
+    assert.equal(status, 200);
+    assert.equal(body.reachable, false);
+    assert.ok(typeof body.error === 'string', 'error string present');
+  } finally {
+    if (prev === undefined) delete process.env.BIZAR_MODEL_ROUTER_URL;
+    else process.env.BIZAR_MODEL_ROUTER_URL = prev;
+  }
+});

package/bizar-dash/src/server/server.mjs

@@ -436,32 +436,6 @@ export async function createServer({
     broadcast: localBroadcast,
   });
 
-  // v5.0.0 — Headroom startup hook. Runs after api.mjs is loaded so the
-  // headroom routes are registered. Errors are caught and logged — startup
-  // must not fail if Headroom has issues.
-  //
-  // v10-S9 — opt-out via BIZAR_HEADROOM_AUTOSTART=0. The hook runs
-  // `npm install` + a child process spawn which can take 2-5s on cold
-  // boot. Real users hit this on every dashboard launch; tests hit it
-  // too. Setting the env var skips the install + child-process spawn
-  // entirely. Default behaviour is unchanged (settings.json
-  // `headroom.enabled` still controls).
-  if (/^(0|false|no|off)$/i.test((process.env.BIZAR_HEADROOM_AUTOSTART || '').trim())) {
-    console.log('[bizar-dash] headroom startup skipped (BIZAR_HEADROOM_AUTOSTART=0)');
-  } else {
-    const { headroomStartupHook } = await import('./headroom.mjs');
-    try {
-      const settings = readSettings();
-      if (settings?.data?.headroom) {
-        headroomStartupHook(settings.data.headroom).catch((err) => {
-          console.warn('[bizar-dash] headroomStartupHook error:', err?.message || err);
-        });
-      }
-    } catch (err) {
-      console.warn('[bizar-dash] headroom startup hook skipped:', err?.message || err);
-    }
-  }
-
   // v5.5.2 — Auto-migrate legacy git.repoPath from the old vault location
   // to the new default. Runs before the lightrag hook so git-dependent
   // checks are already correct.
@@ -479,7 +453,7 @@ export async function createServer({
     console.warn('[bizar-dash] git.repoPath migration check failed:', err?.message || err);
   }
 
-  // v5.x — LightRAG startup hook (issue #6). Mirrors the headroom hook:
+  // v5.x — LightRAG startup hook (issue #6).
   // reads config from .bizar/memory.json + env vars, then calls
   // lightragStartupHook() which respects `lightrag.enabled` and the
   // BIZAR_LIGHTRAG_AUTOSTART env override. All errors are caught — the

package/bizar-dash/tests/cli-bugfixes.test.mjs

@@ -86,7 +86,7 @@ describe('B7 — check-deps.mjs which() uses path.join()', () => {
     const { checkDeps } = await import('../../scripts/check-deps.mjs');
     const result = await checkDeps({ strict: false });
     const names = [...result.present, ...result.missing].map(d => d.name);
-    const required = ['node', 'bun', 'cline', 'tmux', 'git', 'python3', 'pip', 'jq', 'gh', 'headroom', 'semble', 'skills'];
+    const required = ['node', 'bun', 'cline', 'tmux', 'git', 'python3', 'pip', 'jq', 'gh', 'semble', 'skills'];
     for (const dep of required) {
       assert.ok(names.includes(dep), `expected ${dep} to be checked`);
     }

package/bizar-dash/tests/cli-error-visibility.test.mjs

@@ -138,7 +138,7 @@ describe('command module null-check produces user-visible error', () => {
     // Count `if (!mod)` checks that follow `importCommand`
     const nullCheckCount = (binSrc.match(/if \(!mod\)/g) || []).length;
     // We have 9 case groups that call importCommand: install/update, service, dash,
-    // minimax, headroom, mod, artifact, memory, usage, and util (utility commands)
+    // minimax, mod, artifact, memory, usage, and util (utility commands)
     assert.ok(
       nullCheckCount >= 9,
       `Expected at least 9 null checks after importCommand, found ${nullCheckCount}`,

package/bizar-dash/tests/cli-refactor.test.mjs

@@ -73,7 +73,6 @@ const COMMAND_FILES = [
   'service',
   'dash',
   'minimax',
-  'headroom',
   'mod',
   'artifact',
   'memory',

package/bizar-dash/tests/diagnostics-store.test.mjs

@@ -151,7 +151,6 @@ describe('collectDiagnostics', () => {
     assert.ok(snap.disk && typeof snap.disk.exists === 'boolean');
     assert.ok(snap.services);
     assert.ok(snap.services.dashboard);
-    assert.ok(snap.services.headroom);
     assert.ok(snap.services.lightrag);
     assert.ok(snap.services.cline);
     assert.ok(snap.counts);

package/cli/bin.mjs

@@ -12,7 +12,7 @@
  *
  * Commands:
  *   install, audit, init, export, artifact, update, test-gate, service, dash,
- *   memory, headroom, minimax, usage, mod, doctor, repair, dev-link, dev-unlink,
+ *   memory, minimax, usage, mod, doctor, repair, dev-link, dev-unlink,
  *   heads-up, bg, agent-browser, agent-browser-up, providers, deploy, plugin,
  *   marketplace, plan, digest, backup, restore, clip, ocr, voice, workspace, eval
  */
@@ -133,7 +133,6 @@ function showHelp() {
     service             Manage the background service daemon
     dash <subcommand>   Manage the dashboard (start/stop/status/cleanup/tui)
     memory <subcommand> Manage project memory (Bizar Memory Service)
-    headroom <subcommand> Manage Headroom context compression
     lightrag <subcommand> Manage the LightRAG knowledge-graph server (status/start/autostart)
     minimax <subcommand>   Manage MiniMax Token Plan integration
     tailscale <subcommand> Manage Tailscale integration (auth, serve, status)
@@ -347,19 +346,6 @@ async function main() {
       break;
     }
 
-    case 'headroom': {
-      const mod = await importCommand('headroom');
-      if (!mod) {
-        console.error(chalk.red(`  ✗ Could not load headroom command module`));
-        process.exit(EXIT_ERROR);
-        return;
-      }
-      dbg('loaded command module:', 'headroom');
-      await mod.run(cmd, cmdArgs, isHelpRequest);
-      dbg('command returned:', cmd);
-      break;
-    }
-
     case 'lightrag': {
       // v5.x — LightRAG management CLI (issue #6).
       // Subcommands: status, start, autostart.

package/cli/cli-commands-validation.test.mjs

@@ -25,7 +25,7 @@ const ALL_COMMANDS = [
   'install', 'update',
   'service',
   'dash', 'dashboard',
-  'minimax', 'tailscale', 'headroom', 'lightrag',
+  'minimax', 'tailscale', 'lightrag',
   'mod', 'usage',
   'deploy', 'plugin', 'marketplace',
   'artifact',

package/cli/commands/lightrag.mjs

@@ -8,7 +8,7 @@
  *                      the current working directory's project. Used by
  *                      `install.sh` and by operators who want to manually
  *                      start LightRAG without opening the dashboard.
- *   start              Alias for `autostart` (matches `headroom start`).
+ *   start              Alias for `autostart`.
  *   status             Print whether the LightRAG server is running.
  *
  * The dashboard server already auto-invokes `lightragStartupHook()` on

package/cli/commands/util.mjs

@@ -120,7 +120,7 @@ export function showDoctorHelp() {
       • plugin path resolves
       • @polderlabs/bizar-plugin is installed globally
       • core agent files are installed (odin, quick, thor, tyr)
-      • headroom / semble / skills on PATH (lenient — at least one)
+      • semble / skills on PATH (lenient — at least one)
       • dashboard reachable (skipped if no port file)
       • provider.minimax block + MiniMax model flags are sane
 

package/cli/copy.mjs

@@ -3,7 +3,7 @@ import { join, dirname } from 'node:path';
 import { homedir } from 'node:os';
 import ora from 'ora';
 import chalk from 'chalk';
-import { repoPath, clineConfigDir, clineAgentsDir, detectRtk, detectSemble, detectUv, detectSkillsCli } from './utils.mjs';
+import { repoPath, clineConfigDir, clineAgentsDir, detectSemble, detectUv, detectSkillsCli } from './utils.mjs';
 
 async function fileExists(path) {
   try {
@@ -341,52 +341,6 @@ export async function installPluginBizar(projectRoot) {
   }
 }
 
-export async function installHeadroom() {
-  const { execSync } = await import('node:child_process');
-
-  const already = await detectRtk();
-  if (already) {
-    const spinner = ora({ text: 'Configuring Headroom for cline...', color: 'magenta' }).start();
-    try {
-      execSync('headroom wrap cline', { stdio: 'pipe' });
-      spinner.succeed(chalk.green('Headroom configured for cline'));
-    } catch {
-      spinner.warn(chalk.yellow('Could not auto-configure Headroom — run `headroom wrap cline` manually'));
-    }
-    return true;
-  }
-
-  const spinner = ora({ text: 'Installing Headroom (context compressor)...', color: 'magenta' }).start();
-
-  if (process.platform === 'win32') {
-    spinner.fail(chalk.red('Automatic Headroom install not supported on Windows. Install manually: pip install "headroom-ai[all]"'));
-    return false;
-  }
-
-  try {
-    execSync(
-      'pip install --user "headroom-ai[all]"',
-      { stdio: 'pipe', timeout: 60000 },
-    );
-    spinner.text = 'Configuring Headroom for cline...';
-    execSync('headroom wrap cline', { stdio: 'pipe' });
-    spinner.succeed(chalk.green('Headroom installed and configured for cline'));
-    return true;
-  } catch {
-    // Fall back to npm
-    try {
-      execSync('npm install -g headroom-ai', { stdio: 'pipe', timeout: 60000 });
-      spinner.text = 'Configuring Headroom for cline...';
-      execSync('headroom wrap cline', { stdio: 'pipe' });
-      spinner.succeed(chalk.green('Headroom installed (npm) and configured for cline'));
-      return true;
-    } catch {
-      spinner.fail(chalk.red('Headroom install failed. Install manually: pip install "headroom-ai[all]" or npm install -g headroom-ai'));
-      return false;
-    }
-  }
-}
-
 export async function installSemble() {
   const { execSync } = await import('node:child_process');
 

package/cli/doctor.mjs

@@ -15,7 +15,7 @@
  *   hooks-wired:             settings.json has PreToolUse/PostToolUse/etc
  *   agent-files-installed:   agent .md files deployed
  *   skill-files-installed:   SKILL.md files deployed
- *   tools-on-path:           at least one of headroom/semble/skills/claude
+ *   tools-on-path:           at least one of semble/skills/claude
  *   memory-vault:            BIZAR_HOME exists (memory subdir lazy)
  *   9router-reachable:       provider gateway responds
  *
@@ -109,13 +109,13 @@ async function checkSkillFilesInstalled() {
 }
 
 /**
- * Lenient: passes if at least one of headroom/semble/skills is on PATH.
+ * Lenient: passes if at least one of semble/skills/claude is on PATH.
  * These are informational — none of them are strictly required for
  * `bizar doctor` to do its job, and missing them shouldn't fail the
  * overall health report.
  */
 async function checkToolsAvailable() {
-  const tools = ['headroom', 'semble', 'skills', 'claude'];
+  const tools = ['semble', 'skills', 'claude'];
   const found = tools.filter(which);
   if (found.length === 0) {
     throw new Error(`none of ${tools.join('/')} on PATH`);

package/cli/install.mjs

@@ -15,8 +15,8 @@ const __dirname = dirname(fileURLToPath(import.meta.url));
 
 import { showBanner, showPantheon, sectionHeading } from './banner.mjs';
 import { promptComponents, promptInstallMode, promptAgents, promptSkillPacks, promptApiKeys, promptConfirmInstall, promptRestartCline } from './prompts.mjs';
-import { detectClaude, detectHeadroom, detectSemble, detectSkillsCli, detectUv, buildSummary, claudeAgentsDir, claudeConfigDir, repoPath } from './utils.mjs';
-import { installAgents, installAgentsMd, installSkill, installClineJson, installBizarFolder, installPluginBizar, installHeadroom, installSemble, installSkillsCli, installCuratedSkills, installRules, installHooks, installCommands, installCommandsBizar, mergeToolsIntoUserConfig } from './copy.mjs';
+import { detectClaude, detectSemble, detectSkillsCli, detectUv, buildSummary, claudeAgentsDir, claudeConfigDir, repoPath } from './utils.mjs';
+import { installAgents, installAgentsMd, installSkill, installClineJson, installBizarFolder, installPluginBizar, installSemble, installSkillsCli, installCuratedSkills, installRules, installHooks, installCommands, installCommandsBizar, mergeToolsIntoUserConfig } from './copy.mjs';
 
 const AGENT_FILES = [
   'odin.md', 'vor.md', 'frigg.md', 'quick.md',
@@ -514,7 +514,7 @@ export async function runPostInstall() {
   // is a thin Claude Code-native bootstrap that:
   //   - copies `config/settings.json` template on first install
   //   - installs agents into `~/.claude/agents/`
-  //   - probes for headroom / semble / skills-cli
+  //   - probes for semble / skills-cli
   //   - installs Headroom via pip or npm
   const { mkdirSync, copyFileSync, existsSync } = await import('node:fs');
   const { execSync } = await import('node:child_process');
@@ -546,40 +546,6 @@ export async function runPostInstall() {
   }
   console.log('BizarHarness: agents installed.');
 
-  // Install Headroom
-  const headroomPresent = await detectHeadroom();
-  if (!headroomPresent) {
-    console.log('BizarHarness: installing Headroom (context compressor)...');
-    try {
-      if (process.platform === 'win32') {
-        console.log('BizarHarness: Automatic Headroom install not supported on Windows. Install manually: pip install "headroom-ai[all]"');
-      } else {
-        execSync(
-          'pip install --user "headroom-ai[all]"',
-          { stdio: 'pipe', timeout: 60000 },
-        );
-        execSync('headroom wrap claude', { stdio: 'pipe' });
-        console.log('BizarHarness: Headroom installed and configured.');
-      }
-    } catch {
-      // Fall back to npm
-      try {
-        execSync('npm install -g headroom-ai', { stdio: 'pipe', timeout: 60000 });
-        execSync('headroom wrap claude', { stdio: 'pipe' });
-        console.log('BizarHarness: Headroom installed (npm) and configured.');
-      } catch {
-        console.log('BizarHarness: Headroom install failed. Install manually: pip install "headroom-ai[all]" or npm install -g headroom-ai');
-      }
-    }
-  } else {
-    try {
-      execSync('headroom wrap claude', { stdio: 'pipe' });
-      console.log('BizarHarness: Headroom configured for claude.');
-    } catch {
-      console.log('BizarHarness: could not configure Headroom. Run `headroom wrap claude` manually.');
-    }
-  }
-
   // Install Semble
   const semblePresent = await detectSemble();
   if (!semblePresent) {