codevf 1.0.0 → 1.0.1

package/dist/commands/welcome.js

@@ -0,0 +1,175 @@
+/**
+ * Welcome screen for first-time users
+ */
+import chalk from 'chalk';
+import prompts from 'prompts';
+import { setupCommand } from './setup.js';
+import { ConfigManager } from '../lib/config/manager.js';
+const WELCOME_ART = `
+╔═══════════════════════════════════════════════════════════╗
+║                                                           ║
+║   █████╗  ██████╗ ██████╗ ███████╗██╗   ██╗███████╗      ║
+║  ██╔══██╗██╔═══██╗██╔══██╗██╔════╝██║   ██║██╔════╝      ║
+║  ██║  ╚═╝██║   ██║██║  ██║█████╗  ╚██╗ ██╔╝█████╗        ║
+║  ██║  ██╗██║   ██║██║  ██║██╔══╝   ╚████╔╝ ██╔══╝        ║
+║  ╚█████╔╝╚██████╔╝██████╔╝███████╗  ╚██╔╝  ██║           ║
+║   ╚════╝  ╚═════╝ ╚═════╝ ╚══════╝   ╚═╝   ╚═╝           ║
+║                                                           ║
+║          Live Debugging with Vetted Engineers            ║
+║                                                           ║
+╚═══════════════════════════════════════════════════════════╝
+`;
+export async function welcomeCommand() {
+    console.clear();
+    console.log(chalk.cyan(WELCOME_ART));
+    console.log(chalk.bold('\n👋 Welcome to CodeVF!\n'));
+    console.log('Get help from expert engineers when you need it most.\n');
+    const { setupType } = await prompts({
+        type: 'select',
+        name: 'setupType',
+        message: 'How would you like to use CodeVF?',
+        choices: [
+            {
+                title: chalk.bold.green('🤖 Claude Code Integration') + chalk.dim(' (Recommended)'),
+                description: 'Add CodeVF tools to Claude Code - ask Claude to consult engineers',
+                value: 'mcp',
+            },
+            {
+                title: chalk.bold.blue('💻 Standalone CLI') + chalk.dim(' (Beta)'),
+                description: 'Use CodeVF directly from your terminal for live debugging sessions',
+                value: 'cli',
+            },
+            {
+                title: chalk.dim('ℹ️  Learn More'),
+                description: 'Show me what CodeVF can do',
+                value: 'info',
+            },
+            {
+                title: chalk.dim('❌ Exit'),
+                description: 'Exit setup',
+                value: 'exit',
+            },
+        ],
+        initial: 0,
+    });
+    if (!setupType || setupType === 'exit') {
+        console.log(chalk.dim('\n👋 Run `codevf` anytime to get started!\n'));
+        return;
+    }
+    switch (setupType) {
+        case 'mcp':
+            await setupMCPFlow();
+            break;
+        case 'cli':
+            await setupCLIFlow();
+            break;
+        case 'info':
+            await showInfo();
+            break;
+    }
+}
+async function setupMCPFlow() {
+    console.log(chalk.bold.cyan('\n🤖 Claude Code Integration Setup\n'));
+    console.log(chalk.dim('This will:'));
+    console.log(chalk.dim('  1. Authenticate with CodeVF'));
+    console.log(chalk.dim('  2. Configure Claude Code to use CodeVF tools'));
+    console.log(chalk.dim('  3. Enable codevf-instant and codevf-chat commands\n'));
+    const { proceed } = await prompts({
+        type: 'confirm',
+        name: 'proceed',
+        message: 'Ready to set up?',
+        initial: true,
+    });
+    if (!proceed) {
+        console.log(chalk.dim('\n👋 Run `codevf setup` anytime to configure!\n'));
+        return;
+    }
+    // Run the setup command
+    await setupCommand();
+    console.log(chalk.bold.green('\n✨ All set! Here\'s what you can do:\n'));
+    console.log(chalk.cyan('In Claude Code, you can now ask:\n'));
+    console.log(chalk.dim('  "Use codevf-instant to ask an engineer if this fix works"'));
+    console.log(chalk.dim('  "Use codevf-chat to debug this complex issue with an engineer"\n'));
+    console.log(chalk.bold('Available Tools:'));
+    console.log(chalk.green('  • codevf-instant') + chalk.dim(' - Quick validation (1-10 credits, ~2 min)'));
+    console.log(chalk.green('  • codevf-chat') + chalk.dim(' - Extended session (4-1920 credits, up to 16 hours)\n'));
+}
+async function setupCLIFlow() {
+    console.log(chalk.bold.blue('\n💻 Standalone CLI Setup\n'));
+    console.log(chalk.yellow('⚠️  The CLI is currently in beta. For the best experience, we recommend'));
+    console.log(chalk.yellow('   using Claude Code integration instead.\n'));
+    console.log(chalk.dim('CLI Features:'));
+    console.log(chalk.dim('  • Live debugging sessions with engineers'));
+    console.log(chalk.dim('  • Real-time chat and screen sharing'));
+    console.log(chalk.dim('  • Project initialization and sync\n'));
+    const { proceed } = await prompts({
+        type: 'confirm',
+        name: 'proceed',
+        message: 'Continue with CLI setup?',
+        initial: false,
+    });
+    if (!proceed) {
+        console.log(chalk.dim('\n💡 Tip: Try `codevf` again and choose Claude Code Integration!\n'));
+        return;
+    }
+    console.log(chalk.bold('\n📚 CLI Commands:\n'));
+    console.log(chalk.cyan('  codevf login') + chalk.dim('   - Authenticate with CodeVF'));
+    console.log(chalk.cyan('  codevf init') + chalk.dim('    - Initialize project'));
+    console.log(chalk.cyan('  codevf fix') + chalk.dim('     - Start live debugging session'));
+    console.log(chalk.cyan('  codevf sync') + chalk.dim('    - Sync your code\n'));
+    const { startLogin } = await prompts({
+        type: 'confirm',
+        name: 'startLogin',
+        message: 'Start with login?',
+        initial: true,
+    });
+    if (startLogin) {
+        console.log(chalk.dim('\nRun: codevf login\n'));
+    }
+}
+async function showInfo() {
+    console.log(chalk.bold.cyan('\n📖 What is CodeVF?\n'));
+    console.log('CodeVF connects you with vetted software engineers for live debugging');
+    console.log('and code review. Get expert help when you need it most.\n');
+    console.log(chalk.bold('🎯 Use Cases:\n'));
+    console.log(chalk.green('  ✓ ') + 'Complex bugs that AI can\'t solve alone');
+    console.log(chalk.green('  ✓ ') + 'Architecture and design decisions');
+    console.log(chalk.green('  ✓ ') + 'Code review and security audits');
+    console.log(chalk.green('  ✓ ') + 'Performance optimization');
+    console.log(chalk.green('  ✓ ') + 'Learning from experienced developers\n');
+    console.log(chalk.bold('💰 Credit-Based Pricing:\n'));
+    console.log(chalk.dim('  • Quick questions: 1-10 credits (~$0.10-$1.00)'));
+    console.log(chalk.dim('  • Extended sessions: 2 credits/minute (~$0.20/min)\n'));
+    console.log(chalk.bold('🔒 Security:\n'));
+    console.log(chalk.dim('  • Engineers only see what you share'));
+    console.log(chalk.dim('  • All sessions are private and secure'));
+    console.log(chalk.dim('  • No code is stored after sessions\n'));
+    const { next } = await prompts({
+        type: 'select',
+        name: 'next',
+        message: 'What would you like to do?',
+        choices: [
+            { title: 'Set up Claude Code Integration', value: 'mcp' },
+            { title: 'Set up Standalone CLI', value: 'cli' },
+            { title: 'Exit', value: 'exit' },
+        ],
+    });
+    switch (next) {
+        case 'mcp':
+            await setupMCPFlow();
+            break;
+        case 'cli':
+            await setupCLIFlow();
+            break;
+    }
+}
+/**
+ * Check if this is the first run
+ */
+export function isFirstRun() {
+    const mcpConfig = new ConfigManager('mcp-config.json');
+    const cliConfig = new ConfigManager('config.json');
+    // First run if neither config exists
+    return !mcpConfig.exists() && !cliConfig.exists();
+}
+//# sourceMappingURL=welcome.js.map

package/dist/commands/welcome.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"welcome.js","sourceRoot":"","sources":["../../src/commands/welcome.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,OAAO,MAAM,SAAS,CAAC;AAC9B,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAEzD,MAAM,WAAW,GAAG;;;;;;;;;;;;;CAanB,CAAC;AAEF,MAAM,CAAC,KAAK,UAAU,cAAc;IAClC,OAAO,CAAC,KAAK,EAAE,CAAC;IAChB,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC;IAErC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,2BAA2B,CAAC,CAAC,CAAC;IACrD,OAAO,CAAC,GAAG,CAAC,yDAAyD,CAAC,CAAC;IAEvE,MAAM,EAAE,SAAS,EAAE,GAAG,MAAM,OAAO,CAAC;QAClC,IAAI,EAAE,QAAQ;QACd,IAAI,EAAE,WAAW;QACjB,OAAO,EAAE,mCAAmC;QAC5C,OAAO,EAAE;YACP;gBACE,KAAK,EAAE,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,4BAA4B,CAAC,GAAG,KAAK,CAAC,GAAG,CAAC,gBAAgB,CAAC;gBACnF,WAAW,EAAE,mEAAmE;gBAChF,KAAK,EAAE,KAAK;aACb;YACD;gBACE,KAAK,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,mBAAmB,CAAC,GAAG,KAAK,CAAC,GAAG,CAAC,SAAS,CAAC;gBAClE,WAAW,EAAE,oEAAoE;gBACjF,KAAK,EAAE,KAAK;aACb;YACD;gBACE,KAAK,EAAE,KAAK,CAAC,GAAG,CAAC,gBAAgB,CAAC;gBAClC,WAAW,EAAE,4BAA4B;gBACzC,KAAK,EAAE,MAAM;aACd;YACD;gBACE,KAAK,EAAE,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAC;gBAC1B,WAAW,EAAE,YAAY;gBACzB,KAAK,EAAE,MAAM;aACd;SACF;QACD,OAAO,EAAE,CAAC;KACX,CAAC,CAAC;IAEH,IAAI,CAAC,SAAS,IAAI,SAAS,KAAK,MAAM,EAAE,CAAC;QACvC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,6CAA6C,CAAC,CAAC,CAAC;QACtE,OAAO;IACT,CAAC;IAED,QAAQ,SAAS,EAAE,CAAC;QAClB,KAAK,KAAK;YACR,MAAM,YAAY,EAAE,CAAC;YACrB,MAAM;QACR,KAAK,KAAK;YACR,MAAM,YAAY,EAAE,CAAC;YACrB,MAAM;QACR,KAAK,MAAM;YACT,MAAM,QAAQ,EAAE,CAAC;YACjB,MAAM;IACV,CAAC;AACH,CAAC;AAED,KAAK,UAAU,YAAY;IACzB,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,sCAAsC,CAAC,CAAC,CAAC;IAErE,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC,CAAC;IACrC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,+BAA+B,CAAC,CAAC,CAAC;IACxD,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,gDAAgD,CAAC,CAAC,CAAC;IACzE,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,uDAAuD,CAAC,CAAC,CAAC;IAEhF,MAAM,EAAE,OAAO,EAAE,GAAG,MAAM,OAAO,CAAC;QAChC,IAAI,EAAE,SAAS;QACf,IAAI,EAAE,SAAS;QACf,OAAO,EAAE,kBAAkB;QAC3B,OAAO,EAAE,IAAI;KACd,CAAC,CAAC;IAEH,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,iDAAiD,CAAC,CAAC,CAAC;QAC1E,OAAO;IACT,CAAC;IAED,wBAAwB;IACxB,MAAM,YAAY,EAAE,CAAC;IAErB,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,yCAAyC,CAAC,CAAC,CAAC;IACzE,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,oCAAoC,CAAC,CAAC,CAAC;IAC9D,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,6DAA6D,CAAC,CAAC,CAAC;IACtF,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,oEAAoE,CAAC,CAAC,CAAC;IAE7F,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC,CAAC;IAC5C,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,oBAAoB,CAAC,GAAG,KAAK,CAAC,GAAG,CAAC,4CAA4C,CAAC,CAAC,CAAC;IACzG,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,iBAAiB,CAAC,GAAG,KAAK,CAAC,GAAG,CAAC,wDAAwD,CAAC,CAAC,CAAC;AACpH,CAAC;AAED,KAAK,UAAU,YAAY;IACzB,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,6BAA6B,CAAC,CAAC,CAAC;IAE5D,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,yEAAyE,CAAC,CAAC,CAAC;IACrG,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,6CAA6C,CAAC,CAAC,CAAC;IAEzE,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC,CAAC;IACxC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,4CAA4C,CAAC,CAAC,CAAC;IACrE,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,uCAAuC,CAAC,CAAC,CAAC;IAChE,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,uCAAuC,CAAC,CAAC,CAAC;IAEhE,MAAM,EAAE,OAAO,EAAE,GAAG,MAAM,OAAO,CAAC;QAChC,IAAI,EAAE,SAAS;QACf,IAAI,EAAE,SAAS;QACf,OAAO,EAAE,0BAA0B;QACnC,OAAO,EAAE,KAAK;KACf,CAAC,CAAC;IAEH,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,oEAAoE,CAAC,CAAC,CAAC;QAC7F,OAAO;IACT,CAAC;IAED,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,sBAAsB,CAAC,CAAC,CAAC;IAChD,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,gBAAgB,CAAC,GAAG,KAAK,CAAC,GAAG,CAAC,+BAA+B,CAAC,CAAC,CAAC;IACvF,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,eAAe,CAAC,GAAG,KAAK,CAAC,GAAG,CAAC,0BAA0B,CAAC,CAAC,CAAC;IACjF,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,cAAc,CAAC,GAAG,KAAK,CAAC,GAAG,CAAC,qCAAqC,CAAC,CAAC,CAAC;IAC3F,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,eAAe,CAAC,GAAG,KAAK,CAAC,GAAG,CAAC,wBAAwB,CAAC,CAAC,CAAC;IAE/E,MAAM,EAAE,UAAU,EAAE,GAAG,MAAM,OAAO,CAAC;QACnC,IAAI,EAAE,SAAS;QACf,IAAI,EAAE,YAAY;QAClB,OAAO,EAAE,mBAAmB;QAC5B,OAAO,EAAE,IAAI;KACd,CAAC,CAAC;IAEH,IAAI,UAAU,EAAE,CAAC;QACf,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,uBAAuB,CAAC,CAAC,CAAC;IAClD,CAAC;AACH,CAAC;AAED,KAAK,UAAU,QAAQ;IACrB,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,wBAAwB,CAAC,CAAC,CAAC;IAEvD,OAAO,CAAC,GAAG,CAAC,uEAAuE,CAAC,CAAC;IACrF,OAAO,CAAC,GAAG,CAAC,2DAA2D,CAAC,CAAC;IAEzE,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC,CAAC;IAC3C,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,yCAAyC,CAAC,CAAC;IAC7E,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,mCAAmC,CAAC,CAAC;IACvE,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,iCAAiC,CAAC,CAAC;IACrE,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,0BAA0B,CAAC,CAAC;IAC9D,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,wCAAwC,CAAC,CAAC;IAE5E,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,4BAA4B,CAAC,CAAC,CAAC;IACtD,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,kDAAkD,CAAC,CAAC,CAAC;IAC3E,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,wDAAwD,CAAC,CAAC,CAAC;IAEjF,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC,CAAC;IAC1C,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,uCAAuC,CAAC,CAAC,CAAC;IAChE,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,yCAAyC,CAAC,CAAC,CAAC;IAClE,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,wCAAwC,CAAC,CAAC,CAAC;IAEjE,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,OAAO,CAAC;QAC7B,IAAI,EAAE,QAAQ;QACd,IAAI,EAAE,MAAM;QACZ,OAAO,EAAE,4BAA4B;QACrC,OAAO,EAAE;YACP,EAAE,KAAK,EAAE,gCAAgC,EAAE,KAAK,EAAE,KAAK,EAAE;YACzD,EAAE,KAAK,EAAE,uBAAuB,EAAE,KAAK,EAAE,KAAK,EAAE;YAChD,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE;SACjC;KACF,CAAC,CAAC;IAEH,QAAQ,IAAI,EAAE,CAAC;QACb,KAAK,KAAK;YACR,MAAM,YAAY,EAAE,CAAC;YACrB,MAAM;QACR,KAAK,KAAK;YACR,MAAM,YAAY,EAAE,CAAC;YACrB,MAAM;IACV,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,UAAU;IACxB,MAAM,SAAS,GAAG,IAAI,aAAa,CAAC,iBAAiB,CAAC,CAAC;IACvD,MAAM,SAAS,GAAG,IAAI,aAAa,CAAC,aAAa,CAAC,CAAC;IAEnD,qCAAqC;IACrC,OAAO,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,CAAC;AACpD,CAAC"}

package/dist/index.js

@@ -4,177 +4,189 @@ import 'dotenv/config';
 import yargs from 'yargs';
 import { hideBin } from 'yargs/helpers';
 import chalk from 'chalk';
-import prompts from 'prompts';
-import { exec, spawn } from 'child_process';
-import { promisify } from 'util';
 import { loginCommand } from './commands/login.js';
 import { logoutCommand } from './commands/logout.js';
+import { setupCommand } from './commands/setup.js';
+import { welcomeCommand, isFirstRun } from './commands/welcome.js';
 import { initCommand } from './commands/init.js';
 import { syncCommand } from './commands/sync.js';
 import { fixCommand } from './commands/fix.js';
 import { tasksCommand } from './commands/tasks.js';
 import { handleError } from './utils/errors.js';
 import { ConfigManager } from './modules/config.js';
-const CLI_VERSION = '1.0.0';
-const execAsync = promisify(exec);
+import { AiAgent } from './modules/aiAgent.js';
+import React from 'react';
+import { render } from 'ink';
+import { CLI_VERSION } from './modules/constants.js';
+import { InteractiveApp } from './ui/InteractiveApp.js';
+import { renderHeader, renderQuickCommands, showModeSwitched, } from './ui/SessionUI.js';
+import { handleSlashCommand, isSlashCommand, handleHybridMode, handleAiMode, handleHumanMode, } from './modules/commandHandler.js';
 const args = hideBin(process.argv);
-if (args.length === 0) {
-    // Minimal interactive entry (Codex-style): no question, just a prompt
-    (async () => {
+/**
+ * Safely loads config without throwing errors
+ */
+function loadConfigSafely(configManager) {
+    if (configManager.isInitialized()) {
         try {
-            const cwd = process.cwd();
-            const configManager = new ConfigManager();
-            const isInitialized = configManager.isInitialized();
-            const boxInfo = isInitialized
-                ? chalk.green(`Initialized project: ${configManager.loadConfig().projectId}`)
-                : chalk.yellow('Not initialized (run `codevf init`)');
-            // Header box similar to Codex
-            const boxLines = [
-                `${chalk.dim('>_')} ${chalk.bold.white('CodeVF CLI')} ${chalk.dim(`(v${CLI_VERSION})`)}`,
-                `${chalk.dim('model:')}  ${chalk.cyan('codevf-live')}  ${chalk.dim('/human to ask for help')}`,
-                `${chalk.dim('dir:')}    ${chalk.cyan(cwd)}`,
-                `${chalk.dim('init:')}   ${boxInfo}`,
-            ];
-            const maxLen = Math.max(...boxLines.map((l) => l.length));
-            const width = maxLen + 2; // padding inside box
-            const border = chalk.dim('┌' + '─'.repeat(width) + '┐');
-            const footer = chalk.dim('└' + '─'.repeat(width) + '┘');
-            console.log('\n' + border);
-            boxLines.forEach((line) => {
-                const padLength = width - line.length;
-                const padding = padLength > 0 ? ' '.repeat(padLength) : '';
-                console.log(chalk.dim('│') + line + padding + chalk.dim('│'));
-            });
-            console.log(footer + '\n');
-            console.log(chalk.dim('To get started, type your issue or one of these commands:\n'));
-            const commands = [
-                ['/human <text>', 'ask for help from a human engineer'],
-                ['/shell', 'switch to local shell (not shared)'],
-                ['/codevf', 'return from shell to session'],
-                ['/end', 'end the session'],
-                ['/tasks', 'list open tasks'],
-                ['/cancel <id>', 'cancel a task'],
-                ['/?', 'list commands'],
-                ['/exit', 'quit the CLI'],
-            ];
-            commands.forEach(([cmd, desc]) => {
-                console.log(`${chalk.white(cmd.padEnd(15))}${chalk.dim('–')} ${chalk.gray(desc)}`);
+            return configManager.loadConfig();
+        }
+        catch (error) {
+            return null;
+        }
+    }
+    return null;
+}
+/**
+ * Interactive session mode - main entry point when no arguments provided
+ */
+async function runInteractiveMode() {
+    try {
+        const configManager = new ConfigManager();
+        let loadedConfig = loadConfigSafely(configManager);
+        const isInitialized = configManager.isInitialized();
+        let aiEnabled = !!loadedConfig?.ai?.enabled;
+        let routingMode = aiEnabled ? 'hybrid' : 'human';
+        let agentMode = 'build';
+        const aiAgent = new AiAgent(configManager);
+        const logUserMessage = (message) => {
+            // Display the user's input inside a full-width highlight block, left-aligned
+            const columns = process.stdout.columns || 80;
+            const lines = message.split(/\r?\n/);
+            const contentWidth = Math.min(Math.max(...lines.map((line) => line.length), 1), columns - 6);
+            const horizontalPad = '  ';
+            const totalWidth = Math.min(columns, contentWidth + horizontalPad.length * 2);
+            const fullLine = (text) => {
+                const padded = text.padEnd(contentWidth, ' ');
+                return chalk.bgGray.white(`${horizontalPad}${padded}${horizontalPad}`);
+            };
+            lines.forEach((line) => {
+                console.log(fullLine(line));
             });
-            console.log();
+        };
+        // Render header and quick commands
+        renderHeader(isInitialized, loadedConfig);
+        renderQuickCommands(isInitialized, aiEnabled, aiEnabled, agentMode);
+        // Command submission handler
+        const handleSubmit = async (text, mode) => {
+            const trimmed = text.trim();
+            logUserMessage(trimmed);
+            // Handle slash commands
+            if (isSlashCommand(trimmed)) {
+                await handleSlashCommand(trimmed, {
+                    configManager,
+                    aiAgent,
+                    routingMode: mode,
+                    agentMode,
+                    aiEnabled,
+                    autoAcceptMode: false,
+                    loadedConfig,
+                });
+                return;
+            }
+            // Route to appropriate mode handler
+            if (mode === 'hybrid' && aiEnabled) {
+                await handleHybridMode(trimmed, {
+                    configManager,
+                    aiAgent,
+                    routingMode: mode,
+                    agentMode,
+                    aiEnabled,
+                    autoAcceptMode: false,
+                    loadedConfig,
+                });
+            }
+            else if (mode === 'ai' && aiEnabled) {
+                await handleAiMode(trimmed, {
+                    configManager,
+                    aiAgent,
+                    routingMode: mode,
+                    agentMode,
+                    aiEnabled,
+                    autoAcceptMode: false,
+                    loadedConfig,
+                });
+            }
+            else {
+                await handleHumanMode(trimmed);
+            }
+        };
+        // Try to use ink - it will handle raw mode setup internally
+        try {
+            // Render ink app and keep it mounted
+            render(React.createElement(InteractiveApp, {
+                initialRoutingMode: routingMode,
+                initialAgentMode: agentMode,
+                aiEnabled,
+                onSubmit: handleSubmit,
+                onModeChange: (mode) => {
+                    routingMode = mode;
+                    showModeSwitched(mode);
+                },
+                onAgentModeChange: (mode) => {
+                    agentMode = mode;
+                },
+            }));
+        }
+        catch (inkError) {
+            // Fallback if ink fails
+            console.error(chalk.yellow('\nWarning: Interactive mode requires TTY support'));
+            console.log(chalk.yellow('\nFalling back to compatibility mode (paste support disabled)'));
+            console.log(chalk.cyan('\nFor full features with paste support, run directly:'));
+            console.log(chalk.white('  cd ' + process.cwd()));
+            console.log(chalk.white('  CODEVF_API_URL=http://localhost:3000 tsx src/index.ts\n'));
+            const readline = await import('readline');
             while (true) {
-                let shellMode = false;
-                const shellHistory = [];
-                console.log(chalk.dim('Type /? for menu'));
-                const { line } = await prompts({
-                    type: 'text',
-                    name: 'line',
-                    message: chalk.bold('codevf> '),
+                const rl = readline.createInterface({
+                    input: process.stdin,
+                    output: process.stdout,
                 });
-                if (!line || !line.trim()) {
-                    // empty input: re-prompt instead of exiting
-                    continue;
-                }
-                let trimmed = line.trim();
-                // Any slash command is handled locally; do not start a session
-                if (trimmed.startsWith('/')) {
-                    if (['/?', '/help', '/commands'].includes(trimmed)) {
-                        console.log();
-                        console.log(chalk.white('/human <text>').padEnd(18) + chalk.gray('ask for help from a human engineer'));
-                        console.log(chalk.white('/shell').padEnd(18) + chalk.gray('local shell (not shared)'));
-                        console.log(chalk.white('/codevf').padEnd(18) + chalk.gray('back to session'));
-                        console.log(chalk.white('/end').padEnd(18) + chalk.gray('end the session'));
-                        console.log(chalk.white('/tasks').padEnd(18) + chalk.gray('list open tasks'));
-                        console.log(chalk.white('/cancel <id>').padEnd(18) + chalk.gray('cancel a task'));
-                        console.log(chalk.white('/?').padEnd(18) + chalk.gray('list commands'));
-                        console.log(chalk.white('/exit').padEnd(18) + chalk.gray('quit'));
-                        console.log();
-                        continue;
-                    }
-                    else if (trimmed === '/tasks') {
-                        await tasksCommand(undefined);
+                const getModeIndicator = (mode) => {
+                    switch (mode) {
+                        case 'hybrid':
+                            return chalk.green('[Hybrid]');
+                        case 'ai':
+                            return chalk.cyan('[AI]');
+                        case 'human':
+                            return chalk.magenta('[Human]');
+                        default:
+                            return chalk.white('[Unknown]');
                     }
-                    else if (trimmed.startsWith('/cancel ')) {
-                        const id = trimmed.replace('/cancel', '').trim();
-                        if (!id) {
-                            console.log(chalk.red('Usage: /cancel <taskId>'));
-                        }
-                        else {
-                            await tasksCommand(id);
-                        }
-                    }
-                    else if (trimmed === '/exit' || trimmed === '/quit') {
-                        console.log(chalk.dim('Goodbye.'));
-                        process.exit(0);
-                    }
-                    else if (trimmed === '/shell') {
-                        shellMode = true;
-                        console.log(chalk.dim('Entered local shell mode (not shared). Type /resume to go back.'));
-                        // enter shell loop
-                        while (shellMode) {
-                            const { line: shellLine } = await prompts({
-                                type: 'text',
-                                name: 'line',
-                                message: chalk.bold('shell> ') + chalk.dim('(local)'),
-                            });
-                            if (!shellLine) {
-                                continue;
-                            }
-                            const shellTrimmed = shellLine.trim();
-                            if (shellTrimmed === '/resume' || shellTrimmed === '/session' || shellTrimmed === '/codevf') {
-                                shellMode = false;
-                                console.log(chalk.dim('Back to CodeVF prompt.'));
-                                continue;
-                            }
-                            if (shellTrimmed === '/exit' || shellTrimmed === '/quit') {
-                                console.log(chalk.dim('Goodbye.'));
-                                process.exit(0);
-                            }
-                            if (shellTrimmed.startsWith('/')) {
-                                console.log(chalk.yellow(`Unknown command in shell: ${shellTrimmed}`));
-                                console.log(chalk.dim('Use /resume to return to the session prompt.'));
-                                continue;
-                            }
-                            try {
-                                await new Promise((resolve) => {
-                                    const child = spawn(shellTrimmed, {
-                                        shell: true,
-                                        stdio: 'inherit',
-                                        cwd: process.cwd(),
-                                    });
-                                    child.on('exit', () => resolve());
-                                    child.on('error', (err) => {
-                                        console.log(chalk.red(`Command failed: ${err.message}`));
-                                        resolve();
-                                    });
-                                });
-                                shellHistory.push(`$ ${shellTrimmed} (ran with stdio:inherit)`);
-                            }
-                            catch (error) {
-                                console.log(chalk.red(`Command failed: ${error.message || error}`));
-                            }
-                        }
-                    }
-                    else {
-                        console.log(chalk.yellow(`Unknown command: ${trimmed}`));
-                        console.log(chalk.dim('Type /? to see available commands.'));
-                    }
-                    continue;
+                };
+                const answer = await new Promise((resolve) => {
+                    rl.question(`  ${getModeIndicator(routingMode)} ${chalk.dim('›')} `, (answer) => {
+                        rl.close();
+                        resolve(answer);
+                    });
+                });
+                if (answer.trim()) {
+                    await handleSubmit(answer.trim(), routingMode);
                 }
-                await fixCommand(trimmed);
-                // After session ends, return to prompt loop
             }
         }
-        catch (error) {
-            handleError(error);
-        }
-    })();
+    }
+    catch (error) {
+        handleError(error);
+    }
+}
+/**
+ * Command-line argument mode - handle specific commands
+ */
+if (args.length === 0) {
+    // Check if this is the first run
+    if (isFirstRun()) {
+        welcomeCommand().catch(handleError);
+    }
+    else {
+        runInteractiveMode();
+    }
 }
 else {
     yargs(args)
         .scriptName('codevf')
         .version(CLI_VERSION)
         .usage('$0 <command> [options]')
-        .command('login', 'Authenticate with CodeVF', () => { }, async () => {
+        .epilogue('For first-time setup, run: codevf welcome\nDocumentation: https://docs.codevf.com')
+        .command('login', 'Authenticate with CodeVF (for CLI usage)', () => { }, async () => {
         try {
             await loginCommand();
         }
@@ -189,6 +201,22 @@ else {
         catch (error) {
             handleError(error);
         }
+    })
+        .command('setup', 'Configure MCP server for Claude Code integration', () => { }, async () => {
+        try {
+            await setupCommand();
+        }
+        catch (error) {
+            handleError(error);
+        }
+    })
+        .command('welcome', 'Show welcome screen and setup guide', () => { }, async () => {
+        try {
+            await welcomeCommand();
+        }
+        catch (error) {
+            handleError(error);
+        }
     })
         .command('init', 'Initialize CodeVF in your project', () => { }, async () => {
         try {
@@ -222,13 +250,30 @@ else {
         }
     })
         .command('fix <issue>', 'Start a live debugging session', (yargs) => {
-        return yargs.positional('issue', {
+        return yargs
+            .positional('issue', {
             type: 'string',
             describe: 'Description of the issue to fix (or type commands like /human need help with X)',
             demandOption: true,
+        })
+            .option('ai', {
+            type: 'boolean',
+            default: false,
+            describe: 'Route through local AI (opencode SDK) if enabled',
+        })
+            .option('no-start-server', {
+            type: 'boolean',
+            default: false,
+            describe: 'Do not auto-start opencode server; require existing server',
         });
     }, async (argv) => {
         try {
+            if (argv.ai) {
+                const configManager = new ConfigManager();
+                const aiAgent = new AiAgent(configManager);
+                await aiAgent.run(argv.issue, { startServer: !argv['no-start-server'] });
+                return;
+            }
             await fixCommand(argv.issue);
         }
         catch (error) {