centaurus-cli 2.7.1 → 2.7.3

package/dist/cli-adapter.js

@@ -7,8 +7,13 @@ const __filename = fileURLToPath(import.meta.url);
 const __dirname = dirname(__filename);
 import { ConfigManager } from './config/manager.js';
 import { ToolRegistry } from './tools/registry.js';
-import { readFileTool, writeFileTool, editFileTool, listDirectoryTool } from './tools/file-ops.js';
-import { executeCommandTool, grepSearchTool } from './tools/command.js';
+import { viewFileTool, writeToFileTool, editFileTool, listDirTool } from './tools/file-ops.js';
+import { runCommandTool } from './tools/command.js';
+import { grepSearchTool } from './tools/grep-search.js';
+import { findFilesTool } from './tools/find-files.js';
+import { getDiffTool } from './tools/get-diff.js';
+import { inspectSymbolTool } from './tools/inspect-symbol.js';
+import { exitPlanModeTool, getPlanStatusTool, updatePlanStepTool } from './tools/plan-mode.js';
 import { webSearchTool, fetchUrlTool } from './tools/web-search.js';
 import { taskCompleteTool } from './tools/task-complete.js';
 import { apiClient } from './services/api-client.js';
@@ -23,6 +28,9 @@ import { WSLHandler } from './context/handlers/wsl-handler.js';
 import { DockerHandler } from './context/handlers/docker-handler.js';
 import { AIContextInjector } from './services/ai-context-injector.js';
 import { environmentContextInjector } from './services/environment-context-injector.js';
+import { MCPConfigManager } from './config/mcp-config-manager.js';
+import { MCPServerManager } from './mcp/mcp-server-manager.js';
+import { MCPCommandHandler } from './mcp/mcp-command-handler.js';
 export class CentaurusCLI {
     configManager;
     toolRegistry;
@@ -32,6 +40,7 @@ export class CentaurusCLI {
     commandMode = false;
     previousMode = 'execution';
     onResponseCallback;
+    onDirectMessageCallback; // For slash commands - adds directly to history
     onResponseStreamCallback;
     onThoughtStreamCallback;
     onThoughtCompleteCallback;
@@ -52,6 +61,7 @@ export class CentaurusCLI {
     aiContextInjector;
     onSubshellContextChange;
     currentAbortController;
+    mcpCommandHandler;
     constructor() {
         this.configManager = new ConfigManager();
         this.toolRegistry = new ToolRegistry();
@@ -70,10 +80,15 @@ export class CentaurusCLI {
                 this.onSubshellContextChange(context);
             }
         });
+        // Initialize MCP
+        this.initializeMCP();
     }
     setOnResponseCallback(callback) {
         this.onResponseCallback = callback;
     }
+    setOnDirectMessageCallback(callback) {
+        this.onDirectMessageCallback = callback;
+    }
     setOnResponseStreamCallback(callback) {
         this.onResponseStreamCallback = callback;
     }
@@ -120,6 +135,18 @@ export class CentaurusCLI {
             this.sshHandler.setPasswordRequestCallback(callback);
         }
     }
+    async initializeMCP() {
+        try {
+            const mcpConfigManager = new MCPConfigManager();
+            const mcpServerManager = new MCPServerManager();
+            this.mcpCommandHandler = new MCPCommandHandler(mcpConfigManager, mcpServerManager, this.toolRegistry);
+            // Initialize MCP servers and tools
+            await this.mcpCommandHandler.initializeMCP();
+        }
+        catch (error) {
+            console.error('Failed to initialize MCP:', error);
+        }
+    }
     writeToShellStdin(input) {
         if (this.currentInteractiveProcess) {
             try {
@@ -130,6 +157,27 @@ export class CentaurusCLI {
             }
         }
     }
+    sendSignalToShell(signal) {
+        if (this.currentInteractiveProcess) {
+            try {
+                this.currentInteractiveProcess.signal(signal);
+            }
+            catch (error) {
+                // Silently ignore - process might have already exited
+            }
+        }
+    }
+    killCurrentProcess() {
+        if (this.currentInteractiveProcess && this.currentInteractiveProcess.process.pid) {
+            try {
+                const { killProcessTree } = require('./utils/shell.js');
+                killProcessTree(this.currentInteractiveProcess.process.pid, 'SIGKILL');
+            }
+            catch (error) {
+                // Ignore
+            }
+        }
+    }
     getPlanMode() {
         return this.planMode;
     }
@@ -173,14 +221,50 @@ export class CentaurusCLI {
         }
     }
     sshHandler;
+    /**
+     * Notify UI about tool execution status
+     */
+    notifyToolStatus(toolName, status, args, result, error) {
+        if (this.onToolExecutionUpdate) {
+            // Add cwd to arguments for execute_command tool
+            const toolArgs = toolName === 'execute_command' && args
+                ? { ...args, cwd: this.cwd }
+                : args;
+            this.onToolExecutionUpdate({
+                toolName,
+                status,
+                result,
+                error,
+                arguments: toolArgs
+            });
+        }
+    }
+    /**
+     * Truncate large results for AI consumption
+     */
+    truncateResult(result, maxLength = 500000) {
+        const resultStr = typeof result === 'string' ? result : JSON.stringify(result);
+        if (resultStr.length > maxLength) {
+            const truncated = resultStr.substring(0, maxLength);
+            const linesRemoved = (resultStr.match(/\n/g) || []).length - (truncated.match(/\n/g) || []).length;
+            return truncated + `\n\n[... truncated ${resultStr.length - maxLength} characters, ~${linesRemoved} lines removed for brevity ...]`;
+        }
+        return result;
+    }
     async initialize() {
         // Register tools
-        this.toolRegistry.register(readFileTool);
-        this.toolRegistry.register(writeFileTool);
+        this.toolRegistry.register(viewFileTool);
+        this.toolRegistry.register(writeToFileTool);
         this.toolRegistry.register(editFileTool);
-        this.toolRegistry.register(listDirectoryTool);
-        this.toolRegistry.register(executeCommandTool);
+        this.toolRegistry.register(listDirTool);
+        this.toolRegistry.register(runCommandTool);
         this.toolRegistry.register(grepSearchTool);
+        this.toolRegistry.register(findFilesTool);
+        this.toolRegistry.register(getDiffTool);
+        this.toolRegistry.register(inspectSymbolTool);
+        this.toolRegistry.register(exitPlanModeTool);
+        this.toolRegistry.register(getPlanStatusTool);
+        this.toolRegistry.register(updatePlanStepTool);
         this.toolRegistry.register(webSearchTool);
         this.toolRegistry.register(fetchUrlTool);
         this.toolRegistry.register(taskCompleteTool);
@@ -370,7 +454,8 @@ Press Enter to continue...
             const currentContext = this.contextManager.getCurrentContext();
             messages = this.aiContextInjector.injectSubshellContext(messages, currentContext);
             // Build environment context to send to backend
-            const environmentContext = this.getEnvironmentContext();
+            // Initial context - will be updated in loop
+            let environmentContext = this.getEnvironmentContext();
             const mode = this.getMode();
             let finalAssistantMessage = '';
             const MAX_TURNS = 500; // Allow up to 500 turns for complex tasks
@@ -378,6 +463,7 @@ Press Enter to continue...
             const MAX_NARRATION_ATTEMPTS = 3; // Maximum times we'll prompt AI to stop narrating
             let turnCount = 0;
             let narrationAttempts = 0; // Track how many times AI narrated without executing
+            let completionAttempts = 0; // Track how many times AI provided text summary without task_complete
             let thoughtStartTime = null; // Track when thinking started
             let thoughtContent = ''; // Accumulate thought content
             // Create AbortController for this request
@@ -385,6 +471,14 @@ Press Enter to continue...
             // Multi-turn tool execution loop
             while (turnCount < MAX_TURNS) {
                 turnCount++;
+                // Refresh environment context to capture any CWD changes from previous turns
+                environmentContext = this.getEnvironmentContext();
+                // Refresh system prompt with new CWD
+                const refreshedSystemPrompt = environmentContextInjector.getEnhancedSystemPrompt(systemPrompt, this.cwd);
+                // Update the system message in the messages array
+                if (messages.length > 0 && messages[0].role === 'system') {
+                    messages[0].content = refreshedSystemPrompt;
+                }
                 let assistantMessage = '';
                 let toolCalls = [];
                 // Stream AI response from backend
@@ -469,8 +563,8 @@ Press Enter to continue...
                         }
                         break;
                     }
-                }
-                // If there are tool calls, execute them and continue loop
+                } // End of stream loop
+                // If there are tool calls, execute them
                 if (toolCalls.length > 0) {
                     // CRITICAL: AI should ONLY communicate via reason_text and task_complete summary
                     // Any text output alongside tool calls should be suppressed
@@ -483,16 +577,6 @@ Press Enter to continue...
                         // Silently limit tool calls
                         toolCalls = toolCalls.slice(0, MAX_TOOL_CALLS_PER_TURN);
                     }
-                    // Helper function to truncate large results
-                    const truncateResult = (result, maxLength = 500000) => {
-                        const resultStr = typeof result === 'string' ? result : JSON.stringify(result);
-                        if (resultStr.length > maxLength) {
-                            const truncated = resultStr.substring(0, maxLength);
-                            const linesRemoved = (resultStr.match(/\n/g) || []).length - (truncated.match(/\n/g) || []).length;
-                            return truncated + `\n\n[... truncated ${resultStr.length - maxLength} characters, ~${linesRemoved} lines removed for brevity ...]`;
-                        }
-                        return result;
-                    };
                     const toolResults = [];
                     let userCancelledOperation = false;
                     let taskCompleted = false;
@@ -561,7 +645,7 @@ Press Enter to continue...
                                     }
                                 }
                                 // Truncate result before sending to AI (to avoid exceeding message size limits)
-                                const truncatedResult = truncateResult(parsedResult);
+                                const truncatedResult = this.truncateResult(parsedResult);
                                 toolResults.push({
                                     tool_call_id: toolCall.id,
                                     name: toolCall.name,
@@ -691,107 +775,115 @@ Press Enter to continue...
                         },
                         ...this.conversationHistory
                     ];
-                    // Re-inject subshell context for the next turn
+                    // Re-inject subshell context
                     messages = this.aiContextInjector.injectSubshellContext(messages, currentContext);
-                    // Add delay between turns to prevent rate limiting
-                    await new Promise(resolve => setTimeout(resolve, 500));
-                    // Continue to next turn to let AI process results
-                    continue;
+                    continue; // Loop back to AI service
                 }
-                // No tool calls - AI must make tool calls or finish
-                if (assistantMessage) {
-                    // CRITICAL: AI should NOT output text without tool calls
-                    // The ONLY valid text output is through task_complete summary
-                    // Suppress this text and prompt AI to use tools
-                    // Add assistant message to history (for AI context, but don't show to user)
-                    this.conversationHistory.push({
-                        role: 'assistant',
-                        content: assistantMessage,
-                    });
-                    // Check if this looks like it should have been a task_complete
-                    const looksLikeFinalAnswer = assistantMessage.length < 500 &&
-                        !assistantMessage.includes('?') &&
-                        (assistantMessage.includes('!') || assistantMessage.match(/\./g)?.length || 0 > 1);
-                    const isNarration = /\b(I will|I'll|Let me|Let's|I need to|I'm going to|I should|I can)\b/i.test(assistantMessage);
-                    if (isNarration) {
-                        narrationAttempts++;
-                        // If AI keeps narrating without executing, force completion immediately
-                        if (narrationAttempts >= MAX_NARRATION_ATTEMPTS) {
-                            // Force task completion with error message
-                            finalAssistantMessage = '⚠️ **Task Incomplete**: The AI repeatedly described actions without executing them.\n\n' +
-                                '**What happened**: The AI entered a narration loop, describing what it wanted to do instead of using tool calls.\n\n' +
-                                '**Suggestions**:\n' +
-                                '1. Try rephrasing your request more specifically\n' +
-                                '2. Break the task into smaller, concrete steps\n' +
-                                '3. Provide explicit file paths if known\n' +
-                                '4. Check if the model supports tool calling properly\n\n' +
-                                '**Last message**: ' + assistantMessage;
-                            break;
-                        }
-                        // First narration attempt - give a strong warning with specific guidance
-                        if (narrationAttempts === 1) {
-                            const completionPrompt = '🛑 **CRITICAL ERROR**: You output text without using tools.\n\n' +
-                                '**COMMUNICATION RULE VIOLATION**: You can ONLY communicate through:\n' +
-                                '1. `reason_text` parameter in tool calls\n' +
-                                '2. `summary` parameter in task_complete tool\n\n' +
-                                '**Your text output was HIDDEN from the user.**\n\n' +
-                                '**MANDATORY CORRECTION**:\n' +
-                                '- If you need to DO something: Call the tool with `reason_text`\n' +
-                                '- If you are DONE: Call `task_complete(summary="your message")`\n' +
-                                '- NEVER output plain text - it will be hidden\n\n' +
-                                '**Example for greeting**:\n' +
-                                '```\n' +
-                                '<thought>User said hello, I should greet back</thought>\n' +
-                                '(Call task_complete with summary="Hello! How can I help you today?")\n' +
-                                '```\n\n' +
-                                '**Your NEXT response MUST use tools.**';
-                            this.conversationHistory.push({
-                                role: 'user',
-                                content: completionPrompt,
-                            });
-                        }
-                        else {
-                            // Second narration attempt - final warning before forced completion
-                            const completionPrompt = '🚨 **FINAL WARNING** (Attempt ' + narrationAttempts + '/' + MAX_NARRATION_ATTEMPTS + '): You are STILL narrating instead of executing.\n\n' +
-                                '**This is your LAST chance**:\n' +
-                                '1. Execute a tool call NOW, or\n' +
-                                '2. Call task_complete() to end\n\n' +
-                                'If you output narration text again, the task will be forcibly terminated.';
-                            this.conversationHistory.push({
-                                role: 'user',
-                                content: completionPrompt,
-                            });
-                        }
+                else {
+                    // No tool calls - check for silent stop or text-only response
+                    // Case 1: Silent Stop (No tool calls AND no text)
+                    if (!assistantMessage || !assistantMessage.trim()) {
+                        // No tool calls and no message - AI stopped silently
+                        // This usually means the AI thinks it's done but didn't call task_complete
+                        // Prompt it to either continue or complete
+                        const silentStopPrompt = '⚠️ **SILENT STOP DETECTED**: You ended your turn without any output or tool calls.\n\n' +
+                            '**This is not allowed.** You must either:\n' +
+                            '1. Execute a tool call if more work is needed, OR\n' +
+                            '2. Call task_complete() with a summary of what you accomplished\n\n' +
+                            '**If you have completed the task**, call task_complete() NOW with a comprehensive summary.\n' +
+                            '**If more work is needed**, execute the next tool call immediately.';
+                        this.conversationHistory.push({
+                            role: 'user',
+                            content: silentStopPrompt,
+                        });
                     }
+                    // Case 2: Text-only response (Narration or Summary)
                     else {
-                        // AI output a response without narration - it should finish
-                        // Reset narration counter since this is a valid response
-                        narrationAttempts = 0;
-                        // Check if the message looks like a final answer/summary
-                        const isFinalAnswer = assistantMessage.length > 50 &&
-                            (assistantMessage.includes('found') ||
-                                assistantMessage.includes('identified') ||
-                                assistantMessage.includes('completed') ||
-                                assistantMessage.includes('summary') ||
-                                assistantMessage.includes('result'));
-                        if (isFinalAnswer) {
-                            // This looks like a final answer - prompt to call task_complete
-                            const completionPrompt = '✅ Your response looks complete. Call task_complete() now to finalize the conversation.\n\n' +
-                                'If there are more steps needed, execute the next tool immediately.';
-                            this.conversationHistory.push({
-                                role: 'user',
-                                content: completionPrompt,
-                            });
+                        const isNarration = /\b(I will|I'll|Let me|Let's|I need to|I'm going to|I should|I can)\b/i.test(assistantMessage);
+                        if (isNarration) {
+                            narrationAttempts++;
+                            // If AI keeps narrating without executing, force completion immediately
+                            if (narrationAttempts >= MAX_NARRATION_ATTEMPTS) {
+                                // Force task completion with error message
+                                finalAssistantMessage = '⚠️ **Task Incomplete**: The AI repeatedly described actions without executing them.\n\n' +
+                                    '**What happened**: The AI entered a narration loop, describing what it wanted to do instead of using tool calls.\n\n' +
+                                    '**Suggestions**:\n' +
+                                    '1. Try rephrasing your request more specifically\n' +
+                                    '2. Break the task into smaller, concrete steps\n' +
+                                    '3. Provide explicit file paths if known\n' +
+                                    '4. Check if the model supports tool calling properly\n\n' +
+                                    '**Last message**: ' + assistantMessage;
+                                break;
+                            }
+                            // First narration attempt - give a strong warning with specific guidance
+                            if (narrationAttempts === 1) {
+                                const completionPrompt = '🛑 **CRITICAL ERROR**: You output text without using tools.\n\n' +
+                                    '**COMMUNICATION RULE VIOLATION**: You can ONLY communicate through:\n' +
+                                    '1. `reason_text` parameter in tool calls\n' +
+                                    '2. `summary` parameter in task_complete tool\n\n' +
+                                    '**Your text output was HIDDEN from the user.**\n\n' +
+                                    '**MANDATORY CORRECTION**:\n' +
+                                    '- If you need to DO something: Call the tool with `reason_text`\n' +
+                                    '- If you are DONE: Call `task_complete(summary="your message")`\n' +
+                                    '- NEVER output plain text - it will be hidden\n\n' +
+                                    '**Example for greeting**:\n' +
+                                    '```\n' +
+                                    '<thought>User said hello, I should greet back</thought>\n' +
+                                    '(Call task_complete with summary="Hello! How can I help you today?")\n' +
+                                    '```\n\n' +
+                                    '**Your NEXT response MUST use tools.**';
+                                this.conversationHistory.push({
+                                    role: 'user',
+                                    content: completionPrompt,
+                                });
+                            }
+                            else {
+                                // Second narration attempt - final warning before forced completion
+                                const completionPrompt = '🚨 **FINAL WARNING** (Attempt ' + narrationAttempts + '/' + MAX_NARRATION_ATTEMPTS + '): You are STILL narrating instead of executing.\n\n' +
+                                    '**This is your LAST chance**:\n' +
+                                    '1. Execute a tool call NOW, or\n' +
+                                    '2. Call task_complete() to end\n\n' +
+                                    'If you output narration text again, the task will be forcibly terminated.';
+                                this.conversationHistory.push({
+                                    role: 'user',
+                                    content: completionPrompt,
+                                });
+                            }
                         }
                         else {
-                            // Short message without clear intent - ask for clarification or completion
-                            const completionPrompt = 'Your response is unclear. Either:\n' +
-                                '1. Execute the next tool call if more work is needed, or\n' +
-                                '2. Call task_complete() if the task is done';
-                            this.conversationHistory.push({
-                                role: 'user',
-                                content: completionPrompt,
-                            });
+                            // AI output a response without narration - it should finish
+                            // Reset narration counter since this is a valid response
+                            narrationAttempts = 0;
+                            // Check if the message looks like a final answer/summary
+                            // If it has substantial length, assume it's a summary attempt
+                            const isFinalAnswer = assistantMessage.length > 20;
+                            if (isFinalAnswer) {
+                                completionAttempts++;
+                                // If AI keeps providing text summaries without calling task_complete, accept the text and finish
+                                // This prevents the infinite loop where the AI keeps summarizing in response to our prompt
+                                if (completionAttempts > 1) {
+                                    finalAssistantMessage = assistantMessage;
+                                    break;
+                                }
+                                // This looks like a final answer - prompt to call task_complete
+                                const completionPrompt = '✅ **Possible Completion Detected**: You provided a text response but did not call `task_complete`.\n\n' +
+                                    '**To finish the conversation, you MUST call the `task_complete` tool.**\n\n' +
+                                    'Please call `task_complete` now with your summary as the argument.';
+                                this.conversationHistory.push({
+                                    role: 'user',
+                                    content: completionPrompt,
+                                });
+                            }
+                            else {
+                                // Short message without clear intent - ask for clarification or completion
+                                const completionPrompt = 'Your response is unclear. Either:\n' +
+                                    '1. Execute the next tool call if more work is needed, or\n' +
+                                    '2. Call task_complete() if the task is done';
+                                this.conversationHistory.push({
+                                    role: 'user',
+                                    content: completionPrompt,
+                                });
+                            }
                         }
                     }
                     // Rebuild messages array
@@ -850,10 +942,10 @@ Press Enter to continue...
                 });
                 // Save assistant message to backend
                 await this.saveMessageToBackend('assistant', finalMessage);
-            }
+            } // End of while loop
             // Parse response for plan mode
             if (this.planMode) {
-                const planData = this.parsePlanResponse(finalMessage);
+                const planData = this.parsePlanResponse(finalAssistantMessage);
                 if (planData && this.onPlanApprovalRequest) {
                     // Ask user for approval
                     const approved = await this.onPlanApprovalRequest(planData);
@@ -870,8 +962,8 @@ Press Enter to continue...
                 }
             }
             // Send response back to UI (only if there's a message)
-            if (this.onResponseCallback && finalMessage) {
-                this.onResponseCallback(finalMessage);
+            if (this.onResponseCallback && finalAssistantMessage) {
+                this.onResponseCallback(finalAssistantMessage);
             }
         }
         catch (error) {
@@ -898,6 +990,7 @@ Press Enter to continue...
             case 'help':
                 responseMessage = `Available Commands:\n\n` +
                     `/help       - Show this help message\n` +
+                    `/init       - Analyze project and create/load centaurus.md context file\n` +
                     `/clear      - Clear conversation history\n` +
                     `/config     - View current configuration\n` +
                     `/model      - Select from available Google models\n` +
@@ -913,6 +1006,163 @@ Press Enter to continue...
                     `Ctrl+T      - Toggle auto-accept mode\n` +
                     `?           - Show keyboard shortcuts help`;
                 break;
+            case 'init':
+                try {
+                    // Define the context file names in priority order
+                    const contextFiles = ['centaurus.md', 'gemini.md', 'claude.md'];
+                    let foundFile = null;
+                    let foundFilePath = null;
+                    // Check for existing context files in priority order
+                    for (const fileName of contextFiles) {
+                        const filePath = path.join(this.cwd, fileName);
+                        if (fs.existsSync(filePath)) {
+                            foundFile = fileName;
+                            foundFilePath = filePath;
+                            break;
+                        }
+                    }
+                    if (foundFile) {
+                        // Context file exists - read and load it
+                        try {
+                            const content = fs.readFileSync(foundFilePath, 'utf-8');
+                            // Check if content is empty
+                            if (!content.trim()) {
+                                responseMessage = `⚠️  Found ${foundFile} but it's empty.\n\n` +
+                                    `Please either:\n` +
+                                    `1. Delete the file and run /init again to generate new documentation\n` +
+                                    `2. Add content to the file manually`;
+                                break;
+                            }
+                            // If the found file is not centaurus.md, create a copy
+                            if (foundFile !== 'centaurus.md') {
+                                const centaurusPath = path.join(this.cwd, 'centaurus.md');
+                                // Check if centaurus.md already exists
+                                if (fs.existsSync(centaurusPath)) {
+                                    responseMessage = `✅ Found both ${foundFile} and centaurus.md. Loaded project context from centaurus.md`;
+                                }
+                                else {
+                                    // Create a copy as centaurus.md
+                                    fs.copyFileSync(foundFilePath, centaurusPath);
+                                    responseMessage = `✅ Found ${foundFile} and created a copy as centaurus.md. Loaded project context.`;
+                                }
+                            }
+                            else {
+                                // Already centaurus.md
+                                responseMessage = `✅ Loaded project context from centaurus.md`;
+                            }
+                            // Add the context to conversation history so the AI actually has it
+                            this.conversationHistory.push({
+                                role: 'user',
+                                content: `Here is the project context from ${foundFile}:\n\n${content}`
+                            });
+                        }
+                        catch (readError) {
+                            responseMessage = `❌ Error reading ${foundFile}: ${readError.message}\n\n` +
+                                `Please check file permissions and try again.`;
+                        }
+                    }
+                    else {
+                        // No context file exists - trigger AI analysis
+                        responseMessage = `🔍 I will now analyze the contents of this directory and then create a centaurus.md`;
+                        // Send initial response
+                        if (this.onResponseCallback) {
+                            this.onResponseCallback(responseMessage);
+                        }
+                        // Create a specialized prompt for project analysis
+                        const initPrompt = `You are tasked with analyzing the current project directory and creating a comprehensive documentation file called "centaurus.md".
+
+**Your Task:**
+1. Use the list_directory tool to explore the project structure starting from the current directory
+2. Use read_file to examine key files such as:
+   - package.json, requirements.txt, or similar dependency files
+   - README files
+   - Configuration files (tsconfig.json, .eslintrc, etc.)
+   - Main entry points (index.js, main.py, App.tsx, etc.)
+3. Use grep_search to find important patterns and understand the codebase
+4. Create a comprehensive centaurus.md file using the write_file tool
+
+**The centaurus.md file should include:**
+
+# [Project Name]
+
+## Overview
+Brief description of what this project does and its purpose
+
+## Technology Stack
+- **Languages**: List programming languages used
+- **Frameworks**: Main frameworks (React, Express, Django, etc.)
+- **Key Dependencies**: Important libraries and tools
+- **Build Tools**: Webpack, Vite, Maven, etc.
+
+## Directory Structure
+\`\`\`
+/
+  /src          - Main source code
+  /tests        - Test files
+  /config       - Configuration files
+  ...
+\`\`\`
+
+Brief explanation of each major directory's purpose
+
+## Key Components
+Describe the main modules, classes, or components:
+- **Component Name**: What it does, where it's located
+- **Component Name**: What it does, where it's located
+
+## Architecture
+Explain how the components interact:
+- Data flow
+- Communication patterns (REST APIs, GraphQL, event-driven, etc.)
+- State management
+- Database architecture (if applicable)
+
+## Development Workflow
+- How to install dependencies
+- How to run the development server
+- How to run tests
+- How to build for production
+
+## Important Conventions
+- Code organization patterns
+- Naming conventions
+- File structure patterns
+- Any special patterns or best practices used
+
+## Entry Points
+- Main files where execution starts
+- API endpoints (if applicable)
+- CLI commands (if applicable)
+
+## Quick Reference
+Useful commands, key files to know about, common tasks
+
+**IMPORTANT INSTRUCTIONS:**
+- Be thorough but concise
+- Use clear, professional language
+- Include code examples where helpful
+- Create the file in the current working directory: ${this.cwd}
+- After creating the file, call task_complete with a summary
+
+**Current working directory**: ${this.cwd}
+
+Start by listing the directory structure to understand what you're working with.`;
+                        // Add to conversation history
+                        this.conversationHistory.push({
+                            role: 'user',
+                            content: initPrompt
+                        });
+                        // Trigger the AI to process this
+                        await this.handleMessage('');
+                        // Don't send another response - the AI will respond
+                        return;
+                    }
+                }
+                catch (error) {
+                    responseMessage = `❌ Error executing /init command: ${error.message}\n\n` +
+                        `Please try again or check file permissions.`;
+                }
+                break;
             case 'sign-in':
                 // Check if already authenticated
                 if (apiClient.isAuthenticated()) {
@@ -1134,15 +1384,23 @@ Press Enter to continue...
                     }
                 }
                 break;
+            case 'mcp':
+                if (this.mcpCommandHandler) {
+                    responseMessage = await this.mcpCommandHandler.handleCommand(args);
+                }
+                else {
+                    responseMessage = '❌ MCP is not initialized. Please restart the CLI.';
+                }
+                break;
             case 'exit':
                 process.exit(0);
                 break;
             default:
                 responseMessage = `Unknown command: /${cmd}\nType /help for available commands.`;
         }
-        // Send command response back to UI
-        if (responseMessage && this.onResponseCallback) {
-            this.onResponseCallback(responseMessage);
+        // Send command response directly to history (not streaming)
+        if (responseMessage && this.onDirectMessageCallback) {
+            this.onDirectMessageCallback(responseMessage);
         }
     }
     /**