@polderlabs/bizar 10.25.0 → 10.25.2

package/AGENTS.md

@@ -2,7 +2,7 @@
 
 Bizar Harness is a Claude Code-native, guarded-autonomy harness. It ships project and user-level agents, skills, slash commands, hooks, an MCP server, CLI utilities, and verification scripts. OpenKan is bundled as Bizar’s default durable planning, progression, task, and PRD-goal system; Bizar integrates with it only through the `.ok/` workspace and its supported CLI boundary.
 
-If you are an agent: read this file, inspect `.ok/` with `bizar task list` and `bizar goals list`, then run `make check` before changing code.
+If you are an agent: read this file, inspect `.ok/` with `ok task list` and `ok prd list`, then run `make check` before changing code.
 
 ## Commands
 
@@ -15,9 +15,9 @@ make check-arch               # architectural and removed-surface checks
 make verify-removed-surfaces  # prove deleted subsystems are absent
 make verify-repo-structure    # prove tracked/package paths are clean
 make clean-check              # debug-artifact/static hygiene gate
-bizar task list               # OpenKan task progression
-bizar plan list               # OpenKan plans
-bizar goals list              # OpenKan PRD goals
+ok task list               # OpenKan task progression
+ok plan list               # OpenKan plans
+ok prd list              # OpenKan PRD goals
 make session-start            # lifecycle compatibility target
 make session-end              # lifecycle compatibility target
 ```

package/README.md

@@ -54,9 +54,18 @@ bizar models
 
 Restart Claude Code after installation. The installer adds Bizar's agents, skills, commands, hooks, settings, and the
 default OpenKan planning runtime to your user-level Claude configuration.
+Claude Code itself is installed with Anthropic's native installer; npm is used
+for Bizar and OpenKan, not for the Claude Code CLI.
 It preserves your configured gateway endpoint and credential values during a
 clean reinstall.
 
+On a new interactive install, Bizar also asks for an optional default model,
+whether Claude Code agent teams should be enabled, the OpenKan install
+directory, and whether the current project should receive a `.ok/` workspace.
+OpenKan is installed from npm as `@polderlabs/openkan@latest`; its package-owned
+agent and skill are installed into the same Claude configuration. Use
+`bizar install --yes` for CI or a prompt-free refresh.
+
 For a completely fresh Bizar-managed Claude setup while retaining endpoint and
 authentication settings:
 
@@ -190,6 +199,8 @@ point where an external or difficult-to-reverse decision belongs to you.
 
 ~/.config/bizar/
 ├── installed.json   install record
+├── openkan/          managed @polderlabs/openkan npm runtime
+├── openkan-install.json  selected OpenKan home/package settings
 ├── evidence/        local dispatch and verification evidence
 ├── telemetry/       local routing and rejected-action feedback
 └── worktree-queue.json  completed worktree integration queue
@@ -203,11 +214,14 @@ plane, background daemon, or general-purpose note vault.
 
 | Command | When to use it |
 | --- | --- |
-| `bizar install` | Install or refresh Bizar in your global Claude configuration |
+| `bizar install` | Install or refresh Bizar, OpenKan, and the global Claude configuration |
+| `bizar openkan install` | Refresh the managed `@polderlabs/openkan` npm runtime and its agent/skill |
+| `bizar openkan init` | Initialise `.ok/` planning state in the current project |
 | `bizar models` | Discover and select the models Bizar may dispatch |
 | `bizar doctor` | Diagnose the global installation and provider connectivity |
 | `bizar validate` | Run an install-focused health check |
-| `bizar task` | Inspect or coordinate scoped worktree tasks |
+| `ok task` | Inspect or coordinate scoped worktree tasks (OpenKan-native) |
+| `ok plan` / `ok prd` | Manage OpenKan plans and PRD goals |
 | `bizar worktree-merge --all` | Review and merge completed isolated work, surfacing conflicts |
 | `bizar control snapshot --json` | Read the machine-friendly current harness state |
 | `bizar evidence` | Inspect local dispatch and verification evidence |

package/cli/bin.mjs

@@ -154,7 +154,7 @@ function showHelp() {
 
   Install:
     npm install -g @polderlabs/bizar
-    npm install -g @anthropic-ai/claude-code
+    curl -fsSL https://claude.ai/install.sh | bash
   `);
 }
 
@@ -399,7 +399,7 @@ async function main() {
       dbg('loaded command module:', 'claim');
       const found = await mod.run(cmd, cmdArgs, isHelpRequest);
       if (found === false) {
-        console.error(chalk.red(`  ✗ Usage: bizar claim <subcommand> — run 'bizar claim --help'`));
+        console.error(chalk.red(`  ✗ Usage: ok task claim <task-id> — run 'ok task --help'`));
         process.exit(EXIT_USAGE);
       }
       break;
@@ -415,7 +415,7 @@ async function main() {
       dbg('loaded command module:', 'task');
       const found = await mod.run(cmd, cmdArgs, isHelpRequest);
       if (found === false) {
-        console.error(chalk.red(`  ✗ Usage: bizar task <subcommand> — run 'bizar task --help'`));
+        console.error(chalk.red(`  ✗ Usage: ok task <subcommand> — run 'ok task --help'`));
         process.exit(EXIT_USAGE);
       }
       break;

package/cli/commands/claim.mjs

@@ -3,16 +3,16 @@ import { OpenKanError, runOpenKanOk } from '../openkan.mjs';
 
 function help() {
   process.stdout.write(`
-  bizar claim — claim an OpenKan task lease
+  ok task claim — claim an OpenKan task lease
 
   Usage:
-    bizar claim <task-id> [--who <agent>] [--lease-ms <ms>]
-    bizar claim release <task-id> [--who <agent>]
-    bizar claim heartbeat <task-id> [--who <agent>] [--lease-ms <ms>]
-    bizar claim list [--status <status>] [--json]
+    ok task claim <task-id> [--who <agent>] [--lease-ms <ms>]
+    ok task release <task-id> [--who <agent>]
+    ok task heartbeat <task-id> [--who <agent>] [--lease-ms <ms>]
+    ok task list [--status <status>] [--json]
 
   Claims are OpenKan .ok locks, not feature_list.json annotations. Use
-  \`bizar task update\` for status transitions and \`bizar goals\` for PRDs.
+  \`ok task update\` for status transitions and \`ok prd\` for PRDs.
 `);
 }
 

package/cli/commands/goal-bootstrap.mjs

@@ -9,7 +9,7 @@ function usage() {
   bizar goal-bootstrap — retired compatibility alias
 
   OpenKan PRDs are Bizar's default durable goal system.
-  Use: bizar goals list | bizar goals add <title> | bizar goals update <id> ...
+  Use: ok prd list | ok prd add <title> | ok prd update <id> ...
 `);
 }
 

package/cli/commands/install.mjs

@@ -53,18 +53,23 @@ export function showInstallHelp() {
     while the prior ANTHROPIC_* and BIZAR_* env vars are merged back
     in from the stash.
 
-    1. Installs @polderlabs/bizar via npm (skipped if already current).
-    2. Installs or updates OpenKan from its official installer as Bizar's
-       default durable planning, progression, and PRD-goal runtime.
-    3. Shells to ./install.sh for platform-specific system dependencies.
-    4. Syncs agent files, slash commands, and bundled skills into
+    1. Uses the already-installed @polderlabs/bizar package.
+    2. Installs or updates Claude Code with Anthropic's native installer
+       (never npm) when the native launcher is absent.
+    3. Installs or updates OpenKan from npm as Bizar's default durable
+       planning, progression, and PRD-goal runtime.
+    4. Uses platform dependencies prepared by ./install.sh when invoked
+       through that bootstrap.
+    5. Syncs agent files, slash commands, and bundled skills into
        ~/.claude/ (or $CLAUDE_CONFIG_DIR).
-    5. Registers the Bizar MCP server in ~/.claude/settings.json.
-    6. Wires Claude Code lifecycle hooks (SessionStart / PreToolUse /
+    6. Registers the Bizar MCP server in ~/.claude/settings.json.
+    7. Wires Claude Code lifecycle hooks (SessionStart / PreToolUse /
        PostToolUse / UserPromptSubmit) under ~/.claude/hooks/.
-    7. In a terminal, confirms the install and securely asks for a provider
-       URL and key only when they are not already configured.
-    8. Runs 'bizar doctor' as a post-install health check.
+    8. In a terminal, confirms the install and securely asks for a provider
+       URL and key only when they are not already configured. Fresh setups
+       can also choose a default model, agent teams, OpenKan home, and whether
+       to initialise the current project's .ok/ workspace.
+    9. Runs 'bizar doctor' as a post-install health check.
 
     Provider settings are global (~/.claude/settings.json), so they work from
     every project. Key input is hidden. Use --yes or --non-interactive to skip

package/cli/commands/openkan.mjs

@@ -1,5 +1,5 @@
 import { spawnSync } from 'node:child_process';
-import { executableOnPath, ensureOpenKanProject, installOpenKanPromise, OpenKanError, runOpenKanOk } from '../openkan.mjs';
+import { ensureOpenKanProject, installOpenKanPromise, OpenKanError, resolveOpenKanDashboard, runOpenKanOk } from '../openkan.mjs';
 
 function print(result) {
   if (result.stdout) process.stdout.write(result.stdout);
@@ -12,24 +12,29 @@ function help() {
 bizar openkan — default durable planning and goals surface
 
 Usage:
-  bizar openkan install                 Install OpenKan natively (Node fetch + tar, no curl|bash)
-  bizar openkan init                    Initialise .ok/ in this project
-  bizar openkan task <ok task args...>  Manage durable tasks
-  bizar openkan plan <ok plan args...>  Manage plans and phases
-  bizar openkan goals <ok prd args...>  Manage PRDs, goals, and milestones
-  bizar openkan doctor                  Validate the .ok/ workspace
+  bizar openkan install                 Install @polderlabs/openkan@latest from npm
+  ok init                                Initialise .ok/ in this project
+  ok task <add|list|show|update|...>     Manage durable tasks
+  ok plan <add|list|show|update>         Manage plans and phases
+  ok prd <add|list|show|update>          Manage PRDs, goals, and milestones
+  ok doctor                              Validate the .ok/ workspace
   bizar openkan dashboard [args...]     Forward to the OpenKan dashboard CLI
 
-Shortcuts: \`bizar task\`, \`bizar plan\`, and \`bizar goals\` use this
-same OpenKan workspace. Bizar no longer creates a SQLite task ledger or
+Canonical commands are \`ok task\`, \`ok plan\`, and \`ok prd\`; they use this
+same OpenKan workspace. The Bizar planning aliases remain compatibility-only.
+Bizar no longer creates a SQLite task ledger or
 feature/progress files for live planning.
 `);
 }
 
 function runDashboard(args) {
-  const bin = process.env.BIZAR_OPENKAN_BIN || executableOnPath('openkan');
-  if (!bin) throw new OpenKanError('OPENKAN_NOT_FOUND', 'OpenKan is required. Run `bizar openkan install`.');
-  const result = spawnSync(bin, args, { cwd: process.cwd(), encoding: 'utf8', shell: false });
+  const launcher = resolveOpenKanDashboard();
+  const command = launcher.endsWith('.ts')
+    ? [process.execPath, '--experimental-strip-types', launcher, ...args]
+    : launcher.endsWith('.mjs')
+      ? [process.execPath, launcher, ...args]
+      : [launcher, ...args];
+  const result = spawnSync(command[0], command.slice(1), { cwd: process.cwd(), encoding: 'utf8', shell: false });
   if (result.error) throw result.error;
   print({ ok: result.status === 0, status: result.status ?? 1, stdout: result.stdout || '', stderr: result.stderr || '' });
 }
@@ -40,8 +45,9 @@ export async function run(name, args, isHelpRequest) {
   if (isHelpRequest || !subcommand || subcommand === 'help') { help(); return true; }
   try {
     if (subcommand === 'install') {
-      const result = await installOpenKanPromise();
-      print(result);
+      const result = await installOpenKanPromise({ persistConfig: true });
+      process.stdout.write(`  ✓ ${result.message}\n`);
+      if (result.agent?.skipped) process.stdout.write('  ! OpenKan agent/skill installation was skipped by configuration.\n');
       return true;
     }
     if (subcommand === 'init') {

package/cli/commands/planning.mjs

@@ -3,7 +3,7 @@ import { OpenKanError, runOpenKanOk } from '../openkan.mjs';
 
 function usage(name) {
   const resource = name === 'goals' ? 'prd' : 'plan';
-  process.stdout.write(`\n  bizar ${name} — OpenKan ${resource} lifecycle\n\n  Usage: bizar ${name} <ok ${resource} args...>\n  Run \`bizar openkan ${name} --help\` for the canonical OpenKan surface.\n`);
+  process.stdout.write(`\n  bizar ${name} — compatibility alias for OpenKan ${resource}\n\n  Usage: ok ${resource} <args...>\n  Run \`ok ${resource} --help\` for the canonical OpenKan surface.\n`);
 }
 
 export async function run(name, args, isHelpRequest) {

package/cli/commands/task.mjs

@@ -3,18 +3,18 @@ import { OpenKanError, runOpenKanOk } from '../openkan.mjs';
 
 function help() {
   process.stdout.write(`
-  bizar task — OpenKan-backed task lifecycle
+  ok task — OpenKan-backed task lifecycle
 
   Usage:
-    bizar task add <title> [--owner agent] [--priority p0|p1|p2|p3]
-    bizar task list [--status pending|in_progress|review|done|cancelled] [--json]
-    bizar task show <id> [--json]
-    bizar task claim <id> --owner <agent> [--lease-ms <ms>]
-    bizar task heartbeat <id> --owner <agent> [--lease-ms <ms>]
-    bizar task update <id> --status <status> [--evidence <text>]
-    bizar task complete <id> --owner <agent> --evidence <text>
-    bizar task cancel <id> --owner <agent> --reason <text>
-    bizar task release <id> --owner <agent>
+    ok task add <title> [--owner agent] [--priority p0|p1|p2|p3]
+    ok task list [--status pending|in_progress|review|done|cancelled] [--json]
+    ok task show <id> [--json]
+    ok task claim <id> --owner <agent> [--lease-ms <ms>]
+    ok task heartbeat <id> --owner <agent> [--lease-ms <ms>]
+    ok task update <id> --status <status> [--evidence <text>]
+    ok task complete <id> --owner <agent> --evidence <text>
+    ok task cancel <id> --owner <agent> --reason <text>
+    ok task release <id> --owner <agent>
 
   This is an exact convenience alias for \`ok task\`. OpenKan persists task
   state, scoped ownership, dependencies, evidence, plans, and goals under

package/cli/doctor.mjs

@@ -43,6 +43,7 @@ import {
 } from './commands/validate.mjs';
 import { configuredEnabledModels, listModels, resolveEndpoint } from './commands/models.mjs';
 import { validateNativeWorkflowDirectory } from '../config/workflows/lib/native-contract.mjs';
+import { resolveOpenKanHome, verifyOpenKanRuntime } from './openkan.mjs';
 
 const REQUIRED_RULES = [
   'general.md', 'git.md', 'javascript.md', 'python.md',
@@ -188,6 +189,12 @@ async function checkBizarHome() {
   return `BIZAR_HOME present at ${dir}`;
 }
 
+async function checkOpenKanRuntime() {
+  const home = resolveOpenKanHome();
+  const result = verifyOpenKanRuntime();
+  return `OpenKan ${home} is runnable (${result.launcher})`;
+}
+
 async function checkProviderReachable() {
   const { endpoint, authToken } = resolveEndpoint();
   if (!endpoint) {
@@ -227,6 +234,7 @@ const CHECKS = [
   { name: 'native-workflows-valid',    run: checkNativeWorkflowsInstalled },
   { name: 'tools-on-path',             run: checkToolsAvailable },
   { name: 'bizar-home',                run: checkBizarHome },
+  { name: 'openkan-runtime',           run: checkOpenKanRuntime },
   { name: 'provider-reachable',        run: checkProviderReachable },
 ];
 

package/cli/install/index.mjs

@@ -48,7 +48,7 @@ export async function runInstaller(opts = {}) {
   // via --yes / --non-interactive, and update runs never request credentials.
   let interactive = null;
   if (mode !== 'update' && !dryRun) {
-    interactive = await runInteractiveSetup({ enabled: !yes });
+    interactive = await runInteractiveSetup({ enabled: !yes, cwd: process.cwd() });
     if (!interactive.ok) return { ok: false, interactive };
     if (interactive.cancelled) return { ok: true, cancelled: true, interactive };
   }
@@ -78,7 +78,14 @@ export async function runInstaller(opts = {}) {
   // Always pass `force: true` downstream so `runProvision` re-emits the
   // template-owned keys (permissions.allow wildcards, mcpServers, hooks)
   // into the freshly-empty settings file.
-  const provisionResult = await runProvision({ mode, dryRun, force: true, yes });
+  const provisionResult = await runProvision({
+    mode,
+    dryRun,
+    force: true,
+    yes,
+    openkanHome: interactive?.openkanHome,
+    initializeOpenKanProject: interactive?.initializeOpenKanProject === true,
+  });
 
   // F-183 — post-install health check. Surfaced as a warning rather
   // than a hard failure so a forced install that completes without

package/cli/install/interactive-setup.mjs

@@ -1,8 +1,9 @@
 import { existsSync, readFileSync } from 'node:fs';
 import { homedir } from 'node:os';
-import { join } from 'node:path';
+import { join, resolve } from 'node:path';
 import { Writable } from 'node:stream';
 import { createInterface } from 'node:readline/promises';
+import { resolveOpenKanHome } from '../openkan.mjs';
 
 export function providerSettingsPath(env = process.env) {
   const root = env.CLAUDE_CONFIG_DIR?.trim()
@@ -30,6 +31,16 @@ export function detectProviderConfiguration({ env = process.env, settings = {} }
   return { url, key, missing: [...(!url ? ['url'] : []), ...(!key ? ['key'] : [])] };
 }
 
+export function detectAdvancedConfiguration({ env = process.env, settings = {} } = {}) {
+  const settingsEnv = settings?.env && typeof settings.env === 'object' ? settings.env : {};
+  return {
+    model: env.ANTHROPIC_MODEL?.trim() || settingsEnv.ANTHROPIC_MODEL?.trim() || '',
+    teams: env.CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS?.trim()
+      || settingsEnv.CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS?.trim()
+      || '',
+  };
+}
+
 export function isValidProviderUrl(value) {
   try {
     const parsed = new URL(value);
@@ -67,6 +78,30 @@ function writeLine(output, value = '') {
   output.write(`${value}\n`);
 }
 
+function answer(value) {
+  return typeof value === 'string' ? value.trim() : '';
+}
+
+async function askYesNo(prompt, defaultValue, deps) {
+  while (true) {
+    const suffix = defaultValue ? '[Y/n]' : '[y/N]';
+    const value = answer(await deps.askText(`${prompt} ${suffix} `, deps.io));
+    if (!value) return defaultValue;
+    if (['y', 'yes'].includes(value.toLowerCase())) return true;
+    if (['n', 'no'].includes(value.toLowerCase())) return false;
+    writeLine(deps.output, '  ! Please answer yes or no.');
+  }
+}
+
+function expandHome(value, env) {
+  const home = env.HOME?.trim() || homedir();
+  return value === '~' ? home : value.startsWith('~/') ? join(home, value.slice(2)) : value;
+}
+
+export function isValidOpenKanHome(value) {
+  return Boolean(value && !value.includes('\0'));
+}
+
 /**
  * Guided install preflight. Credentials are placed only in the current
  * process; the provisioner's settings writer persists them globally with the
@@ -77,6 +112,7 @@ export async function runInteractiveSetup({
   input = process.stdin,
   output = process.stdout,
   enabled = true,
+  cwd = process.cwd(),
   readSettings = readProviderSettings,
   askText = askLine,
   askHidden = askSecret,
@@ -89,6 +125,7 @@ export async function runInteractiveSetup({
   }
 
   const detected = detectProviderConfiguration({ env, settings });
+  const advanced = detectAdvancedConfiguration({ env, settings });
   const interactive = enabled && input.isTTY === true && output.isTTY === true;
   if (!interactive) {
     if (detected.missing.length > 0) {
@@ -111,7 +148,7 @@ export async function runInteractiveSetup({
 
   writeLine(output, '');
   writeLine(output, '  Interactive setup');
-  const confirmation = (await askText('  Continue with the installation? [Y/n] ', { input, output })).trim().toLowerCase();
+  const confirmation = answer(await askText('  Continue with the installation? [Y/n] ', { input, output })).toLowerCase();
   if (confirmation === 'n' || confirmation === 'no') {
     writeLine(output, '  Installation cancelled.');
     return { ok: true, interactive: true, cancelled: true, configured: detected.missing.length === 0 };
@@ -121,12 +158,12 @@ export async function runInteractiveSetup({
   let key = detected.key;
   if (url) writeLine(output, `  ✓ Provider URL detected: ${url}`);
   while (!url) {
-    const answer = (await askText('  Provider URL (for example https://gateway.example/v1): ', { input, output })).trim();
-    if (!isValidProviderUrl(answer)) {
+    const value = answer(await askText('  Provider URL (for example https://gateway.example/v1): ', { input, output }));
+    if (!isValidProviderUrl(value)) {
       writeLine(output, '  ! Enter a valid http:// or https:// URL.');
       continue;
     }
-    url = answer.replace(/\/+$/, '');
+    url = value.replace(/\/+$/, '');
   }
 
   if (key) writeLine(output, '  ✓ Provider key detected (hidden)');
@@ -139,5 +176,62 @@ export async function runInteractiveSetup({
   env.BIZAR_MODEL_ROUTER_URL = url;
   env.ANTHROPIC_AUTH_TOKEN = key;
   writeLine(output, '  ✓ Provider configuration ready; the key will be stored in global Claude settings.');
-  return { ok: true, interactive: true, cancelled: false, configured: true, missing: detected.missing };
+
+  // Keep the common already-configured path quick. Fresh provider setup gets
+  // the extra choices that materially affect the first Bizar session.
+  let model = advanced.model;
+  let teams = advanced.teams
+    ? advanced.teams === '1' || advanced.teams.toLowerCase() === 'true'
+    : null;
+  let openkanHome = resolveOpenKanHome({ cwd, env });
+  let initializeOpenKanProject = false;
+  if (detected.missing.length > 0) {
+    if (model) writeLine(output, `  ✓ Default model detected: ${model}`);
+    else {
+      model = answer(await askText('  Default Claude model (optional; press Enter to choose later): ', { input, output }));
+      if (model) writeLine(output, `  ✓ Default model: ${model}`);
+    }
+
+    const teamsEnabled = await askYesNo('  Enable Claude Code agent teams?', true, {
+      askText: async (prompt, io) => askText(prompt, io), io: { input, output }, output,
+    });
+    teams = teamsEnabled;
+    writeLine(output, `  ✓ Agent teams ${teams ? 'enabled' : 'disabled'}.`);
+
+    const homeAnswer = answer(await askText(`  OpenKan install directory [${openkanHome}]: `, { input, output }));
+    if (homeAnswer) {
+      const expanded = expandHome(homeAnswer, env);
+      if (!isValidOpenKanHome(expanded)) {
+        writeLine(output, '  ! OpenKan directory cannot be empty or contain NUL bytes; using the default.');
+      } else {
+        openkanHome = resolve(cwd, expanded);
+      }
+    }
+    writeLine(output, `  ✓ OpenKan will be installed at ${openkanHome}.`);
+
+    const projectHasOpenKan = existsSync(join(cwd, '.ok', 'index.json'));
+    if (projectHasOpenKan) {
+      writeLine(output, '  ✓ OpenKan project workspace already exists.');
+    } else {
+      initializeOpenKanProject = await askYesNo('  Initialise OpenKan planning in this project?', true, {
+        askText: async (prompt, io) => askText(prompt, io), io: { input, output }, output,
+      });
+    }
+  }
+  if (detected.missing.length > 0) {
+    if (model) env.ANTHROPIC_MODEL = model;
+    env.CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS = teams ? '1' : '0';
+  }
+  env.BIZAR_OPENKAN_HOME = openkanHome;
+  return {
+    ok: true,
+    interactive: true,
+    cancelled: false,
+    configured: true,
+    missing: detected.missing,
+    model: model || null,
+    agentTeams: teams,
+    openkanHome,
+    initializeOpenKanProject,
+  };
 }

package/cli/install/paths.mjs

@@ -9,6 +9,7 @@ import chalk from 'chalk';
 import { homedir } from 'node:os';
 import { join } from 'node:path';
 import { resolveClaudeConfigDir } from '../config-paths.mjs';
+import { resolveOpenKanHome } from '../openkan.mjs';
 
 /** Resolve the Claude Code config directory.
  *   1. `process.env.CLAUDE_CONFIG_DIR`
@@ -35,6 +36,7 @@ export const PATHS = {
   hooksDir:      join(CLAUDE_DIR, 'hooks'),
   settingsFile:  join(CLAUDE_DIR, 'settings.json'),
   bizarHome:     BIZAR_HOME,
+  openkanHome:   resolveOpenKanHome(),
   loopsDir:      join(BIZAR_HOME, 'loops'),
   installMarker: join(BIZAR_HOME, 'installed.json'),
 };
@@ -60,6 +62,8 @@ export function printInstallLocations(_opts = {}) {
   console.log(chalk.bold('│') + `  Bizar runtime state   ${PATHS.bizarHome}`.padEnd(69) + chalk.bold('│'));
   console.log(chalk.bold('│') + `    ├─ loops/           autonomous loop state`.padEnd(69) + chalk.bold('│'));
   console.log(chalk.bold('│') + `    └─ installed.json   install manifest (version, hash)`.padEnd(69) + chalk.bold('│'));
+  console.log(chalk.bold('│') + `  OpenKan runtime      ${PATHS.openkanHome}`.padEnd(69) + chalk.bold('│'));
+  console.log(chalk.bold('│') + `    └─ npm package      @polderlabs/openkan@latest + agent/skill`.padEnd(69) + chalk.bold('│'));
   console.log(chalk.bold('│') + ' '.repeat(68) + chalk.bold('│'));
   console.log(chalk.bold('│') + `  Override with: ${dim('CLAUDE_CONFIG_DIR=/path/to/dir')}`.padEnd(69) + chalk.bold('│'));
   console.log(chalk.bold('└──────────────────────────────────────────────────────────────────────┘'));