@nexus-cortex/cli 4.28.0 → 4.30.0

package/bin/cortex.js

@@ -112,6 +112,86 @@ if (args.includes('--version') || args.includes('-v')) {
   process.exit(0);
 }
 
+// ── Setup wizard (interactive API-key onboarding) ─────────────────
+// Global config lives at ~/.cortex/.env so a global npm install works from ANY
+// folder (the server loads it). Runs on `cortex config init` and on first run
+// when no key is configured anywhere.
+const PROVIDERS = [
+  { name: 'Anthropic (Claude)', keyVar: 'ANTHROPIC_API_KEY', model: 'claude-sonnet-4-6', hint: 'sk-ant-…' },
+  { name: 'OpenAI (GPT)',       keyVar: 'OPENAI_API_KEY',    model: 'gpt-5-mini',        hint: 'sk-…' },
+  { name: 'Google (Gemini)',    keyVar: 'GEMINI_API_KEY',    model: 'gemini-2.5-flash',  hint: 'AIza…' },
+  { name: 'DeepSeek',           keyVar: 'DEEPSEEK_API_KEY',  model: 'deepseek-v4-pro',   hint: 'sk-…' },
+  { name: 'xAI (Grok)',         keyVar: 'XAI_API_KEY',       model: 'grok-4.3',          hint: 'xai-…' },
+];
+const KEY_VARS = [...PROVIDERS.map((p) => p.keyVar), 'GOOGLE_API_KEY'];
+const GLOBAL_ENV = join(homedir(), '.cortex', '.env');
+
+function hasApiKey() {
+  if (KEY_VARS.some((k) => (process.env[k] || '').trim())) return true;
+  for (const f of [GLOBAL_ENV, join(process.cwd(), '.env')]) {
+    try {
+      const txt = readFileSync(f, 'utf8');
+      if (KEY_VARS.some((k) => new RegExp('^' + k + '=\\S', 'm').test(txt))) return true;
+    } catch { /* file absent */ }
+  }
+  return false;
+}
+
+function writeGlobalEnv(kv) {
+  mkdirSync(dirname(GLOBAL_ENV), { recursive: true });
+  let lines = [];
+  try { lines = readFileSync(GLOBAL_ENV, 'utf8').split('\n').filter((l) => l.length); } catch { /* new file */ }
+  for (const [k, v] of Object.entries(kv)) {
+    const i = lines.findIndex((l) => l.startsWith(k + '='));
+    if (i >= 0) lines[i] = `${k}=${v}`; else lines.push(`${k}=${v}`);
+  }
+  writeFileSync(GLOBAL_ENV, lines.join('\n') + '\n', { mode: 0o600 }); // user-only — holds a secret
+}
+
+async function runSetupWizard() {
+  if (!process.stdin.isTTY) {
+    process.stderr.write(
+      '\n  No API key configured. Run `cortex config init` for interactive setup, or set one:\n' +
+      '    export ANTHROPIC_API_KEY=sk-ant-…\n' +
+      '    export DEFAULT_MODEL_ID=claude-sonnet-4-6\n\n',
+    );
+    process.exit(1);
+  }
+  const { createInterface } = await import('node:readline/promises');
+  const rl = createInterface({ input: process.stdin, output: process.stdout });
+  try {
+    process.stdout.write('\n  Welcome to Nexus Cortex — quick setup (~30s).\n\n  Which AI provider?\n');
+    PROVIDERS.forEach((p, i) => process.stdout.write(`    ${i + 1}) ${p.name}\n`));
+    let choice;
+    for (;;) {
+      const n = parseInt((await rl.question(`\n  Choose 1-${PROVIDERS.length}: `)).trim(), 10);
+      if (n >= 1 && n <= PROVIDERS.length) { choice = PROVIDERS[n - 1]; break; }
+      process.stdout.write(`  Please enter a number 1-${PROVIDERS.length}.\n`);
+    }
+    let key = '';
+    while (!key) {
+      key = (await rl.question(`\n  Paste your ${choice.name} API key (${choice.hint}): `)).trim();
+      if (!key) process.stdout.write('  An API key is required.\n');
+    }
+    const model = (await rl.question(`\n  Default model [${choice.model}]: `)).trim() || choice.model;
+    writeGlobalEnv({ [choice.keyVar]: key, DEFAULT_MODEL_ID: model });
+    process.stdout.write(`\n  ✓ Saved to ${GLOBAL_ENV}\n  You're set — try:  cortex "what is 2 + 2?"\n\n`);
+  } catch {
+    // Ctrl-C / Ctrl-D / closed input — exit cleanly instead of dumping a stack trace.
+    process.stdout.write('\n  Setup cancelled. Run `cortex config init` any time to finish.\n');
+    rl.close();
+    process.exit(1);
+  } finally {
+    rl.close();
+  }
+}
+
+// `cortex config init` — interactive setup (intercept before the Commander handoff).
+if (args[0] === 'config' && args[1] === 'init') {
+  await runSetupWizard();
+  process.exit(0);
+}
+
 // ── Headless Commander delegation ─────────────────────────────────
 // `cortex` is primarily the HTTP chat/PR client; the headless Commander program
 // (autoresearch, models, message, mcp, config, …) lives in dist/index.js. If the
@@ -383,6 +463,42 @@ async function fetchJSON(path, options = {}, timeoutMs = 30000) {
 
 // ── Commands ──────────────────────────────────────────────────────
 
+// Interactive chat REPL — `cortex` with no message drops you here so you can talk
+// line-by-line without the shell mangling ?/*/quotes. The server keeps the session,
+// so it's multi-turn. Reuses the same /v1/messages send as the one-shot path.
+async function runInteractiveChat() {
+  if (newSession) {
+    try { await fetchJSON('/sessions/new', { method: 'POST' }); } catch { /* fresh session is best-effort */ }
+  }
+  const { createInterface } = await import('node:readline/promises');
+  const rl = createInterface({ input: process.stdin, output: process.stdout });
+  process.stdout.write(
+    '\n  Nexus Cortex — interactive chat. Type a message and press Enter.\n' +
+    '  The session persists across messages. Type "exit" (or press Ctrl-D) to quit.\n\n',
+  );
+  try {
+    for (;;) {
+      let line;
+      try { line = (await rl.question('cortex> ')).trim(); }
+      catch { break; } // Ctrl-D / closed input
+      if (!line) continue;
+      if (line === 'exit' || line === 'quit' || line === ':q') break;
+      const payload = { messages: [{ role: 'user', content: line }] };
+      if (modelId) payload.model = modelId;
+      try {
+        const data = await fetchJSON('/v1/messages', { method: 'POST', body: JSON.stringify(payload) }, messageTimeoutMs);
+        const text = (data.content || []).filter((b) => b.type === 'text').map((b) => b.text).join('\n');
+        process.stdout.write('\n' + (text || '(no text response)') + '\n\n');
+      } catch (err) {
+        process.stderr.write(`\n  [error] ${err.message}\n\n`);
+      }
+    }
+  } finally {
+    rl.close();
+  }
+  process.stdout.write('  Bye.\n');
+}
+
 async function run() {
   // --shutdown: stop the server and exit
   if (doShutdown) {
@@ -390,6 +506,13 @@ async function run() {
     return;
   }
 
+  // First-run onboarding: no API key anywhere → walk the user through setup before
+  // starting the server. Skipped for pure server-management invocations.
+  const SKIP_SETUP = ['--help', '-h', '--stats', '--sessions', '--tmux'].some((f) => args.includes(f));
+  if (!SKIP_SETUP && !hasApiKey()) {
+    await runSetupWizard();
+  }
+
   await ensureServer();
 
   // --tmux: list active tmux sessions (served by SandboxViewServer on port+1)
@@ -510,9 +633,17 @@ async function run() {
     }
   }
 
-  // Need a prompt for message commands
+  // No message provided. In an interactive terminal (and NOT agent/run mode), drop
+  // into the chat REPL so the shell never mangles ?/*/quotes. agent/run with no task,
+  // or any non-TTY (scripted) use, still gets the usage error — unchanged.
   if (!prompt) {
-    console.error('Usage: cortex "your prompt here"');
+    if (!__agentMode && process.stdin.isTTY) {
+      await runInteractiveChat();
+      return;
+    }
+    console.error(__agentMode
+      ? 'Usage: cortex agent "<task>"   (or cortex run "<task>")'
+      : 'Usage: cortex "your prompt here"');
     console.error('       cortex --help for more options');
     process.exit(1);
   }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nexus-cortex/cli",
-  "version": "4.28.0",
+  "version": "4.30.0",
   "description": "Nexus Cortex CLI - Terminal interface for multi-provider LLM orchestration",
   "main": "dist/index.js",
   "type": "module",
@@ -19,7 +19,7 @@
     "prepack": "node ../../scripts/copy-pkg-cortex-scaffold.mjs"
   },
   "dependencies": {
-    "@nexus-cortex/core": "^4.28.0",
+    "@nexus-cortex/core": "^4.30.0",
     "chalk": "^4.1.2",
     "cli-spinners": "^2.9.0",
     "commander": "^11.0.0",