ventureos 1.0.9 → 1.0.11

package/README.md

@@ -1,161 +1,170 @@
 # VentureOS
 
-**A multi-agent AI framework for structured venture building.**
+**Your AI co-founder. From raw idea to investor-ready pitch — step by step.**
 
-VentureOS guides teams from a raw domain or idea all the way to an investor-ready pitch — through a structured 12-week incubation process powered by specialized AI agents.
+VentureOS gives you a team of AI specialists that guide you through building a startup: researching the market, finding real customer problems, designing your solution, stress-testing your business model, and preparing your pitch. It follows a proven 12-week process so nothing gets skipped.
 
 ---
 
-## Getting Started
+## What you need before starting
 
-**Requirements:** Node.js 18+ — [download here](https://nodejs.org) if you don't have it.
+**1. Node.js** (a small program that runs VentureOS)
+- Check if you already have it: open your terminal and type `node --version`
+- If you see a number like `v20.x.x` you're good
+- If not, download it free at [nodejs.org](https://nodejs.org) → click the big green "LTS" button → install it like any app
 
-### Step 1 — Create a project folder and install VentureOS inside it
+**2. An AI tool** — pick whichever you have:
 
-Open your terminal and run:
+| You have this | You need |
+|---|---|
+| Cursor, Windsurf, or Antigravity | Nothing else — they include AI |
+| Claude Code | Nothing else — it includes AI |
+| None of the above | An API key (explained below) |
 
-```bash
-mkdir my-venture && cd my-venture
-npx ventureos install
-```
+> **Don't have any of these?** Antigravity is free and takes 2 minutes to install: [antigravity.dev](https://antigravity.dev)
 
-> **Important:** always run this inside a project folder. VentureOS installs a `ventureOS/` directory in whatever folder you are in when you run the command.
+---
 
-The installer asks a few questions (your name, AI tool, research depth, execution mode), then sets up the full framework in under 30 seconds.
+## Get started
 
-### Step 2 — Start a session
+Open your terminal, create a folder for your project, and run one command:
 
 ```bash
-npx ventureos start
+mkdir my-venture
+cd my-venture
+npx ventureos
 ```
 
-Launches an interactive terminal chat with Victor — no copy-pasting files. Connects directly to the LLM API of your choice.
+That's it. VentureOS will detect what AI tools you have, ask you a few quick questions, and tell you exactly how to start.
 
-Supports **Claude (Anthropic)**, **ChatGPT (OpenAI)**, and **Gemini (Google)**. Set your API key as an environment variable to skip the prompt on future sessions:
+> **What's a terminal?**
+> On Mac: press `Cmd + Space`, type "Terminal", press Enter.
+> On Windows: press the Windows key, type "cmd", press Enter.
 
-```bash
-export ANTHROPIC_API_KEY=your-key   # for Claude
-export OPENAI_API_KEY=your-key      # for ChatGPT
-export GOOGLE_API_KEY=your-key      # for Gemini
+---
+
+## What happens when you run it
+
+**VentureOS scans your computer** and finds any AI tools you already have.
+
+**Then it routes you to the best experience:**
+
+### If you have Cursor, Windsurf, Antigravity, or Claude Code
+
+VentureOS installs itself and gives you one line to type in your AI tool:
+
+```
+@ventureOS/venture-master.md
 ```
 
-**If you use Claude Code, Cursor, or Windsurf**, you can also load VentureOS directly in your AI tool instead of using the terminal — see [SETUP.md](SETUP.md) for instructions.
+Type that in your AI chat panel and Victor — your AI co-founder — introduces himself and takes it from there. No API keys. No extra setup.
+
+### If you have an API key
+
+VentureOS asks which service (Claude, ChatGPT, or Gemini), walks you through entering your key, and launches the chat for you directly in the terminal.
+
+**No key yet?** VentureOS will show you a link to get one. If you get stuck, it never just crashes — it always gives you options.
 
 ---
 
-## What VentureOS Does
+## Changing your settings later
 
-- Tracks where your venture is in the incubation journey
-- Routes you to the right specialist agent for each phase
-- Generates first drafts of every deliverable so you never start from a blank page
-- Enforces evidence-based progression: guiding questions must be answered before advancing
-- Manages two decision gates where ventures are evaluated for continuation, pivot, or kill
+```bash
+npx ventureos config
+```
+
+Change your name, research depth, execution mode, or AI provider anytime — without starting over.
 
 ---
 
-## How It Works
+## Meet Victor and your AI team
+
+When you start a session, **Victor** greets you. He's the orchestrator — think of him as your main point of contact. He knows where you are in the journey, what's been done, and what comes next.
 
-VentureOS is a collection of AI agent files and workflow files that you load into your preferred AI coding assistant. The agents collaborate through a shared venture state file to guide you through the full incubation lifecycle.
+When you need deep specialist work, Victor brings in the right expert:
 
-**Entry points:**
-- **Domain exploration** — You have a domain (e.g., "energy management"). VentureOS maps the opportunity landscape first, then moves into incubation.
-- **Idea development** — You have a specific idea. VentureOS jumps directly into incubation.
+| Specialist | What they do |
+|---|---|
+| **Diana** | Researches your market — competitors, trends, opportunities |
+| **Clara** | Helps you find and validate real customer pain |
+| **Paulo** | Designs your product wedge and early solution |
+| **Bernard** | Builds your business model and revenue logic |
+| **Fiona** | Sizes the market and builds your financial model |
+| **Eva** | Plays the tough investor — stress-tests your venture |
+| **Petra** | Creates your pitch deck and investor narrative |
+| **Grace** | Builds your go-to-market and growth strategy |
+| **Olivia** | Sets up your team structure and operations |
 
-**Final output:** Investor-ready pitch deck (Markdown + Excalidraw) or a documented pivot/kill decision with full rationale and archived artifacts.
+You talk to Victor. He calls in the right specialist at the right time.
 
 ---
 
-## The Incubation Journey (12 Weeks)
+## The journey (12 weeks)
+
+VentureOS follows a structured process so you always know where you are and what's next.
 
 ```
-Week 1          Weeks 2-3           Weeks 4-7              Weeks 10-12
-┌──────────┐   ┌──────────────┐   ┌────────────────────┐  ┌──────────────────┐
-│ SETUP    │   │ UNDERSTAND   │   │ DEFINE SOLUTION    │  │ DESIGN BUSINESS  │
-│ THE TEAM │   │ THE MARKET   │   │                    │  │                  │
-└──────────┘   │              │   │                    │  │                  │
-               │ FIND         │   │ BUILD INITIAL      │  │                  │
-               │ CUSTOMER     │──▶│ BUSINESS CASE      │──▶│                  │
-               │ PAIN         │   │                    │  │                  │
-               └──────────────┘   └──────┬─────────────┘  └────────┬─────────┘
-                                         │                          │
-                                    CHECK-IN PITCH             FINAL PITCH
-                                    to Venture Board           to Venture Board
-                                    (Go/Pivot/Kill)            (Go/Pivot/Kill)
+Week 1          Weeks 2–3          Weeks 4–7          Weeks 8–12
+──────────      ─────────────      ─────────────      ─────────────
+Set up          Understand         Design your        Build the
+your team   →   the market    →    solution      →    business
+                Find customer
+                problems
+                               ↓                  ↓
+                           CHECK-IN           FINAL PITCH
+                           with board         to investors
+                           (Go/Pivot/Kill)    (Go/Pivot/Kill)
 ```
 
----
+At each phase, VentureOS generates documents for you — market maps, interview guides, business model canvases, pitch decks — so you never start from a blank page.
 
-## The Agents
-
-| Agent | Name | Role |
-|-------|------|------|
-| `venture-master.md` | Victor | Orchestrator — load this first |
-| `agents/domain-explorer.md` | Diana | Market & domain research |
-| `agents/customer-discovery.md` | Clara | Customer pain & interviews |
-| `agents/product-strategist.md` | Paulo | Wedge design & prototyping |
-| `agents/business-architect.md` | Bernard | Business model & revenue |
-| `agents/financial-analyst.md` | Fiona | Market sizing & financial modeling |
-| `agents/venture-evaluator.md` | Eva | Venture Board gate evaluation |
-| `agents/pitch-master.md` | Petra | Pitch deck creation |
-| `agents/growth-strategist.md` | Grace | GTM & market experiments |
-| `agents/venture-ops.md` | Olivia | Team setup & parent org alignment |
+Everything is saved automatically. Come back tomorrow and Victor picks up exactly where you left off.
 
 ---
 
-## Directory Structure
+## Two ways to work
 
-```
-ventureOS/
-├── venture-master.md          ← START HERE — load this file first
-├── workflow-engine.md         ← Workflow execution engine
-├── config.yaml                ← Your configuration (edit before first use)
-├── README.md                  ← This file
-├── SETUP.md                   ← Installation guide
-├── agents/                    ← Specialist agents (loaded on demand)
-│   ├── domain-explorer.md
-│   ├── customer-discovery.md
-│   ├── product-strategist.md
-│   ├── business-architect.md
-│   ├── financial-analyst.md
-│   ├── venture-evaluator.md
-│   ├── pitch-master.md
-│   ├── growth-strategist.md
-│   └── venture-ops.md
-├── workflows/                 ← Phase-specific workflow definitions
-│   ├── 0-explore/
-│   ├── 1-setup-team/
-│   ├── 2-understand-market/
-│   ├── 3-find-pain/
-│   ├── 4-define-solution/
-│   ├── 5-business-case/
-│   ├── 6-design-business/
-│   └── venture-status/
-├── templates/                 ← Output document templates (30+)
-├── scoring/                   ← Gate rubric, pain scoring, pivot triggers
-├── techniques/                ← Brainstorming techniques, synthetic tools
-└── _memory/
-    └── venture-state.yaml     ← Active venture state (auto-managed)
-```
+**Guided mode** (default) — Victor pauses after each step, shows you the output, and asks for your approval before moving on. Best for real ventures where decisions matter.
 
-Outputs are saved to: `_ventures/{venture_name}/`
+**Auto mode** — Victor runs the full phase on its own and shows you everything at the end. Best when you want to quickly screen an idea.
 
 ---
 
-## Two Execution Modes
+## Your outputs
 
-**Guided mode (default):** The agent pauses at each checkpoint, shows you the output, and waits for your approval before proceeding. Best for real ventures where strategic decisions matter.
+Everything VentureOS creates is saved as readable files in `_ventures/your-venture-name/`:
 
-**Yolo mode:** The agent runs the full workflow autonomously and presents all outputs at the end for batch review. Best for rapid idea screening.
+- Market research and competitive analysis
+- Customer interview scripts and synthesis
+- Problem and solution definition documents
+- Business model canvas
+- Financial model
+- Go-to-market plan
+- Check-in pitch and final investor pitch deck
 
-Set your preferred default in `config.yaml` or switch modes per workflow.
+If you pivot or decide to stop, VentureOS archives everything and documents the decision with full rationale — so the work is never lost.
 
 ---
 
-## Pivot & Kill Mechanism
+## Common questions
+
+**Do I need to know how to code?**
+No. You type in plain English. VentureOS handles everything else.
+
+**What's an API key?**
+It's like a password that gives you access to an AI service (like ChatGPT or Claude). If you use Cursor, Windsurf, or Antigravity, you don't need one — they include AI access in their apps.
+
+**Does it save my work?**
+Yes. Every session is saved automatically. Start and stop whenever you like.
 
-VentureOS tracks every pivot and kill decision:
+**Can I use it for multiple ideas?**
+Yes. Run `npx ventureos config` to switch ventures or start a new one.
+
+**What if something goes wrong?**
+VentureOS never just crashes. If there's a problem (wrong key, no connection, etc.), it shows you your options and waits for you to decide what to do next.
+
+---
 
-- **Pivot:** Archives current artifacts, classifies pivot type (customer/problem/solution/model/market), identifies re-entry phase, preserves relevant work
-- **Kill:** Documents learnings, archives all artifacts, marks venture as killed with full rationale
+## Need help?
 
-Pivot history is preserved in `ventureOS/_memory/venture-state.yaml`.
+Open an issue on GitHub: [github.com/ABTB93/ventureos/issues](https://github.com/ABTB93/ventureos/issues)

package/install.js

@@ -2,9 +2,9 @@
 /**
  * VentureOS CLI
  * Usage:
- *   npx ventureos install   — interactive installer
- *   npx ventureos start     — launch Victor chat (Claude, ChatGPT, or Gemini)
- *   npx ventureos           — same as install
+ *   npx ventureos           — setup wizard + start (auto-detects your environment)
+ *   npx ventureos config    — update your configuration
+ *   npx ventureos start     — launch Victor chat (if already installed)
  *
  * Zero npm dependencies — pure Node.js (readline/promises, fs, path, url, fetch)
  * Requires Node.js >= 18.0.0
@@ -15,61 +15,140 @@ import { stdin as input, stdout as output } from 'process';
 import fs from 'fs';
 import path from 'path';
 import { fileURLToPath } from 'url';
-import { spawnSync, spawn } from 'child_process';
+import { spawnSync } from 'child_process';
 
 const __filename = fileURLToPath(import.meta.url);
 const PACKAGE_ROOT = path.dirname(__filename);
 
-// Must be defined before startChat() runs (accessed synchronously before first await)
 let _spinner;
 
+// ─── Providers ─────────────────────────────────────────────────────────────────
+
 const PROVIDERS = {
   anthropic: {
     label:        'Claude (Anthropic)',
     envVar:       'ANTHROPIC_API_KEY',
     defaultModel: 'claude-opus-4-6',
+    keyUrl:       'https://console.anthropic.com',
   },
   openai: {
     label:        'ChatGPT (OpenAI)',
     envVar:       'OPENAI_API_KEY',
     defaultModel: 'gpt-4o',
+    keyUrl:       'https://platform.openai.com/api-keys',
   },
   gemini: {
     label:        'Gemini (Google)',
     envVar:       'GOOGLE_API_KEY',
     defaultModel: 'gemini-2.0-flash',
+    keyUrl:       'https://aistudio.google.com/app/apikey',
   },
 };
 
-// CLI tools that can be used instead of an API key
-const CLI_TOOLS = {
-  anthropic: { cmd: 'claude', label: 'Claude CLI' },
-};
+// ─── Known AI IDEs ─────────────────────────────────────────────────────────────
+
+const IDE_TOOLS = [
+  {
+    id:          'cursor',
+    label:       'Cursor',
+    description: 'no API key needed',
+    cmds:        ['cursor'],
+    appPaths:    ['/Applications/Cursor.app'],
+    instructions: (dir) => [
+      '  1.  Open this folder in Cursor',
+      `      cursor "${dir}"`,
+      '      (or: File → Open Folder → select this folder)',
+      '',
+      '  2.  In the Cursor chat panel, type exactly this:',
+      '      @ventureOS/venture-master.md',
+      '',
+      '  3.  Victor — your AI co-founder — will take it from there.',
+      '',
+      '  No API key. No extra setup. Just open and chat.',
+    ],
+  },
+  {
+    id:          'windsurf',
+    label:       'Windsurf',
+    description: 'no API key needed',
+    cmds:        ['windsurf'],
+    appPaths:    ['/Applications/Windsurf.app'],
+    instructions: (dir) => [
+      '  1.  Open this folder in Windsurf',
+      `      windsurf "${dir}"`,
+      '      (or: File → Open Folder → select this folder)',
+      '',
+      '  2.  In the Windsurf chat panel, type:',
+      '      @ventureOS/venture-master.md',
+      '',
+      '  3.  Victor — your AI co-founder — will take it from there.',
+      '',
+      '  No API key. No extra setup. Just open and chat.',
+    ],
+  },
+  {
+    id:          'claude',
+    label:       'Claude Code',
+    description: 'no API key needed',
+    cmds:        ['claude'],
+    appPaths:    [],
+    instructions: (dir) => [
+      '  1.  Open this folder in your terminal and start Claude Code',
+      `      cd "${dir}"`,
+      '      claude',
+      '',
+      '  2.  Type this to activate VentureOS:',
+      '      @ventureOS/venture-master.md',
+      '',
+      '  3.  Victor — your AI co-founder — will take it from there.',
+      '',
+      '  Full markdown rendering, streaming, all native Claude Code features.',
+    ],
+  },
+  {
+    id:          'antigravity',
+    label:       'Antigravity',
+    description: 'free, no API key needed',
+    cmds:        ['antigravity'],
+    appPaths:    ['/Applications/Antigravity.app'],
+    instructions: (dir) => [
+      '  1.  Open this folder in Antigravity',
+      `      antigravity "${dir}"`,
+      '      (or: File → Open Folder → select this folder)',
+      '',
+      '  2.  In the chat panel, type:',
+      '      @ventureOS/venture-master.md',
+      '',
+      '  3.  Victor — your AI co-founder — will take it from there.',
+      '',
+      '  Free to use. Supports Gemini, Claude, and more.',
+    ],
+  },
+];
+
+// ─── Entry point ───────────────────────────────────────────────────────────────
 
 const cmd = process.argv[2];
 
 if (cmd === 'start') {
-  startChat().catch(err => {
-    if (err.code !== 'ERR_USE_AFTER_CLOSE') {
-      console.error('\n  ❌ Error:', err.message, '\n');
-      process.exit(1);
-    }
-  });
+  legacyStart().catch(handleFatalError);
+} else if (cmd === 'config') {
+  reconfigure().catch(handleFatalError);
 } else {
-  install().catch(err => {
-    if (err.code !== 'ERR_USE_AFTER_CLOSE') {
-      console.error('\n  ❌ Installation error:', err.message);
-      process.exit(1);
-    }
-  });
+  main().catch(handleFatalError);
 }
 
-// ─── Shared Utilities ──────────────────────────────────────────────────────────
-
-function line() {
-  return '  ' + '─'.repeat(50);
+function handleFatalError(err) {
+  if (err.code !== 'ERR_USE_AFTER_CLOSE') {
+    console.error('\n  Error:', err.message, '\n');
+    process.exit(1);
+  }
 }
 
+// ─── Utilities ─────────────────────────────────────────────────────────────────
+
+function line() { return '  ' + '─'.repeat(52); }
+
 function parseSimpleYaml(text) {
   const result = {};
   for (const rawLine of text.split('\n')) {
@@ -88,7 +167,39 @@ function parseSimpleYaml(text) {
   return result;
 }
 
-// ─── Install ───────────────────────────────────────────────────────────────────
+function showBanner() {
+  console.log('\n');
+  console.log('  ┌' + '─'.repeat(52) + '┐');
+  console.log('  │                                                    │');
+  console.log('  │   VentureOS                                        │');
+  console.log('  │   AI-Powered Venture Building Framework            │');
+  console.log('  │                                                    │');
+  console.log('  │   Build your startup — step by step.              │');
+  console.log('  │                                                    │');
+  console.log('  └' + '─'.repeat(52) + '┘');
+  console.log('\n');
+}
+
+// ─── IDE Detection ─────────────────────────────────────────────────────────────
+
+function detectIDEs() {
+  const found = [];
+  for (const ide of IDE_TOOLS) {
+    const byCLI = ide.cmds.some(c => {
+      try {
+        const r = spawnSync('which', [c], { encoding: 'utf8', stdio: 'pipe' });
+        return r.status === 0 && r.stdout.trim();
+      } catch { return false; }
+    });
+    const byApp = ide.appPaths.some(p => {
+      try { return fs.existsSync(p); } catch { return false; }
+    });
+    if (byCLI || byApp) found.push(ide);
+  }
+  return found;
+}
+
+// ─── File helpers ───────────────────────────────────────────────────────────────
 
 const SKIP = new Set([
   'install.js', 'package.json', 'package-lock.json',
@@ -129,7 +240,7 @@ output_folder: "_ventures"
 # deep     = exhaustive multi-source research with cross-validation
 research_depth: "${researchDepth}"
 
-# Your AI provider
+# Your AI provider (used when running via built-in chat)
 # Options: anthropic | openai | gemini
 llm: "${llm}"
 
@@ -140,220 +251,365 @@ default_mode: "${defaultMode}"
 `;
 }
 
-function showNextSteps(ventureOSDir, targetDir) {
+function installFiles(targetDir, ventureOSDir, configYaml) {
+  copyDir(PACKAGE_ROOT, ventureOSDir, SKIP);
+  console.log('  ✓  Framework files installed   →  ventureOS/');
+
+  fs.writeFileSync(path.join(ventureOSDir, 'config.yaml'), configYaml, 'utf8');
+  console.log('  ✓  Configuration saved         →  ventureOS/config.yaml');
+
+  const venturesDir = path.join(targetDir, '_ventures');
+  if (!fs.existsSync(venturesDir)) {
+    fs.mkdirSync(venturesDir, { recursive: true });
+    fs.writeFileSync(path.join(venturesDir, '.gitkeep'), '', 'utf8');
+  }
+  console.log('  ✓  Output folder ready         →  _ventures/');
+
+  const gitignorePath = path.join(targetDir, '.gitignore');
+  if (!fs.existsSync(gitignorePath)) {
+    fs.writeFileSync(gitignorePath, '# VentureOS\n_ventures/\nnode_modules/\n.DS_Store\n', 'utf8');
+    console.log('  ✓  .gitignore created');
+  }
+}
+
+// ─── Setup Wizard ──────────────────────────────────────────────────────────────
+
+async function runSetupWizard(rl, { forIDE = false } = {}) {
   console.log('\n' + line());
-  console.log('  How to start VentureOS');
-  console.log(line() + '\n');
-  console.log('  Run this command from your project folder:\n');
-  console.log('    npx ventureos start\n');
-  console.log('  Victor (your VentureOS orchestrator) will:');
-  console.log(line() + '\n');
-  console.log('    1. Read your config and venture state');
-  console.log('    2. Display the phase-aware menu');
-  console.log('    3. Guide you through your venture building journey\n');
-  console.log('  Commands to get started:');
-  console.log('    [NV]  New Venture  — start a new venture (idea or domain)');
-  console.log('    [EX]  Explore      — run a domain deep dive first');
-  console.log('    [VS]  Status       — view venture status and next actions\n');
+  console.log('  A few quick questions so Victor knows how to help you.');
   console.log(line() + '\n');
+
+  const nameInput = await rl.question('  Your name (press Enter for "Founder"): ');
+  const userName = nameInput.trim() || 'Founder';
+
+  console.log('\n  How thorough should VentureOS be with research?\n');
+  console.log('     1.  Standard  — structured analysis with sourced data  (recommended)');
+  console.log('     2.  Light     — quick overview, faster');
+  console.log('     3.  Deep      — exhaustive, multi-source\n');
+  const depthInput = await rl.question('     Select [1-3]: ');
+  const researchDepth = ({ '1': 'standard', '2': 'light', '3': 'deep' })[depthInput.trim()] ?? 'standard';
+
+  console.log('\n  How should workflows run by default?\n');
+  console.log('     1.  Guided  — pauses so you review each step  (recommended)');
+  console.log('     2.  Auto    — runs everything on its own\n');
+  const modeInput = await rl.question('     Select [1-2]: ');
+  const defaultMode = modeInput.trim() === '2' ? 'yolo' : 'guided';
+
+  let llm = 'anthropic';
+  if (!forIDE) {
+    console.log('\n  Which AI service will you use?\n');
+    console.log('     1.  Claude (Anthropic)  (recommended)');
+    console.log('     2.  ChatGPT (OpenAI)');
+    console.log('     3.  Gemini (Google)\n');
+    const llmInput = await rl.question('     Select [1-3]: ');
+    llm = ({ '1': 'anthropic', '2': 'openai', '3': 'gemini' })[llmInput.trim()] ?? 'anthropic';
+  }
+
+  return { userName, researchDepth, llm, defaultMode };
 }
 
-async function install() {
-  console.log('\n');
-  console.log('  ┌' + '─'.repeat(52) + '┐');
-  console.log('  │                                                    │');
-  console.log('  │   🚀  VentureOS                                    │');
-  console.log('  │   AI-Powered Venture Building Framework            │');
-  console.log('  │                                                    │');
-  console.log('  └' + '─'.repeat(52) + '┘');
-  console.log('\n');
+// ─── API Key Recovery ──────────────────────────────────────────────────────────
 
-  const rl = readline.createInterface({ input, output });
+/**
+ * Prompts for an API key with a recovery menu.
+ * Returns the key string, or null if the user wants to switch provider.
+ * Exits the process if user picks "show free tools" or "exit".
+ */
+async function promptForAPIKey(rl, providerKey) {
+  const provider = PROVIDERS[providerKey];
 
-  try {
-    // Step 1: Installation directory
-    const defaultTarget = process.cwd();
-    console.log('  📁 Installation directory');
-    console.log(`     Default: ${defaultTarget}`);
-    const targetInput = await rl.question('     Press Enter to confirm, or type a different path: ');
-    const targetDir = path.resolve(targetInput.trim() || defaultTarget);
-    const ventureOSDir = path.join(targetDir, 'ventureOS');
-
-    if (fs.existsSync(ventureOSDir)) {
-      console.log('\n  ⚠️  VentureOS is already installed in this directory.');
-      const ans = await rl.question('     Update/reinstall? (y/N): ');
-      if (!ans.trim().toLowerCase().startsWith('y')) {
-        console.log('\n  Installation cancelled. Your existing installation is unchanged.\n');
-        rl.close();
-        return;
+  while (true) {
+    console.log(`\n  No ${provider.envVar} found.\n`);
+    console.log('     1.  I\'ll paste my key now');
+    console.log(`     2.  How to get a key  →  ${provider.keyUrl}`);
+    console.log('     3.  Switch to a different AI service');
+    console.log('     4.  Use an AI IDE instead — no key needed');
+    console.log('     5.  Exit\n');
+
+    const choice = (await rl.question('     Select [1-5]: ')).trim();
+
+    if (choice === '1') {
+      const key = (await rl.question(`\n     Paste your ${provider.label} API key: `)).trim();
+      if (key) {
+        console.log(`\n  Tip: save this to skip the prompt next time:`);
+        console.log(`       export ${provider.envVar}=your-key\n`);
+        return key;
       }
-      console.log('\n  Updating existing installation...');
+      console.log('\n  No key entered.\n');
+      continue;
     }
 
-    // Step 2: User name
-    console.log('\n' + line());
-    console.log('  About you');
-    console.log(line() + '\n');
-    const nameInput = await rl.question('  👤 Your name: ');
-    const userName = nameInput.trim() || 'Founder';
+    if (choice === '2') {
+      console.log(`\n  Open this link to get your key:\n  ${provider.keyUrl}\n`);
+      console.log('  Come back and run  npx ventureos  once you have it.\n');
+      rl.close();
+      process.exit(0);
+    }
 
-    // Step 3: AI provider
-    console.log('\n  🤖 Which AI provider do you use?\n');
+    if (choice === '3') return null; // signal: switch provider
+
+    if (choice === '4') {
+      showFreeToolsHelp();
+      rl.close();
+      process.exit(0);
+    }
+
+    if (choice === '5') {
+      rl.close();
+      process.exit(0);
+    }
+  }
+}
+
+/**
+ * Asks user to pick a provider, then prompts for its API key.
+ * Loops until a valid provider + key is chosen.
+ */
+async function selectProviderAndKey(rl) {
+  while (true) {
+    console.log('\n  Which AI service do you have a key for?\n');
     console.log('     1.  Claude (Anthropic)  (recommended)');
     console.log('     2.  ChatGPT (OpenAI)');
-    console.log('     3.  Gemini (Google)\n');
-    const llmInput = await rl.question('     Select [1-3]: ');
-    const llmMap = { '1': 'anthropic', '2': 'openai', '3': 'gemini' };
-    const llm = llmMap[llmInput.trim()] ?? 'anthropic';
-
-    // Step 4: Research depth
-    console.log('\n  🔍 Research depth for market and domain analysis?\n');
-    console.log('     1.  Standard  — structured analysis with sourced data  (recommended)');
-    console.log('     2.  Light     — high-level overview, fast');
-    console.log('     3.  Deep      — exhaustive multi-source research with validation\n');
-    const depthInput = await rl.question('     Select [1-3]: ');
-    const depthMap = { '1': 'standard', '2': 'light', '3': 'deep' };
-    const researchDepth = depthMap[depthInput.trim()] ?? 'standard';
-
-    // Step 6: Default mode
-    console.log('\n  ⚙️  Default workflow execution mode?\n');
-    console.log('     1.  Guided  — agent pauses for your review at each step  (recommended)');
-    console.log('     2.  Yolo    — agent runs full workflows autonomously\n');
-    const modeInput = await rl.question('     Select [1-2]: ');
-    const defaultMode = modeInput.trim() === '2' ? 'yolo' : 'guided';
+    console.log('     3.  Gemini (Google)');
+    console.log('     4.  I don\'t have one yet — show me free options\n');
 
-    rl.close();
+    const choice = (await rl.question('     Select [1-4]: ')).trim();
 
-    // Install files
-    console.log('\n' + line());
-    console.log('  Installing...');
-    console.log(line() + '\n');
+    if (choice === '4') {
+      showFreeToolsHelp();
+      rl.close();
+      process.exit(0);
+    }
 
-    copyDir(PACKAGE_ROOT, ventureOSDir, SKIP);
-    console.log('  ✓ Framework files installed');
+    const providerKey = ({ '1': 'anthropic', '2': 'openai', '3': 'gemini' })[choice] ?? 'anthropic';
+    const apiKey = await promptForAPIKey(rl, providerKey);
+    if (apiKey) return { providerKey, apiKey };
+    // null = user wants to switch provider — loop again
+  }
+}
 
-    const config = generateConfig({ userName, researchDepth, llm, defaultMode });
-    fs.writeFileSync(path.join(ventureOSDir, 'config.yaml'), config, 'utf8');
-    console.log('  ✓ Configuration written  →  ventureOS/config.yaml');
+function showFreeToolsHelp() {
+  console.log('\n' + line());
+  console.log('  AI tools you can use for free — no API key needed:\n');
+  console.log('  Antigravity  (Google)  — free preview, Gemini + Claude + more');
+  console.log('  → https://antigravity.dev\n');
+  console.log('  Cursor       — popular AI code editor');
+  console.log('  → https://cursor.com\n');
+  console.log('  Windsurf     — AI IDE by Codeium');
+  console.log('  → https://windsurf.com\n');
+  console.log('  Once installed, run  npx ventureos  again and we\'ll detect it.');
+  console.log(line() + '\n');
+}
+
+// ─── Main Flow ─────────────────────────────────────────────────────────────────
+
+async function main() {
+  showBanner();
+
+  const projectRoot = process.cwd();
+  const ventureOSDir = path.join(projectRoot, 'ventureOS');
+  const configPath = path.join(ventureOSDir, 'config.yaml');
+  const rl = readline.createInterface({ input, output });
 
-    const venturesDir = path.join(targetDir, '_ventures');
-    if (!fs.existsSync(venturesDir)) {
-      fs.mkdirSync(venturesDir, { recursive: true });
-      fs.writeFileSync(path.join(venturesDir, '.gitkeep'), '', 'utf8');
+  try {
+    // ── Already installed ──────────────────────────────────────────────────
+    if (fs.existsSync(configPath)) {
+      const config = parseSimpleYaml(fs.readFileSync(configPath, 'utf8'));
+      console.log(`  Welcome back, ${config.user_name || 'Founder'}!\n`);
+      console.log('  VentureOS is already set up in this folder.');
+      console.log('  To update your settings, run:  npx ventureos config\n');
+      await launchChat(rl, projectRoot, config);
+      return;
     }
-    console.log('  ✓ Output folder ready    →  _ventures/');
 
-    const gitignorePath = path.join(targetDir, '.gitignore');
-    if (!fs.existsSync(gitignorePath)) {
-      fs.writeFileSync(gitignorePath, '# VentureOS outputs\n_ventures/\nnode_modules/\n.DS_Store\n', 'utf8');
-      console.log('  ✓ .gitignore created');
+    // ── Environment scan ───────────────────────────────────────────────────
+    console.log('  Scanning your environment...\n');
+    const detectedIDEs = detectIDEs();
+
+    if (detectedIDEs.length > 0) {
+      detectedIDEs.forEach(ide => {
+        console.log(`  ✓  ${ide.label} detected   — ${ide.description}`);
+      });
+      console.log('');
+    } else {
+      console.log('  No AI tools found on this computer.\n');
     }
 
+    // ── Route ──────────────────────────────────────────────────────────────
+    let chosenIDE = null;
+
+    if (detectedIDEs.length === 1) {
+      const ide = detectedIDEs[0];
+      console.log(`  Good news: ${ide.label} comes with AI built in — ${ide.description}.\n`);
+      const ans = (await rl.question(`  Set up VentureOS for ${ide.label}? (Y/n): `)).trim().toLowerCase();
+      if (!ans || ans === 'y' || ans === 'yes') {
+        chosenIDE = ide;
+      } else {
+        // User declined IDE — fall through to API key path
+        const { providerKey, apiKey } = await selectProviderAndKey(rl);
+        await installAndChat(rl, projectRoot, ventureOSDir, configPath, { forIDE: false, providerKey, apiKey });
+        return;
+      }
+    } else if (detectedIDEs.length > 1) {
+      console.log('  Which would you like to use?\n');
+      detectedIDEs.forEach((ide, i) => {
+        const tag = i === 0 ? '   ← recommended' : '';
+        console.log(`     ${i + 1}.  ${ide.label}   — ${ide.description}${tag}`);
+      });
+      console.log(`     ${detectedIDEs.length + 1}.  I'd rather use my own API key\n`);
+      const idx = parseInt((await rl.question('     Select: ')).trim(), 10) - 1;
+      if (idx >= 0 && idx < detectedIDEs.length) {
+        chosenIDE = detectedIDEs[idx];
+      } else {
+        const { providerKey, apiKey } = await selectProviderAndKey(rl);
+        await installAndChat(rl, projectRoot, ventureOSDir, configPath, { forIDE: false, providerKey, apiKey });
+        return;
+      }
+    } else {
+      // Nothing detected
+      console.log('  How would you like to run VentureOS?\n');
+      console.log('     1.  I have an API key  (OpenAI, Claude, or Gemini)');
+      console.log('     2.  Show me free options — no key needed\n');
+      const choice = (await rl.question('     Select [1-2]: ')).trim();
+      if (choice === '2') {
+        showFreeToolsHelp();
+        rl.close();
+        return;
+      }
+      const { providerKey, apiKey } = await selectProviderAndKey(rl);
+      await installAndChat(rl, projectRoot, ventureOSDir, configPath, { forIDE: false, providerKey, apiKey });
+      return;
+    }
+
+    // ── IDE setup ──────────────────────────────────────────────────────────
+    const { userName, researchDepth, defaultMode } = await runSetupWizard(rl, { forIDE: true });
+    rl.close();
+
     console.log('\n' + line());
-    console.log('  ✅ VentureOS is ready!');
-    console.log(line());
+    console.log('  Installing...');
+    console.log(line() + '\n');
 
-    showNextSteps(ventureOSDir, targetDir);
+    const configYaml = generateConfig({ userName, researchDepth, llm: 'anthropic', defaultMode });
+    installFiles(projectRoot, ventureOSDir, configYaml);
+
+    console.log('\n' + line());
+    console.log('  VentureOS is ready!');
+    console.log(line() + '\n');
+    console.log("  Here's how to start:\n");
+    chosenIDE.instructions(projectRoot).forEach(l => console.log(l));
+    console.log('\n' + line() + '\n');
 
   } catch (err) {
     rl.close();
     if (err.code === 'ERR_USE_AFTER_CLOSE') return;
-    console.error('\n  ❌ Installation error:', err.message);
-    process.exit(1);
+    throw err;
   }
 }
 
-// ─── Start / Chat ──────────────────────────────────────────────────────────────
+async function installAndChat(rl, projectRoot, ventureOSDir, configPath, { forIDE, providerKey, apiKey }) {
+  const { userName, researchDepth, llm, defaultMode } = await runSetupWizard(rl, { forIDE });
 
-async function startChat() {
-  console.log('\n');
-  console.log('  ┌' + '─'.repeat(52) + '┐');
-  console.log('  │                                                    │');
-  console.log('  │   🚀  VentureOS — Starting Victor                  │');
-  console.log('  │                                                    │');
-  console.log('  └' + '─'.repeat(52) + '┘');
-  console.log('\n');
+  console.log('\n' + line());
+  console.log('  Installing...');
+  console.log(line() + '\n');
+
+  const configYaml = generateConfig({ userName, researchDepth, llm, defaultMode });
+  installFiles(projectRoot, ventureOSDir, configYaml);
+
+  console.log('\n' + line());
+  console.log('  All set! Starting Victor...');
+  console.log(line() + '\n');
+
+  const config = parseSimpleYaml(configYaml);
+  await launchChat(rl, projectRoot, config, { providerKey, apiKey });
+}
+
+// ─── Reconfigure ───────────────────────────────────────────────────────────────
+
+async function reconfigure() {
+  showBanner();
 
   const projectRoot = process.cwd();
   const configPath = path.join(projectRoot, 'ventureOS', 'config.yaml');
 
   if (!fs.existsSync(configPath)) {
-    console.error('  ❌ VentureOS is not installed here. Run: npx ventureos install\n');
+    console.error('  VentureOS is not set up here. Run: npx ventureos\n');
     process.exit(1);
   }
 
+  const current = parseSimpleYaml(fs.readFileSync(configPath, 'utf8'));
+  console.log('  Current settings:\n');
+  console.log(`     Name:     ${current.user_name     || '—'}`);
+  console.log(`     Research: ${current.research_depth || '—'}`);
+  console.log(`     Mode:     ${current.default_mode  || '—'}`);
+  console.log(`     Provider: ${current.llm           || '—'}\n`);
+
+  const rl = readline.createInterface({ input, output });
+  try {
+    const { userName, researchDepth, llm, defaultMode } = await runSetupWizard(rl, { forIDE: false });
+    rl.close();
+    const newConfig = generateConfig({ userName, researchDepth, llm, defaultMode });
+    fs.writeFileSync(configPath, newConfig, 'utf8');
+    console.log('\n  ✓  Configuration updated  →  ventureOS/config.yaml\n');
+  } catch (err) {
+    rl.close();
+    if (err.code === 'ERR_USE_AFTER_CLOSE') return;
+    throw err;
+  }
+}
+
+// ─── Legacy start command ───────────────────────────────────────────────────────
+
+async function legacyStart() {
+  showBanner();
+  const projectRoot = process.cwd();
+  const configPath = path.join(projectRoot, 'ventureOS', 'config.yaml');
+  if (!fs.existsSync(configPath)) {
+    console.error('  VentureOS is not set up here. Run: npx ventureos\n');
+    process.exit(1);
+  }
   const config = parseSimpleYaml(fs.readFileSync(configPath, 'utf8'));
   const rl = readline.createInterface({ input, output });
+  try {
+    await launchChat(rl, projectRoot, config);
+  } finally {
+    rl.close();
+  }
+}
 
-  // ── Select provider from config ────────────────────────────────────────────
-  const providerKey = PROVIDERS[config.llm] ? config.llm : 'anthropic';
+// ─── Chat ───────────────────────────────────────────────────────────────────────
+
+async function launchChat(rl, projectRoot, config, credentials = null) {
+  const providerKey = credentials?.providerKey || (PROVIDERS[config.llm] ? config.llm : 'anthropic');
   const provider = PROVIDERS[providerKey];
 
-  // ── Get API key or use CLI mode ────────────────────────────────────────────
-  let apiKey = process.env[provider.envVar];
-  let useCLI = false;
-  let cliCmd = null;
+  // ── Resolve API key ────────────────────────────────────────────────────────
+  let apiKey = credentials?.apiKey || process.env[provider.envVar];
 
   if (!apiKey) {
-    const cli = detectCLI(providerKey);
-    if (cli) {
-      console.log(`\n  🔑 ${provider.envVar} not set in environment.\n`);
-      console.log(`     How would you like to connect?\n`);
-      console.log(`     1.  Enter API key`);
-      console.log(`     2.  Use ${cli.label} (detected on your system)\n`);
-      const choice = (await rl.question('     Select [1-2]: ')).trim();
-      if (choice === '2') {
-        useCLI = true;
-        cliCmd = cli.cmd;
-      } else {
-        apiKey = (await rl.question(`\n     Enter your ${provider.label} API key: `)).trim();
-        if (!apiKey) {
-          console.error('\n  ❌ No API key provided.\n');
-          rl.close();
-          process.exit(1);
-        }
-        console.log(`\n  💡 Tip: export ${provider.envVar}=your-key  to skip this next time.\n`);
-      }
-    } else {
-      console.log(`\n  🔑 ${provider.envVar} not set in environment.`);
-      apiKey = (await rl.question(`     Enter your ${provider.label} API key: `)).trim();
-      if (!apiKey) {
-        console.error('\n  ❌ No API key provided.\n');
-        rl.close();
-        process.exit(1);
-      }
-      console.log(`\n  💡 Tip: export ${provider.envVar}=your-key  to skip this next time.\n`);
+    apiKey = await promptForAPIKey(rl, providerKey);
+    if (!apiKey) {
+      // user wants to switch provider — tell them to reconfigure
+      console.log('\n  Run  npx ventureos config  to change your AI provider.\n');
+      rl.close();
+      process.exit(0);
     }
   }
 
-  // ── If using Claude CLI, redirect to native Claude Code experience ─────────
-  if (useCLI && cliCmd === 'claude') {
-    console.log(line());
-    console.log('  Use Claude Code natively — it\'s a much better experience.\n');
-    console.log('  In Claude Code, start your VentureOS session by typing:\n');
-    console.log('    @ventureOS/venture-master.md\n');
-    console.log('  That gives you full markdown rendering, streaming, and all');
-    console.log('  native Claude Code features — no terminal wrapper needed.');
-    console.log(line() + '\n');
-    rl.close();
-    process.exit(0);
-  }
-
-  // ── Load system prompt ─────────────────────────────────────────────────────
+  // ── Build system prompt ────────────────────────────────────────────────────
   const masterPath = path.join(projectRoot, 'ventureOS', 'venture-master.md');
-  let systemPrompt = fs.readFileSync(masterPath, 'utf8')
-    .replace(/\{project-root\}/g, projectRoot)
+  const systemPrompt = fs.readFileSync(masterPath, 'utf8')
+    .replace(/\{project-root\}/g,          projectRoot)
     .replace(/\{communication_language\}/g, 'English')
-    .replace(/\{user_name\}/g, config.user_name || 'Founder')
-    .replace(/\{llm\}/g, config.llm || 'anthropic')
-    .replace(/\{research_depth\}/g, config.research_depth || 'standard')
-    .replace(/\{default_mode\}/g, config.default_mode || 'guided')
-    .replace(/\{output_folder\}/g, config.output_folder || '_ventures');
-
-  // ── Inject config + venture state as context ───────────────────────────────
-  const configContent = fs.readFileSync(configPath, 'utf8');
-  const statePath = path.join(projectRoot, 'ventureOS', '_memory', 'venture-state.yaml');
-  const stateContent = fs.existsSync(statePath)
+    .replace(/\{user_name\}/g,             config.user_name      || 'Founder')
+    .replace(/\{llm\}/g,                   config.llm            || 'anthropic')
+    .replace(/\{research_depth\}/g,        config.research_depth || 'standard')
+    .replace(/\{default_mode\}/g,          config.default_mode   || 'guided')
+    .replace(/\{output_folder\}/g,         config.output_folder  || '_ventures');
+
+  const configContent  = fs.readFileSync(path.join(projectRoot, 'ventureOS', 'config.yaml'), 'utf8');
+  const statePath      = path.join(projectRoot, 'ventureOS', '_memory', 'venture-state.yaml');
+  const stateContent   = fs.existsSync(statePath)
     ? fs.readFileSync(statePath, 'utf8')
     : 'No venture state yet — this is a fresh start.';
 
@@ -363,25 +619,23 @@ async function startChat() {
     `--- ventureOS/_memory/venture-state.yaml ---\n${stateContent}`;
 
   console.log(line());
-  console.log(`  ✓ Connected ${useCLI ? `via ${cliCmd} CLI` : `to ${provider.label}`}`);
-  console.log(`  ✓ Type your message and press Enter. Type "exit" or Ctrl+C to quit.`);
+  console.log(`  Connected to ${provider.label}`);
+  console.log('  Type your message and press Enter.  Type "exit" to quit.');
   console.log(line() + '\n');
 
   const messages = [];
 
-  // ── Initial activation call ────────────────────────────────────────────────
+  // ── Activation call ────────────────────────────────────────────────────────
   showSpinner('  Victor is thinking');
   let firstResponse;
   try {
-    firstResponse = useCLI
-      ? await callViaCLI(cliCmd, systemPrompt, [{ role: 'user', content: activationMsg }])
-      : await callLLM(providerKey, apiKey, provider.defaultModel, systemPrompt, [{ role: 'user', content: activationMsg }]);
+    firstResponse = await callLLM(providerKey, apiKey, provider.defaultModel, systemPrompt, [
+      { role: 'user', content: activationMsg },
+    ]);
   } catch (err) {
     stopSpinner();
-    console.error(`\n  ❌ API error: ${err.message}`);
-    console.error(`  Check your API key and try again.\n`);
-    rl.close();
-    process.exit(1);
+    await handleConnectionError(rl, err, providerKey, projectRoot, config);
+    return;
   }
   stopSpinner();
 
@@ -390,35 +644,30 @@ async function startChat() {
   messages.push({ role: 'assistant', content: firstResponse });
   await autoLoadAgents(firstResponse, messages, projectRoot);
 
-  // ── Main chat loop ─────────────────────────────────────────────────────────
+  // ── Chat loop ──────────────────────────────────────────────────────────────
   while (true) {
     let userInput;
-    try {
-      userInput = await rl.question('  You: ');
-    } catch {
-      break; // Ctrl+C
-    }
+    try { userInput = await rl.question('  You: '); }
+    catch { break; }
 
     const trimmed = userInput.trim();
     if (!trimmed) continue;
     if (['exit', 'quit', 'da', '/exit'].includes(trimmed.toLowerCase())) {
-      console.log('\n  Victor: Safe travels. Your venture state has been saved. 🚀\n');
+      console.log('\n  Victor: Safe travels. Your venture state has been saved.\n');
       break;
     }
 
     messages.push({ role: 'user', content: trimmed });
-
     showSpinner('  Victor is thinking');
+
     let response;
     try {
-      response = useCLI
-        ? await callViaCLI(cliCmd, systemPrompt, messages)
-        : await callLLM(providerKey, apiKey, provider.defaultModel, systemPrompt, messages);
+      response = await callLLM(providerKey, apiKey, provider.defaultModel, systemPrompt, messages);
     } catch (err) {
       stopSpinner();
-      console.error(`\n  ❌ API error: ${err.message}\n`);
+      console.error(`\n  ❌ ${err.message}\n`);
       messages.pop();
-      continue;
+      continue; // stay in the loop — user can retry
     }
     stopSpinner();
 
@@ -426,24 +675,37 @@ async function startChat() {
     messages.push({ role: 'assistant', content: response });
     await autoLoadAgents(response, messages, projectRoot);
   }
-
-  rl.close();
 }
 
-// ─── CLI Detection ─────────────────────────────────────────────────────────────
+async function handleConnectionError(rl, err, providerKey, projectRoot, config) {
+  const provider = PROVIDERS[providerKey];
+  console.error(`\n  ❌ Could not connect to ${provider.label}`);
+  console.error(`     ${err.message}\n`);
 
-function detectCLI(providerKey) {
-  const tool = CLI_TOOLS[providerKey];
-  if (!tool) return null;
-  try {
-    const result = spawnSync('which', [tool.cmd], { encoding: 'utf8', stdio: 'pipe' });
-    return result.status === 0 && result.stdout.trim() ? tool : null;
-  } catch {
-    return null;
+  console.log('  What would you like to do?\n');
+  console.log('     1.  Try a different API key');
+  console.log(`     2.  Get a new key  →  ${provider.keyUrl}`);
+  console.log('     3.  Exit\n');
+
+  const choice = (await rl.question('     Select [1-3]: ')).trim();
+
+  if (choice === '1') {
+    const key = (await rl.question(`\n     Paste your ${provider.label} API key: `)).trim();
+    if (key) {
+      await launchChat(rl, projectRoot, config, { providerKey, apiKey: key });
+      return;
+    }
+  } else if (choice === '2') {
+    console.log(`\n  Open:  ${provider.keyUrl}`);
+    console.log('  Then run  npx ventureos  again.\n');
   }
+
+  rl.close();
+  process.exit(0);
 }
 
-// ─── Spinner ───────────────────────────────────────────────────────────────────
+// ─── Spinner ────────────────────────────────────────────────────────────────────
+
 function showSpinner(msg) {
   const frames = ['⠋', '⠙', '⠹', '⠸', '⠼', '⠴', '⠦', '⠧', '⠇', '⠏'];
   let i = 0;
@@ -463,16 +725,13 @@ function stopSpinner() {
 async function autoLoadAgents(response, messages, projectRoot) {
   const pattern = /ventureOS\/agents\/([\w-]+\.md)/g;
   const files = [...new Set([...response.matchAll(pattern)].map(m => m[1]))];
-
   for (const filename of files) {
     const alreadyLoaded = messages.some(
       m => m.role === 'user' && m.content.includes(`ventureOS/agents/${filename}`)
     );
     if (alreadyLoaded) continue;
-
     const agentPath = path.join(projectRoot, 'ventureOS', 'agents', filename);
     if (!fs.existsSync(agentPath)) continue;
-
     const content = fs.readFileSync(agentPath, 'utf8');
     messages.push({
       role: 'user',
@@ -485,53 +744,39 @@ async function autoLoadAgents(response, messages, projectRoot) {
   }
 }
 
-// ─── Markdown renderer (terminal-friendly, zero deps) ─────────────────────────
+// ─── Markdown renderer ────────────────────────────────────────────────────────
 
 function indentText(text) {
-  const B = '\x1b[1m', D = '\x1b[2m', R = '\x1b[0m', C = '\x1b[36m';
+  const B = '\x1b[1m', D = '\x1b[2m', R = '\x1b[0m';
   let inCode = false;
   const out = [];
-
   for (const raw of text.split('\n')) {
-    // Code fence toggle
     if (raw.trimStart().startsWith('```')) {
       inCode = !inCode;
       out.push(D + '  ' + '─'.repeat(40) + R);
       continue;
     }
-    if (inCode) { out.push(D + '  ' + raw + R); continue; }
-
-    // Horizontal rule
-    if (/^[-─]{3,}$/.test(raw.trim())) { out.push('  ' + '─'.repeat(50)); continue; }
-
-    // Headings
-    if (raw.startsWith('### ')) { out.push('\n  ' + B + raw.slice(4).trim() + R); continue; }
-    if (raw.startsWith('## '))  { out.push('\n  ' + B + raw.slice(3).trim() + R); continue; }
-    if (raw.startsWith('# '))   { out.push('\n  ' + B + raw.slice(2).trim().toUpperCase() + R); continue; }
-
-    // Table separator — skip
+    if (inCode)                          { out.push(D + '  ' + raw + R); continue; }
+    if (/^[-─]{3,}$/.test(raw.trim()))   { out.push('  ' + '─'.repeat(52)); continue; }
+    if (raw.startsWith('### '))          { out.push('\n  ' + B + raw.slice(4).trim() + R); continue; }
+    if (raw.startsWith('## '))           { out.push('\n  ' + B + raw.slice(3).trim() + R); continue; }
+    if (raw.startsWith('# '))            { out.push('\n  ' + B + raw.slice(2).trim().toUpperCase() + R); continue; }
     if (/^\|[\s|:-]+\|$/.test(raw.trim())) continue;
-
-    // Table row
     if (raw.trim().startsWith('|') && raw.trim().endsWith('|')) {
       const cells = raw.split('|').slice(1, -1).map(c => c.trim());
       out.push('  ' + cells.join('  │  ').replace(/\*\*(.+?)\*\*/g, B + '$1' + R));
       continue;
     }
-
-    // Inline: bold, italic, code
-    const line = raw
+    const ln = raw
       .replace(/\*\*(.+?)\*\*/g, B + '$1' + R)
       .replace(/\*(.+?)\*/g, '$1')
       .replace(/`([^`]+)`/g, D + '$1' + R);
-
-    out.push('  ' + line);
+    out.push('  ' + ln);
   }
-
   return out.join('\n');
 }
 
-// ─── LLM API calls — zero dependencies, native fetch ──────────────────────────
+// ─── LLM API calls ────────────────────────────────────────────────────────────
 
 async function callLLM(provider, apiKey, model, system, messages) {
   if (provider === 'anthropic') return callAnthropic(apiKey, model, system, messages);
@@ -540,46 +785,6 @@ async function callLLM(provider, apiKey, model, system, messages) {
   throw new Error(`Unknown provider: ${provider}`);
 }
 
-async function callViaCLI(cliCmd, system, messages) {
-  // Build full context: system + conversation history + latest user message.
-  // Sent via stdin to avoid ARG_MAX limits and CLI option-parsing issues
-  // (e.g. prompts that start with "---" being misread as flags).
-  let prompt = system + '\n\n';
-
-  for (const msg of messages.slice(0, -1)) {
-    const role = msg.role === 'user' ? 'Human' : 'Assistant';
-    prompt += `${role}: ${msg.content}\n\n`;
-  }
-
-  const lastMsg = messages[messages.length - 1];
-  prompt += `Human: ${lastMsg.content}`;
-
-  return new Promise((resolve, reject) => {
-    const proc = spawn(cliCmd, ['--print', '--dangerously-skip-permissions'], {
-      stdio: ['pipe', 'pipe', 'pipe'],
-    });
-
-    let stdout = '';
-    let stderr = '';
-
-    proc.stdout.on('data', chunk => { stdout += chunk; });
-    proc.stderr.on('data', chunk => { stderr += chunk; });
-
-    proc.on('close', code => {
-      if (code !== 0) {
-        reject(new Error(stderr.trim() || `${cliCmd} CLI exited with code ${code}`));
-      } else {
-        resolve(stdout.trim());
-      }
-    });
-
-    proc.on('error', reject);
-
-    proc.stdin.write(prompt, 'utf8');
-    proc.stdin.end();
-  });
-}
-
 async function callAnthropic(apiKey, model, system, messages) {
   const res = await fetch('https://api.anthropic.com/v1/messages', {
     method: 'POST',

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ventureos",
-  "version": "1.0.9",
+  "version": "1.0.11",
   "description": "VentureOS — AI-powered venture building framework. From raw idea to investor-ready pitch in 12 structured weeks.",
   "type": "module",
   "bin": {