codevf 1.0.4 → 1.0.7

package/README.md

@@ -1,158 +1,57 @@
 # CodeVF CLI
 
-**⚠️ BETA:** Connect Claude Code to live human engineers for complex debugging.
+Connect Claude Code, Codex, or Gemini to live human engineers.
 
-## Installation
+## Install
 
 ```bash
 npm install -g codevf
 ```
 
-## Quick Start
+## Quick Start (Claude Code)
 
-The CodeVF CLI is currently in **setup-only mode** for connecting Claude Code to CodeVF's MCP server:
+1. `codevf setup`
+2. In Claude Code, type `claude`
+3. It works out of the box
 
-```bash
-# Setup MCP server integration with Claude Code
-codevf setup
+Use `/cvf` in Claude Code to force CodeVF.
 
-# After setup, use Claude Code with /cvf commands:
-# /cvf Does this authentication fix prevent timing attacks?
-# /cvf Complex race condition in WebSocket reconnection needs debugging  
-# /cvf Create tunnel to my dev server on port 3000
-```
+## Quick Start (Codex)
+
+1. `codevf setup`
+2. In Codex, type `codex`
+3. It works out of the box
+
+Use `/mcp` in Codex to confirm CodeVF is connected.
 
-**Three tools available in Claude Code:**
-- `codevf-instant` - Quick validation queries (4-minute max)
-- `codevf-chat` - Extended debugging sessions (up to 2 hours) 
-- `codevf-tunnel` - Share local dev servers securely
+## Quick Start (Gemini)
+
+1. `codevf setup`
+2. In Gemini, restart the client
+3. It works out of the box
 
 ## Commands
 
-### `codevf setup` (Beta - Primary Command)
-Configure MCP server integration with Claude Code:
+### `codevf setup`
+Configure MCP server integration with Claude Code, Codex, and Gemini:
 - Authenticate with CodeVF using OAuth
 - Auto-configure Claude Code's `~/.claude.json` file
-- Create `/cvf` slash command for Claude Code
+- Create Claude Code slash commands for CodeVF
 - Select default project for context
 
-### Claude Code Integration (After Setup)
-Once configured, use these tools directly in Claude Code:
-
-**`/cvf [message]` - Smart routing to appropriate tool**
-- Quick questions → `codevf-instant` (4min max, good for validation)
-- Complex debugging → `codevf-chat` (extended sessions up to 2 hours)
-- Local server access → `codevf-tunnel` (share dev servers securely)
-
-**Example usage:**
-```
-/cvf Does this authentication fix prevent timing attacks?
-/cvf Complex race condition in WebSocket reconnection needs debugging
-/cvf Create tunnel to my dev server on port 3000
-```
+### `codevf mcp stdio`
+Start the MCP server for non-Claude clients:
+- `codevf mcp stdio` - Launch MCP over stdio (command/args-based clients)
 
-### Other Commands (Disabled in Beta)
-The following commands exist but are **disabled** in beta mode:
-- `codevf login` - Direct CLI authentication (use `setup` instead)
-- `codevf init` - Project initialization (handled via MCP tools)
-- `codevf fix` - Direct CLI debugging sessions (use Claude Code instead)
-- `codevf sync` - Repository sync (handled via MCP tools)
-
-## How It Works
-
-1. **Setup once** - Run `codevf setup` to configure Claude Code integration
-2. **Work in Claude Code** - Use `/cvf` commands to access human engineers
-3. **Get matched with experts** - Ex-FAANG engineers with expertise in your stack
-4. **Context-aware handoff** - Engineers see your Claude conversation for faster resolution
-5. **Hybrid approach** - AI handles quick questions, humans tackle complex debugging
-6. **Pay per minute** - Only pay for active engineering time
-
-## Security & Privacy
-
-- **MCP integration** - No direct code access, works through Claude Code's security model
-- **Context sharing** - Engineers see your Claude conversation for better assistance
-- **Explicit permission** - Engineers request specific actions with your approval
-- **Audit trail** - All engineer actions are logged and auditable
-- **Secure tunnels** - Local dev servers shared via encrypted tunnels only when requested
-- **Session-based** - No persistent code storage, only active session context
-
-## Configuration
-
-After running `codevf setup`, configuration is stored in:
-
-**MCP Configuration** (`~/.config/codevf/mcp-config.json`):
-```json
-{
-  "auth": {
-    "accessToken": "jwt-token",
-    "refreshToken": "jwt-token", 
-    "userId": "user-uuid"
-  },
-  "defaultProjectId": "project-uuid",
-  "baseUrl": "https://app.codevf.com"
-}
-```
-
-**Claude Code Configuration** (auto-configured in `~/.claude.json`):
-```json
-{
-  "mcpServers": {
-    "codevf": {
-      "command": "node",
-      "args": ["/path/to/codevf/dist/mcp/index.js"]
-    }
-  }
-}
-```
+### `codevf mcp http --port 3333`
+Start the MCP server over HTTP/SSE for non-Claude clients:
+- `codevf mcp http --port 3333` - Launch MCP over HTTP/SSE (shows endpoints)
 
 ## Requirements
 
-- Node.js 18 or higher
-- [Claude Code (Desktop App)](https://claude.ai/download) - Required for MCP integration
+- Node.js 18+
+- [Claude Code (Desktop App)](https://claude.ai/download)
 - Internet connection
-- CodeVF account (created during setup)
-
-### Installing Claude Code
-
-If you don't have Claude Code installed:
-
-**macOS:**
-```bash
-# Download from website
-open https://claude.ai/download
-
-# Or using Homebrew
-brew install --cask claude
-```
-
-**Windows:**
-```bash
-# Download installer from website
-start https://claude.ai/download
-```
-
-**Linux:**
-```bash
-# Download AppImage from website
-curl -L https://claude.ai/download -o claude.appimage
-chmod +x claude.appimage
-./claude.appimage
-```
-
-**Note:** Claude Code requires an Anthropic account. Create one at [claude.ai](https://claude.ai) if needed.
-
-## Beta Status & Roadmap
-
-**Current Beta Features:**
-- ✅ MCP server integration with Claude Code
-- ✅ Three tools: instant, chat, tunnel  
-- ✅ OAuth authentication and project selection
-
-**Coming Soon:**
-- 🔄 Direct CLI debugging sessions (`codevf fix`)
-- 🔄 Project initialization (`codevf init`) 
-- 🔄 Repository sync (`codevf sync`)
-- 🔄 Standalone terminal UI
 
 ## Support
 
@@ -162,4 +61,4 @@ chmod +x claude.appimage
 
 ## License
 
-Commercial license — see `LICENSE`. Use is limited to interacting with CodeVF services; no redistribution or competing uses.
+Commercial license — see `LICENSE`.

package/dist/commands/cvf-command-content.d.ts

@@ -1,2 +1,2 @@
-export declare const commandContent = "---\ndescription: Ask a CodeVF engineer for help with code validation, debugging, or technical questions\n---\n\n# CodeVF Engineer Assistance\n\nPlease help me with the following question or task by consulting a CodeVF engineer using the appropriate MCP tool:\n\n**My request:**\n{{PROMPT}}\n\n---\n\n**Instructions for Claude:**\n\n1. **Analyze the request** to determine which CodeVF tool is most appropriate:\n   - Use `codevf-instant` for:\n     - Quick validation questions (1-10 credits, ~2 min response)\n     - \"Does this fix work?\"\n     - \"Is this approach correct?\"\n     - \"Can you identify the error?\"\n     - UI/visual verification and feedback\n     - Simple technical questions\n\n   - Use `codevf-chat` for:\n     - Complex debugging requiring back-and-forth (4-1920 credits, 2 credits/min)\n     - Multi-step troubleshooting\n     - Architecture discussions\n     - Extended collaboration\n\n   - Use `codevf-tunnel` for:\n     - Creating secure tunnels to expose local dev servers\n     - Testing webhooks, OAuth callbacks, or external integrations\n     - Sharing local development environment with engineers\n     - No credits required - tunnel remains active for session\n\n2. **For UI/Visual Development Tasks** (Pain-Free Experience):\n\n   When implementing UI changes or visual features, follow this iterative flow:\n\n   **Step 1 - Initial Implementation:**\n   - Make the requested changes to code/styles\n   - Create tunnel if needed: `codevf-tunnel` with dev server port\n   - Share tunnel URL for visual verification\n\n   **Step 2 - Engineer Verification:**\n   - Use `codevf-instant` with message like:\n     \"Please verify this UI change via [tunnel-url] (password: [password]). Does it match the requested design/functionality?\"\n   - **Always include both URL and password** - localtunnel requires password to bypass landing page\n   - Include specific areas of focus (layout, spacing, colors, interactions)\n   - Allow 5-8 credits for visual review and feedback\n\n   **Step 3 - Iterative Refinement:**\n   - Apply engineer feedback immediately\n   - Use `codevf-instant` again for re-verification:\n     \"Applied your feedback (reduced padding to 16px). Please check if this looks better now at [tunnel-url] (same password).\"\n   - Continue this cycle until engineer confirms it looks right\n   - Each feedback cycle: 3-5 credits\n\n   **Example UI Flow:**\n   ```\n   User: \"Make the UI look like a modern card layout\"\n\n   Claude:\n   1. Implements card styling\n   2. Creates tunnel \u2192 https://abc123.loca.lt (password: xyz789)\n   3. codevf-instant: \"Please review the card layout at https://abc123.loca.lt\n      (password: xyz789). Does it look modern and clean? Any spacing/styling issues?\" (5 credits)\n\n   Engineer: \"Cards look good but margins are too large, reduce to 16px\"\n\n   Claude:\n   4. Updates margins to 16px\n   5. codevf-instant: \"Applied 16px margins. Please verify the spacing\n      looks better now at https://abc123.loca.lt (password: xyz789).\" (3 credits)\n\n   Engineer: \"Perfect! The spacing looks much cleaner now.\"\n   ```\n\n3. **Use the appropriate tool:**\n   - For instant queries: Call `codevf-instant` with the message and appropriate maxCredits (1-10)\n   - For extended sessions: Call `codevf-chat` with the message and appropriate maxCredits (suggest 240 for ~2 hours)\n   - For tunnel access: Call `codevf-tunnel` with the port number (e.g., { \"port\": 3000 })\n\n4. **Present the response:**\n   - For instant queries: Share the engineer's response directly\n   - For chat sessions: Provide the session URL so the user can monitor the conversation\n   - For tunnels: Share the public URL that was created\n\n**Credit Guidelines:**\n- Instant validation: 1-10 credits (typically 3-5 credits per question)\n- UI verification: 5-8 credits for initial review, 3-5 credits for follow-up checks\n- Extended chat: 2 credits per minute (240 credits = 2 hours)\n- Tunnel creation: Free (no credits required)\n\n**Planning Integration for Complex Tasks:**\nWhen Claude is planning multi-step implementations, especially UI-heavy tasks:\n- Always include \"Engineer verification checkpoints\" in the plan\n- Budget credits for iterative feedback (typically 15-25 credits total for UI refinement)\n- Create tunnel early in the process for continuous visual validation\n- Plan for 2-4 feedback cycles to achieve the desired result\n\n**Example Usage:**\n- `/cvf Does this authentication fix prevent the timing attack?` \u2192 Use codevf-instant\n- `/cvf Complex race condition in WebSocket reconnection needs debugging` \u2192 Use codevf-chat\n- `/cvf Create tunnel to my dev server on port 3000` \u2192 Use codevf-tunnel\n- `/cvf Make the login form look more modern and user-friendly` \u2192 Use tunnel + iterative codevf-instant feedback\n";
+export declare const commandContent = "---\ndescription: Ask a CodeVF engineer for help with code validation, debugging, or technical questions\n---\n\n# CodeVF Engineer Assistance\n\nPlease help me with the following question or task by consulting a CodeVF engineer using the appropriate MCP tool:\n\n**My request:**\n{{PROMPT}}\n\n---\n\n**Available CodeVF Commands:**\n- `codevf setup` - Configure MCP server for Claude Code, Codex, and Gemini\n- `codevf mcp stdio` - Start MCP server over stdio\n- `codevf mcp http --port 3333` - Start MCP server over HTTP/SSE\n\n**Instructions for Claude:**\n\n1. **Analyze the request** to determine which CodeVF tool is most appropriate:\n   - Use `codevf-instant` for:\n     - Quick validation questions (1-10 credits, ~2 min response)\n     - \"Does this fix work?\"\n     - \"Is this approach correct?\"\n     - \"Can you identify the error?\"\n     - UI/visual verification and feedback\n     - Simple technical questions\n\n   - Use `codevf-chat` for:\n     - Complex debugging requiring back-and-forth (4-1920 credits, 2 credits/min)\n     - Multi-step troubleshooting\n     - Architecture discussions\n     - Extended collaboration\n\n   - Use `codevf-tunnel` for:\n     - Creating secure tunnels to expose local dev servers\n     - Testing webhooks, OAuth callbacks, or external integrations\n     - Sharing local development environment with engineers\n     - No credits required - tunnel remains active for session\n\n2. **For UI/Visual Development Tasks** (Pain-Free Experience):\n\n   When implementing UI changes or visual features, follow this iterative flow:\n\n   **Step 1 - Initial Implementation:**\n   - Make the requested changes to code/styles\n   - Create tunnel if needed: `codevf-tunnel` with dev server port\n   - Share tunnel URL for visual verification\n\n   **Step 2 - Engineer Verification:**\n   - Use `codevf-instant` with message like:\n     \"Please verify this UI change via [tunnel-url] (password: [password]). Does it match the requested design/functionality?\"\n   - **Always include both URL and password** - localtunnel requires password to bypass landing page\n   - Include specific areas of focus (layout, spacing, colors, interactions)\n   - Allow 5-8 credits for visual review and feedback\n\n   **Step 3 - Iterative Refinement:**\n   - Apply engineer feedback immediately\n   - Use `codevf-instant` again for re-verification:\n     \"Applied your feedback (reduced padding to 16px). Please check if this looks better now at [tunnel-url] (same password).\"\n   - Continue this cycle until engineer confirms it looks right\n   - Each feedback cycle: 3-5 credits\n\n   **Example UI Flow:**\n   ```\n   User: \"Make the UI look like a modern card layout\"\n\n   Claude:\n   1. Implements card styling\n   2. Creates tunnel \u2192 https://abc123.loca.lt (password: xyz789)\n   3. codevf-instant: \"Please review the card layout at https://abc123.loca.lt\n      (password: xyz789). Does it look modern and clean? Any spacing/styling issues?\" (5 credits)\n\n   Engineer: \"Cards look good but margins are too large, reduce to 16px\"\n\n   Claude:\n   4. Updates margins to 16px\n   5. codevf-instant: \"Applied 16px margins. Please verify the spacing\n      looks better now at https://abc123.loca.lt (password: xyz789).\" (3 credits)\n\n   Engineer: \"Perfect! The spacing looks much cleaner now.\"\n   ```\n\n3. **Use the appropriate tool:**\n   - For instant queries: Call `codevf-instant` with the message and appropriate maxCredits (1-10)\n   - For extended sessions: Call `codevf-chat` with the message and appropriate maxCredits (suggest 240 for ~2 hours)\n   - For tunnel access: Call `codevf-tunnel` with the port number (e.g., { \"port\": 3000 })\n\n4. **Present the response:**\n   - For instant queries: Share the engineer's response directly\n   - For chat sessions: Provide the session URL so the user can monitor the conversation\n   - For tunnels: Share the public URL that was created\n\n**Credit Guidelines:**\n- Instant validation: 1-10 credits (typically 3-5 credits per question)\n- UI verification: 5-8 credits for initial review, 3-5 credits for follow-up checks\n- Extended chat: 2 credits per minute (240 credits = 2 hours)\n- Tunnel creation: Free (no credits required)\n\n**Planning Integration for Complex Tasks:**\nWhen Claude is planning multi-step implementations, especially UI-heavy tasks:\n- Always include \"Engineer verification checkpoints\" in the plan\n- Budget credits for iterative feedback (typically 15-25 credits total for UI refinement)\n- Create tunnel early in the process for continuous visual validation\n- Plan for 2-4 feedback cycles to achieve the desired result\n\n**Example Usage:**\n- `/cvf Does this authentication fix prevent the timing attack?` \u2192 Use codevf-instant\n- `/cvf Complex race condition in WebSocket reconnection needs debugging` \u2192 Use codevf-chat\n- `/cvf Create tunnel to my dev server on port 3000` \u2192 Use codevf-tunnel\n- `/cvf Make the login form look more modern and user-friendly` \u2192 Use tunnel + iterative codevf-instant feedback\n";
 //# sourceMappingURL=cvf-command-content.d.ts.map

package/dist/commands/cvf-command-content.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cvf-command-content.d.ts","sourceRoot":"","sources":["../../src/commands/cvf-command-content.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,cAAc,2uJA2G1B,CAAC"}
+{"version":3,"file":"cvf-command-content.d.ts","sourceRoot":"","sources":["../../src/commands/cvf-command-content.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,cAAc,+8JAgH1B,CAAC"}

package/dist/commands/cvf-command-content.js

@@ -11,6 +11,11 @@ Please help me with the following question or task by consulting a CodeVF engine
 
 ---
 
+**Available CodeVF Commands:**
+- \`codevf setup\` - Configure MCP server for Claude Code, Codex, and Gemini
+- \`codevf mcp stdio\` - Start MCP server over stdio
+- \`codevf mcp http --port 3333\` - Start MCP server over HTTP/SSE
+
 **Instructions for Claude:**
 
 1. **Analyze the request** to determine which CodeVF tool is most appropriate:

package/dist/commands/cvf-command-content.js.map

@@ -1 +1 @@
-{"version":3,"file":"cvf-command-content.js","sourceRoot":"","sources":["../../src/commands/cvf-command-content.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,cAAc,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA2G7B,CAAC"}
+{"version":3,"file":"cvf-command-content.js","sourceRoot":"","sources":["../../src/commands/cvf-command-content.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,cAAc,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAgH7B,CAAC"}

package/dist/commands/mcp.d.ts

@@ -0,0 +1,10 @@
+/**
+ * MCP server commands for stdio and HTTP modes
+ */
+export interface McpHttpOptions {
+    host: string;
+    port: number;
+}
+export declare function startMcpStdio(): Promise<void>;
+export declare function startMcpHttp(options: McpHttpOptions): Promise<void>;
+//# sourceMappingURL=mcp.d.ts.map

package/dist/commands/mcp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp.d.ts","sourceRoot":"","sources":["../../src/commands/mcp.ts"],"names":[],"mappings":"AAAA;;GAEG;AAaH,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd;AA0BD,wBAAsB,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC,CASnD;AAED,wBAAsB,YAAY,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAoDzE"}

package/dist/commands/mcp.js

@@ -0,0 +1,79 @@
+/**
+ * MCP server commands for stdio and HTTP modes
+ */
+import { createMcpExpressApp } from '@modelcontextprotocol/sdk/server/express.js';
+import { StreamableHTTPServerTransport } from '@modelcontextprotocol/sdk/server/streamableHttp.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import chalk from 'chalk';
+import { randomUUID } from 'crypto';
+import { createMcpServer } from '../mcp/server.js';
+import { logger, LogLevel } from '../lib/utils/logger.js';
+async function attachShutdownHandlers(chatTool, tunnelTool, server, onShutdown) {
+    process.on('SIGINT', async () => {
+        logger.info('Shutting down...');
+        try {
+            await chatTool.notifyDisconnect();
+        }
+        catch (error) {
+            logger.error('Error sending disconnect notification', error);
+        }
+        await tunnelTool.closeAll();
+        if (onShutdown) {
+            await onShutdown();
+        }
+        await server.close();
+        process.exit(0);
+    });
+}
+export async function startMcpStdio() {
+    if (process.env.DEBUG) {
+        logger.setLevel(LogLevel.DEBUG);
+    }
+    const { server, chatTool, tunnelTool } = await createMcpServer();
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    logger.info('CodeVF MCP Server started');
+    await attachShutdownHandlers(chatTool, tunnelTool, server);
+}
+export async function startMcpHttp(options) {
+    if (process.env.DEBUG) {
+        logger.setLevel(LogLevel.DEBUG);
+    }
+    const { host, port } = options;
+    const { server, chatTool, tunnelTool } = await createMcpServer();
+    const app = createMcpExpressApp({ host });
+    const transport = new StreamableHTTPServerTransport({
+        sessionIdGenerator: () => randomUUID(),
+    });
+    await server.connect(transport);
+    app.get('/sse', (req, res) => {
+        transport.handleRequest(req, res).catch((error) => {
+            logger.error('SSE request error', error);
+        });
+    });
+    app.post('/messages', (req, res) => {
+        transport.handleRequest(req, res, req.body).catch((error) => {
+            logger.error('Message request error', error);
+        });
+    });
+    app.all('/mcp', (req, res) => {
+        const parsedBody = req.method === 'POST' ? req.body : undefined;
+        transport.handleRequest(req, res, parsedBody).catch((error) => {
+            logger.error('MCP request error', error);
+        });
+    });
+    console.log(chalk.dim(`# Initializing CodeVF MCP Server in HTTP mode on port ${port}...`));
+    const listener = app.listen(port, host, () => {
+        const address = listener.address();
+        const resolvedPort = address?.port ?? port;
+        const hostLabel = host === '0.0.0.0' ? 'localhost' : host;
+        const baseUrl = `http://${hostLabel}:${resolvedPort}`;
+        console.log(chalk.dim(`# HTTP server listening on port ${resolvedPort}`));
+        console.log(chalk.dim(`# SSE endpoint available at ${baseUrl}/sse`));
+        console.log(chalk.dim(`# Message endpoint available at ${baseUrl}/messages`));
+    });
+    await attachShutdownHandlers(chatTool, tunnelTool, server, () => {
+        listener.close();
+    });
+}
+//# sourceMappingURL=mcp.js.map

package/dist/commands/mcp.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp.js","sourceRoot":"","sources":["../../src/commands/mcp.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,mBAAmB,EAAE,MAAM,6CAA6C,CAAC;AAClF,OAAO,EAAE,6BAA6B,EAAE,MAAM,oDAAoD,CAAC;AACnG,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AAIpC,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAO1D,KAAK,UAAU,sBAAsB,CACnC,QAAmD,EACnD,UAA6C,EAC7C,MAAsC,EACtC,UAAuC;IAEvC,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,KAAK,IAAI,EAAE;QAC9B,MAAM,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC;QAEhC,IAAI,CAAC;YACH,MAAM,QAAQ,CAAC,gBAAgB,EAAE,CAAC;QACpC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,CAAC,KAAK,CAAC,uCAAuC,EAAE,KAAK,CAAC,CAAC;QAC/D,CAAC;QAED,MAAM,UAAU,CAAC,QAAQ,EAAE,CAAC;QAC5B,IAAI,UAAU,EAAE,CAAC;YACf,MAAM,UAAU,EAAE,CAAC;QACrB,CAAC;QACD,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC;QACrB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC,CAAC,CAAC;AACL,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,aAAa;IACjC,IAAI,OAAO,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC;QACtB,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;IAClC,CAAC;IACD,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,UAAU,EAAE,GAAG,MAAM,eAAe,EAAE,CAAC;IACjE,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAChC,MAAM,CAAC,IAAI,CAAC,2BAA2B,CAAC,CAAC;IACzC,MAAM,sBAAsB,CAAC,QAAQ,EAAE,UAAU,EAAE,MAAM,CAAC,CAAC;AAC7D,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,OAAuB;IACxD,IAAI,OAAO,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC;QACtB,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;IAClC,CAAC;IACD,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,GAAG,OAAO,CAAC;IAC/B,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,UAAU,EAAE,GAAG,MAAM,eAAe,EAAE,CAAC;IAEjE,MAAM,GAAG,GAAG,mBAAmB,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC;IAC1C,MAAM,SAAS,GAAG,IAAI,6BAA6B,CAAC;QAClD,kBAAkB,EAAE,GAAG,EAAE,CAAC,UAAU,EAAE;KACvC,CAAC,CAAC;IAEH,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAEhC,GAAG,CAAC,GAAG,CAAC,MAAM,EAAE,CAAC,GAAoB,EAAE,GAAmB,EAAE,EAAE;QAC5D,SAAS,CAAC,aAAa,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;YAChD,MAAM,CAAC,KAAK,CAAC,mBAAmB,EAAE,KAAK,CAAC,CAAC;QAC3C,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,GAAG,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,GAAyC,EAAE,GAAmB,EAAE,EAAE;QACvF,SAAS,CAAC,aAAa,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;YAC1D,MAAM,CAAC,KAAK,CAAC,uBAAuB,EAAE,KAAK,CAAC,CAAC;QAC/C,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,GAAG,CAAC,GAAG,CAAC,MAAM,EAAE,CAAC,GAAyC,EAAE,GAAmB,EAAE,EAAE;QACjF,MAAM,UAAU,GAAG,GAAG,CAAC,MAAM,KAAK,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC;QAChE,SAAS,CAAC,aAAa,CAAC,GAAG,EAAE,GAAG,EAAE,UAAU,CAAC,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;YAC5D,MAAM,CAAC,KAAK,CAAC,mBAAmB,EAAE,KAAK,CAAC,CAAC;QAC3C,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,OAAO,CAAC,GAAG,CACT,KAAK,CAAC,GAAG,CACP,yDAAyD,IAAI,KAAK,CACnE,CACF,CAAC;IAEF,MAAM,QAAQ,GAAG,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,IAAI,EAAE,GAAG,EAAE;QAC3C,MAAM,OAAO,GAAG,QAAQ,CAAC,OAAO,EAAwB,CAAC;QACzD,MAAM,YAAY,GAAG,OAAO,EAAE,IAAI,IAAI,IAAI,CAAC;QAC3C,MAAM,SAAS,GAAG,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,IAAI,CAAC;QAC1D,MAAM,OAAO,GAAG,UAAU,SAAS,IAAI,YAAY,EAAE,CAAC;QACtD,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,mCAAmC,YAAY,EAAE,CAAC,CAAC,CAAC;QAC1E,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,+BAA+B,OAAO,MAAM,CAAC,CAAC,CAAC;QACrE,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,mCAAmC,OAAO,WAAW,CAAC,CAAC,CAAC;IAChF,CAAC,CAAC,CAAC;IAEH,MAAM,sBAAsB,CAAC,QAAQ,EAAE,UAAU,EAAE,MAAM,EAAE,GAAG,EAAE;QAC9D,QAAQ,CAAC,KAAK,EAAE,CAAC;IACnB,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/commands/setup.d.ts

@@ -2,7 +2,7 @@
  * Setup command for CodeVF MCP Server configuration
  */
 /**
- * Setup command - configures MCP server for Claude Code
+ * Setup command - configures MCP server for Claude Code, Codex, and Gemini
  */
 export declare function setupCommand(): Promise<void>;
 //# sourceMappingURL=setup.d.ts.map

package/dist/commands/setup.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"setup.d.ts","sourceRoot":"","sources":["../../src/commands/setup.ts"],"names":[],"mappings":"AAAA;;GAEG;AAsJH;;GAEG;AACH,wBAAsB,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC,CA6NlD"}
+{"version":3,"file":"setup.d.ts","sourceRoot":"","sources":["../../src/commands/setup.ts"],"names":[],"mappings":"AAAA;;GAEG;AA0UH;;GAEG;AACH,wBAAsB,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC,CA6OlD"}

package/dist/commands/setup.js

@@ -25,6 +25,48 @@ function getClaudeCodeConfigPath() {
     }
     return null;
 }
+/**
+ * Get Codex MCP config path
+ */
+function getCodexConfigPath() {
+    return path.join(os.homedir(), '.codex', 'config.toml');
+}
+/**
+ * Resolve Gemini CLI config path based on platform and existing files.
+ * Supports common locations used by gemini-cli and similar tools.
+ */
+function getGeminiConfigPath() {
+    const homeDir = os.homedir();
+    const platform = os.platform();
+    const candidates = [];
+    if (platform === 'win32') {
+        const appData = process.env.APPDATA || path.join(homeDir, 'AppData', 'Roaming');
+        candidates.push(path.join(appData, 'gemini-cli', 'config.json'));
+        candidates.push(path.join(homeDir, '.gemini', 'config.json'));
+    }
+    else {
+        candidates.push(path.join(homeDir, '.config', 'gemini-cli', 'config.json'));
+        candidates.push(path.join(homeDir, '.config', 'gemini', 'config.json'));
+        candidates.push(path.join(homeDir, '.gemini', 'config.json'));
+    }
+    return candidates.find((candidate) => fs.existsSync(candidate)) || candidates[0];
+}
+/**
+ * Resolve installed MCP server path
+ */
+function getMcpServerPath() {
+    const codevfPath = process.argv[1]; // Path to codevf binary
+    let resolvedPath = codevfPath;
+    try {
+        // Follow npm/yarn/pnpm bin symlinks to the actual package entrypoint.
+        resolvedPath = fs.realpathSync(codevfPath);
+    }
+    catch {
+        // Fall back to argv path if it cannot be resolved (e.g. permissions or missing file).
+    }
+    const packageDir = path.dirname(path.dirname(resolvedPath)); // Go up from dist/index.js
+    return path.join(packageDir, 'dist', 'mcp', 'index.js');
+}
 /**
  * Create /cvf slash command for Claude Code
  */
@@ -60,6 +102,122 @@ function createCvfSlashCommand() {
         return false;
     }
 }
+/**
+ * Auto-configure Codex with MCP server
+ */
+async function autoConfigureCodex() {
+    console.log(chalk.bold('\n📋 Codex Configuration\n'));
+    const configPath = getCodexConfigPath();
+    const { shouldConfigure } = await prompts({
+        type: 'confirm',
+        name: 'shouldConfigure',
+        message: 'Configure Codex to use CodeVF MCP server?',
+        initial: true,
+    });
+    if (!shouldConfigure) {
+        console.log(chalk.dim('\n💡 To configure manually, add to ~/.codex/config.toml:'));
+        console.log(chalk.dim('   [mcp_servers.codevf]'));
+        console.log(chalk.dim('   command = "node"'));
+        console.log(chalk.dim('   args = ["<path>/dist/mcp/index.js"]'));
+        return false;
+    }
+    try {
+        const configDir = path.dirname(configPath);
+        if (!fs.existsSync(configDir)) {
+            fs.mkdirSync(configDir, { recursive: true, mode: 0o755 });
+        }
+        let configContent = '';
+        if (fs.existsSync(configPath)) {
+            configContent = fs.readFileSync(configPath, 'utf8');
+        }
+        const hasCodevf = /^\s*\[mcp_servers\.codevf\]\s*$/m.test(configContent);
+        if (hasCodevf) {
+            console.log(chalk.green('✅ CodeVF MCP server already configured for Codex!'));
+            return true;
+        }
+        const mcpServerPath = getMcpServerPath();
+        const block = [
+            '[mcp_servers.codevf]',
+            'command = "node"',
+            `args = ["${mcpServerPath}"]`,
+            '',
+        ].join('\n');
+        const nextContent = configContent.trim().length === 0
+            ? `${block}\n`
+            : `${configContent.trimEnd()}\n\n${block}\n`;
+        fs.writeFileSync(configPath, nextContent, { mode: 0o600 });
+        console.log(chalk.green('✅ Codex configured successfully!'));
+        return true;
+    }
+    catch (error) {
+        console.error(chalk.red('\n❌ Codex auto-config failed:'), error.message);
+        return false;
+    }
+}
+/**
+ * Auto-configure Gemini CLI with MCP server
+ */
+async function autoConfigureGemini() {
+    console.log(chalk.bold('\n📋 Gemini Configuration\n'));
+    const configPath = getGeminiConfigPath();
+    const { shouldConfigure } = await prompts({
+        type: 'confirm',
+        name: 'shouldConfigure',
+        message: 'Configure Gemini to use CodeVF MCP server?',
+        initial: true,
+    });
+    if (!shouldConfigure) {
+        console.log(chalk.dim(`\n💡 To configure manually, add to ${configPath}:`));
+        console.log(chalk.dim('   {'));
+        console.log(chalk.dim('     "mcpServers": {'));
+        console.log(chalk.dim('       "codevf": {'));
+        console.log(chalk.dim('         "command": "node",'));
+        console.log(chalk.dim('         "args": ["<path>/dist/mcp/index.js"]'));
+        console.log(chalk.dim('       }'));
+        console.log(chalk.dim('     }'));
+        console.log(chalk.dim('   }'));
+        return false;
+    }
+    try {
+        // Backup existing config
+        if (fs.existsSync(configPath)) {
+            const backupPath = `${configPath}.backup`;
+            console.log(chalk.dim('\n📋 Backing up existing config...'));
+            fs.copyFileSync(configPath, backupPath);
+            console.log(chalk.dim(`   Backup: ${backupPath}`));
+        }
+        // Read or create config
+        let config = {};
+        if (fs.existsSync(configPath)) {
+            const content = fs.readFileSync(configPath, 'utf8');
+            config = JSON.parse(content);
+        }
+        const mcpServerPath = getMcpServerPath();
+        const mcpKey = config.mcpServers ? 'mcpServers' : config.mcp_servers ? 'mcp_servers' : 'mcpServers';
+        if (!config[mcpKey]) {
+            config[mcpKey] = {};
+        }
+        if (config[mcpKey].codevf) {
+            console.log(chalk.green('✅ CodeVF MCP server already configured for Gemini!'));
+            return true;
+        }
+        config[mcpKey].codevf = {
+            command: 'node',
+            args: [mcpServerPath],
+        };
+        const configDir = path.dirname(configPath);
+        if (!fs.existsSync(configDir)) {
+            fs.mkdirSync(configDir, { recursive: true, mode: 0o755 });
+        }
+        fs.writeFileSync(configPath, JSON.stringify(config, null, 2), { mode: 0o600 });
+        console.log(chalk.green('✅ Gemini configured successfully!'));
+        return true;
+    }
+    catch (error) {
+        console.error(chalk.red('\n❌ Gemini auto-config failed:'), error.message);
+        return false;
+    }
+}
 /**
  * Auto-configure Claude Code with MCP server
  */
@@ -104,10 +262,7 @@ async function autoConfigureClaudeCode() {
             const content = fs.readFileSync(configPath, 'utf8');
             config = JSON.parse(content);
         }
-        // Get the installed codevf path
-        const codevfPath = process.argv[1]; // Path to codevf binary
-        const packageDir = path.dirname(path.dirname(codevfPath)); // Go up from dist/index.js
-        const mcpServerPath = path.join(packageDir, 'dist', 'mcp', 'index.js');
+        const mcpServerPath = getMcpServerPath();
         // Add or update codevf server
         if (!config.mcpServers) {
             config.mcpServers = {};
@@ -133,7 +288,7 @@ async function autoConfigureClaudeCode() {
     }
 }
 /**
- * Setup command - configures MCP server for Claude Code
+ * Setup command - configures MCP server for Claude Code, Codex, and Gemini
  */
 export async function setupCommand() {
     console.log(chalk.bold.blue('\n╔═══════════════════════════════════════╗'));
@@ -141,7 +296,7 @@ export async function setupCommand() {
     console.log(chalk.bold.blue('╚═══════════════════════════════════════╝\n'));
     const mcpConfigManager = new ConfigManager('mcp-config.json');
     // Check if already configured and reuse base URL if present
-    let baseUrl = process.env.CODEVF_API_URL || 'https://app.codevf.com';
+    let baseUrl = process.env.CODEVF_API_URL || 'https://codevf.com';
     if (mcpConfigManager.exists()) {
         const existingConfig = mcpConfigManager.load();
         console.log(chalk.yellow('⚠️  MCP configuration already exists'));
@@ -154,8 +309,10 @@ export async function setupCommand() {
             initial: false,
         });
         if (!reconfigure) {
-            // Just update Claude Code config
+            // Update client configs without re-authenticating
             await autoConfigureClaudeCode();
+            await autoConfigureCodex();
+            await autoConfigureGemini();
             console.log(chalk.green('\n🎉 Setup complete!\n'));
             return;
         }
@@ -308,19 +465,30 @@ export async function setupCommand() {
         });
         console.log(chalk.green('\n✅ Authentication complete!'));
         console.log(chalk.dim('Configuration saved to:'), mcpConfigManager.getPath());
-        // Configure Claude Code
-        const configured = await autoConfigureClaudeCode();
+        const configuredClaude = await autoConfigureClaudeCode();
+        const configuredCodex = await autoConfigureCodex();
+        const configuredGemini = await autoConfigureGemini();
         console.log(chalk.bold.green('\n🎉 Setup complete!\n'));
-        if (configured) {
+        if (configuredClaude || configuredCodex || configuredGemini) {
             console.log(chalk.bold('Next steps:'));
-            console.log(chalk.dim('1. Restart Claude Code to load the MCP server'));
-            console.log(chalk.dim('2. Use the /cvf slash command in Claude Code:'));
-            console.log(chalk.dim('   Example: ') + chalk.white('/cvf Does this fix work?'));
-            console.log(chalk.dim('   Example: ') + chalk.white('/cvf Create tunnel to port 3000'));
-            console.log(chalk.dim('3. Or ask Claude to use MCP tools directly:'));
-            console.log(chalk.dim('   - codevf-instant: Quick validation (1-10 credits)'));
-            console.log(chalk.dim('   - codevf-chat: Extended debugging (2 credits/min)'));
-            console.log(chalk.dim('   - codevf-tunnel: Expose local dev server (free)\n'));
+            if (configuredClaude) {
+                console.log(chalk.dim('1. Restart Claude Code to load the MCP server'));
+                console.log(chalk.dim('2. Use the /cvf slash command in Claude Code:'));
+                console.log(chalk.dim('   Example: ') + chalk.white('/cvf Does this fix work?'));
+                console.log(chalk.dim('   Example: ') + chalk.white('/cvf Create tunnel to port 3000'));
+                console.log(chalk.dim('3. Or ask Claude to use MCP tools directly:'));
+                console.log(chalk.dim('   - codevf-instant: Quick validation (1-10 credits)'));
+                console.log(chalk.dim('   - codevf-chat: Extended debugging (2 credits/min)'));
+                console.log(chalk.dim('   - codevf-tunnel: Expose local dev server (free)\n'));
+            }
+            if (configuredCodex) {
+                console.log(chalk.dim('1. Restart Codex to load the MCP server'));
+                console.log(chalk.dim('2. Use /mcp in Codex to confirm CodeVF is connected\n'));
+            }
+            if (configuredGemini) {
+                console.log(chalk.dim('1. Restart Gemini to load the MCP server'));
+                console.log(chalk.dim('2. Confirm CodeVF MCP tools are available\n'));
+            }
         }
     }
     catch (error) {