openzoo 0.29.9 → 0.30.0

package/bin/openzoo.js

@@ -19,6 +19,8 @@ usage:
                                          only "Auto". Undo: npx openzoo unblock
   npx openzoo vscode [path]   same, for VS Code
   npx openzoo editor [path]   whichever is installed (Cursor wins if both)
+  npx openzoo claude [dir] [--terminal]   launch Claude on the zoo — desktop app
+                                          by default, --terminal for the Claude Code CLI
   npx openzoo launch <cmd> [args]   launch a TERMINAL Messages API client
                                     (claude, aider...) already pointed at the zoo
   npx openzoo mcp        stdio MCP server (tools: zoo_ask, zoo_bind, zoo_models, zoo_wallet, zoo_contexts)
@@ -69,6 +71,9 @@ async function main() {
     case 'mcp':
       await (await import('../lib/mcp.js')).startMcp();
       break;
+    case 'claude':
+      await (await import('../lib/launch.js')).launchClaude(process.argv.slice(3));
+      break;
     case 'launch': {
       const rest = process.argv.slice(3);
       const [harness, hargs] = [rest[0], rest.slice(1)];

package/lib/launch.js

@@ -10,8 +10,82 @@
  * (`npx openzoo` in another terminal); we check first and say so if not.
  */
 import { spawn } from 'node:child_process';
+import fs from 'node:fs';
+import os from 'node:os';
+import path from 'node:path';
 import { config } from './config.js';
 
+/** Resolve the Claude DESKTOP app binary, platform-agnostically. Spawn the
+ *  binary directly (not `open -a`) so the env — ANTHROPIC_BASE_URL — survives;
+ *  macOS `open` hands off to launchd and drops it. */
+function resolveClaudeDesktop() {
+  const bundles = [
+    '/Applications/Claude.app/Contents/MacOS/Claude',
+    path.join(os.homedir(), 'Applications', 'Claude.app', 'Contents', 'MacOS', 'Claude'),
+  ];
+  for (const b of bundles) { try { fs.accessSync(b, fs.constants.X_OK); return b; } catch { /* next */ } }
+  // Linux/Windows or PATH install.
+  for (const dir of (process.env.PATH || '').split(path.delimiter)) {
+    for (const n of ['claude-desktop', 'Claude']) {
+      const f = path.join(dir, n + (process.platform === 'win32' ? '.exe' : ''));
+      try { fs.accessSync(f, fs.constants.X_OK); return f; } catch { /* next */ }
+    }
+  }
+  return null;
+}
+
+/** Resolve the Claude Code TERMINAL CLI. */
+function resolveClaudeCli() {
+  for (const dir of (process.env.PATH || '').split(path.delimiter)) {
+    const f = path.join(dir, 'claude' + (process.platform === 'win32' ? '.cmd' : ''));
+    try { fs.accessSync(f, fs.constants.X_OK); return f; } catch { /* next */ }
+  }
+  return null;
+}
+
+/**
+ * `npx openzoo claude [dir] [--terminal]` — launch Claude on the zoo.
+ * DEFAULT is the desktop app; `--terminal` (or `-t`) runs the Claude Code CLI.
+ * Both get ANTHROPIC_BASE_URL so inference pays x402.
+ */
+export async function launchClaude(argv) {
+  const base = `http://localhost:${config.port}/v1`;
+  try {
+    const r = await fetch(`${base}/models`, { signal: AbortSignal.timeout(4000) });
+    if (!r.ok) throw new Error(String(r.status));
+  } catch {
+    console.error(`openzoo: no proxy reachable at ${base}\nstart it first:  npx openzoo`);
+    process.exit(1);
+  }
+  const terminal = argv.includes('--terminal') || argv.includes('-t');
+  const rest = argv.filter((a) => a !== '--terminal' && a !== '-t');
+  const env = {
+    ...process.env,
+    ANTHROPIC_BASE_URL: base,
+    ANTHROPIC_API_KEY: process.env.ANTHROPIC_API_KEY || 'sk-openzoo',
+    ANTHROPIC_AUTH_TOKEN: process.env.ANTHROPIC_AUTH_TOKEN || 'sk-openzoo',
+  };
+
+  if (terminal) {
+    const cli = resolveClaudeCli();
+    if (!cli) { console.error('openzoo: `claude` CLI not found on PATH — install Claude Code, or drop --terminal for the desktop app'); process.exit(1); }
+    console.error(`openzoo: Claude Code (terminal) on the zoo — every turn pays x402`);
+    const child = spawn(cli, rest, { stdio: 'inherit', env });
+    child.on('exit', (c) => process.exit(c ?? 0));
+    child.on('error', (e) => { console.error(`openzoo: could not launch claude: ${e.message}`); process.exit(1); });
+    return;
+  }
+
+  const app = resolveClaudeDesktop();
+  if (!app) { console.error('openzoo: Claude desktop app not found — use `npx openzoo claude --terminal` for the CLI'); process.exit(1); }
+  console.error(`openzoo: Claude desktop on the zoo (ANTHROPIC_BASE_URL=${base})`);
+  console.error('         note: the desktop app routes through the zoo only if it honours ANTHROPIC_BASE_URL;');
+  console.error('         --terminal (Claude Code CLI) is the guaranteed-x402 path.');
+  const child = spawn(app, rest, { stdio: 'ignore', env, detached: true });
+  child.on('error', (e) => console.error(`openzoo: could not launch Claude desktop: ${e.message}`));
+  child.unref();
+}
+
 export async function launchHarness(cmd, args) {
   const base = `http://localhost:${config.port}/v1`;
   // Fail early with a clear message rather than letting the harness spew

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "openzoo",
-  "version": "0.29.9",
+  "version": "0.30.0",
   "description": "Local x402-paying proxy + MCP server for openzoo.fun — point any OpenAI-compatible harness (Cursor, Claude Code, aider, SDKs) at localhost and it pays per call from a local burner wallet. Solana and Base rails live; Robinhood experimental.",
   "license": "MIT",
   "type": "module",