@bike4mind/cli 0.9.2 → 0.10.0

package/README.md

@@ -386,6 +386,11 @@ tail -f ~/.bike4mind/debug/[session-id].txt
 
 This section covers the contributor workflow for hacking on the CLI from a checkout of the monorepo. For end-user installation see [Installation](#installation) above.
 
+### Prerequisites
+
+- **Node.js 24+** and **pnpm 10+** — the repo's `engines` field requires these versions. If you use [corepack](https://nodejs.org/api/corepack.html) (bundled with Node), run `corepack enable` from the repo root and it will activate the exact pnpm version pinned in the root `package.json`.
+- Native-module build tools (Python 3 + a C++ compiler) for `better-sqlite3` and `sharp` — see [Build Requirements](#build-requirements) above.
+
 ### How the bin resolves source vs. built code
 
 `apps/cli/bin/bike4mind-cli.mjs` auto-detects which mode to run in:
@@ -406,16 +411,21 @@ pnpm install
 # 2. Build the @bike4mind/* core packages so the CLI can import their dist/ outputs
 pnpm turbo:core:build
 
-# 3. Make the `b4m` and `bike4mind` commands point at this checkout
+# 3. Ensure pnpm has a global bin directory (once per machine). Without this,
+#    `pnpm link --global` fails with ERR_PNPM_NO_GLOBAL_BIN_DIR. `pnpm setup`
+#    appends PNPM_HOME to your shell profile — open a new shell afterward.
+pnpm setup
+
+# 4. Make the `b4m` and `bike4mind` commands point at this checkout
 cd apps/cli
 pnpm link --global
 
-# 4. Verify
+# 5. Verify
 which b4m
 b4m --version
 ```
 
-After step 3, running `b4m` anywhere on your system executes this working tree. Re-run `pnpm link --global` if you move or rename the repo.
+After step 4, running `b4m` anywhere on your system executes this working tree. Re-run `pnpm link --global` if you move or rename the repo.
 
 ### Editing CLI source (`apps/cli/src/`)
 

package/bin/bike4mind-cli.mjs

@@ -28,6 +28,11 @@ const __filename = fileURLToPath(import.meta.url);
 const __dirname = dirname(__filename);
 const require = createRequire(import.meta.url);
 
+// Read our own package.json so `--version` reports the CLI's version.
+// Without an explicit argument, yargs .version() resolves the version from
+// whichever package.json it discovers first, which is not necessarily ours.
+const { version: cliVersion } = require('../package.json');
+
 // Parse CLI arguments
 const argv = await yargs(hideBin(process.argv))
   .option('verbose', {
@@ -71,6 +76,15 @@ const argv = await yargs(hideBin(process.argv))
     type: 'string',
     description: 'Add local Ollama models to the model picker (e.g. http://localhost:11434)',
   })
+  .option('api-url', {
+    type: 'string',
+    description: 'Set a custom API URL (self-hosted instance) and clear auth tokens, then exit',
+  })
+  .option('reset-api', {
+    type: 'boolean',
+    description: 'Reset the API URL to the Bike4Mind default and clear auth tokens, then exit',
+    default: false,
+  })
   .command('mcp', 'Manage MCP (Model Context Protocol) servers', (yargs) => {
     return yargs
       .command('list', 'List configured MCP servers', {}, async () => {
@@ -117,7 +131,7 @@ const argv = await yargs(hideBin(process.argv))
   .command('doctor', 'Run diagnostic checks on CLI installation')
   .help()
   .alias('help', 'h')
-  .version()
+  .version(cliVersion)
   .alias('version', 'V')
   .parse();
 
@@ -161,6 +175,35 @@ const hasDist = existsSync(distPath);
 const isDev = process.env.NODE_ENV === 'development' ||
               (!hasDist && hasSource);
 
+// Handle --api-url / --reset-api flags
+// These mutate ~/.bike4mind/config.json and exit before any auth flow runs,
+// so devs can recover from a misconfigured customUrl without editing JSON.
+if (argv['reset-api'] || argv['api-url'] !== undefined) {
+  try {
+    let handleApiCommand;
+
+    if (isDev) {
+      const { register } = require('tsx/esm/api');
+      register();
+      const module = await import('../src/commands/apiCommand.ts');
+      handleApiCommand = module.handleApiCommand;
+    } else {
+      const module = await import('../dist/commands/apiCommand.mjs');
+      handleApiCommand = module.handleApiCommand;
+    }
+
+    if (argv['reset-api']) {
+      await handleApiCommand({ mode: 'reset' });
+    } else {
+      await handleApiCommand({ mode: 'set', url: argv['api-url'] });
+    }
+    process.exit(0);
+  } catch (error) {
+    console.error('Error:', error.message);
+    process.exit(1);
+  }
+}
+
 // Handle headless mode (-p / --prompt flag)
 // Must be done after isDev detection to use correct import path
 if (argv.prompt !== undefined) {

package/dist/{BubblewrapRuntime-CUD3bsgG.mjs → BubblewrapRuntime-CkL9-gnG.mjs}

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import { i as isBinaryAvailable, r as expandPath } from "./SandboxRuntimeAdapter-D1RUReNL.mjs";
+import { i as isBinaryAvailable, r as expandPath } from "./SandboxRuntimeAdapter-ChGlxSGQ.mjs";
 import os from "os";
 //#region src/sandbox/runtime/BubblewrapRuntime.ts
 /**