@xagent/x-cli 1.1.76 → 1.1.78

package/dist/index.js

@@ -52,31 +52,37 @@ var init_settings_manager = __esm({
   "src/utils/settings-manager.ts"() {
     DEFAULT_USER_SETTINGS = {
       baseURL: "https://api.x.ai/v1",
-      defaultModel: "grok-code-fast-1",
+      defaultModel: "grok-4-fast-non-reasoning",
       models: [
-        "grok-code-fast-1",
+        "grok-4-fast-non-reasoning",
+        "grok-4-fast-reasoning",
+        "grok-4-0709",
         "grok-4-latest",
         "grok-3-latest",
         "grok-3-fast",
-        "grok-3-mini-fast"
+        "grok-3-mini-fast",
+        "grok-3",
+        "grok-2-vision-1212us-east-1",
+        "grok-2-vision-1212eu-west-1",
+        "grok-2-image-1212"
       ],
       verbosityLevel: "quiet",
       explainLevel: "brief",
       requireConfirmation: true
     };
     DEFAULT_PROJECT_SETTINGS = {
-      model: "grok-code-fast-1"
+      model: "grok-4-fast-non-reasoning"
     };
     SettingsManager = class _SettingsManager {
       constructor() {
-        const newUserDir = path7.join(os.homedir(), ".x");
+        const newUserDir = path7.join(os.homedir(), ".xcli");
         const oldUserDir = path7.join(os.homedir(), ".grok");
         if (fs.existsSync(newUserDir) || !fs.existsSync(oldUserDir)) {
-          this.userSettingsPath = path7.join(newUserDir, "user-settings.json");
+          this.userSettingsPath = path7.join(newUserDir, "config.json");
         } else {
           this.userSettingsPath = path7.join(oldUserDir, "user-settings.json");
         }
-        const newProjectDir = path7.join(process.cwd(), ".x");
+        const newProjectDir = path7.join(process.cwd(), ".xcli");
         const oldProjectDir = path7.join(process.cwd(), ".grok");
         if (fs.existsSync(newProjectDir) || !fs.existsSync(oldProjectDir)) {
           this.projectSettingsPath = path7.join(newProjectDir, "settings.json");
@@ -103,7 +109,7 @@ var init_settings_manager = __esm({
         }
       }
       /**
-       * Load user settings from ~/.x/user-settings.json
+       * Load user settings from ~/.xcli/config.json or ~/.grok/user-settings.json
        */
       loadUserSettings() {
         try {
@@ -123,7 +129,7 @@ var init_settings_manager = __esm({
         }
       }
       /**
-       * Save user settings to ~/.x/user-settings.json
+       * Save user settings to ~/.xcli/config.json or ~/.grok/user-settings.json
        */
       saveUserSettings(settings) {
         try {
@@ -232,11 +238,16 @@ var init_settings_manager = __esm({
       }
       /**
        * Get the current model with proper fallback logic:
-       * 1. Project-specific model setting
-       * 2. User's default model
-       * 3. System default
+       * 1. Environment variable XCLI_MODEL_DEFAULT
+       * 2. Project-specific model setting
+       * 3. User's default model
+       * 4. System default
        */
       getCurrentModel() {
+        const envModel = process.env.XCLI_MODEL_DEFAULT;
+        if (envModel) {
+          return envModel;
+        }
         const projectModel = this.getProjectSetting("model");
         if (projectModel) {
           return projectModel;
@@ -245,7 +256,22 @@ var init_settings_manager = __esm({
         if (userDefaultModel) {
           return userDefaultModel;
         }
-        return DEFAULT_PROJECT_SETTINGS.model || "grok-code-fast-1";
+        return DEFAULT_PROJECT_SETTINGS.model || "grok-4-fast-non-reasoning";
+      }
+      /**
+       * Get the appropriate model for a task based on its characteristics
+       * Uses reasoning model for deep tasks, retries, or large contexts
+       */
+      pickModel(options = {}) {
+        const { deep = false, retries = 0, ctxTokens = 0 } = options;
+        if (deep || retries > 0 || ctxTokens > 15e4) {
+          const reasoningModel = process.env.XCLI_MODEL_REASONING;
+          if (reasoningModel) {
+            return reasoningModel;
+          }
+          return "grok-4-fast-reasoning";
+        }
+        return this.getCurrentModel();
       }
       /**
        * Set the current model for the project
@@ -464,7 +490,7 @@ var init_context_loader = __esm({
 });
 var GrokClient = class {
   constructor(apiKey, model, baseURL) {
-    this.currentModel = "grok-code-fast-1";
+    this.currentModel = "grok-4-fast-non-reasoning";
     this.client = new OpenAI({
       apiKey,
       baseURL: baseURL || process.env.GROK_BASE_URL || "https://api.x.ai/v1",
@@ -496,6 +522,9 @@ var GrokClient = class {
         requestPayload.search_parameters = searchOptions.search_parameters;
       }
       const response = await this.client.chat.completions.create(requestPayload);
+      if (response.usage) {
+        this.logTokenUsage(response.usage);
+      }
       return response;
     } catch (error) {
       throw new Error(`Grok API error: ${error.message}`);
@@ -519,9 +548,16 @@ var GrokClient = class {
         requestPayload,
         { signal: abortSignal }
       );
+      let finalUsage = null;
       for await (const chunk of stream) {
+        if (chunk.usage) {
+          finalUsage = chunk.usage;
+        }
         yield chunk;
       }
+      if (finalUsage) {
+        this.logTokenUsage(finalUsage);
+      }
     } catch (error) {
       throw new Error(`Grok API error: ${error.message}`);
     }
@@ -536,6 +572,32 @@ var GrokClient = class {
     };
     return this.chat([searchMessage], [], void 0, searchOptions);
   }
+  /**
+   * Log token usage for monitoring and optimization
+   */
+  logTokenUsage(usage) {
+    try {
+      const tokenData = {
+        timestamp: (/* @__PURE__ */ new Date()).toISOString(),
+        model: this.currentModel,
+        prompt_tokens: usage.prompt_tokens || 0,
+        completion_tokens: usage.completion_tokens || 0,
+        total_tokens: usage.total_tokens || 0,
+        reasoning_tokens: usage.reasoning_tokens || 0
+      };
+      const logPath = process.env.XCLI_TOKEN_LOG || `${__require("os").homedir()}/.xcli/token-usage.jsonl`;
+      const fs10 = __require("fs");
+      const path32 = __require("path");
+      const dir = path32.dirname(logPath);
+      if (!fs10.existsSync(dir)) {
+        fs10.mkdirSync(dir, { recursive: true });
+      }
+      const logLine = JSON.stringify(tokenData) + "\n";
+      fs10.appendFileSync(logPath, logLine);
+    } catch (error) {
+      console.warn("Failed to log token usage:", error);
+    }
+  }
 };
 var StdioTransport = class {
   constructor(config2) {
@@ -858,21 +920,21 @@ var BASE_GROK_TOOLS = [
     type: "function",
     function: {
       name: "view_file",
-      description: "View contents of a file or list directory contents",
+      description: "View file contents or list directories",
       parameters: {
         type: "object",
         properties: {
           path: {
             type: "string",
-            description: "Path to file or directory to view"
+            description: "File or directory path"
           },
           start_line: {
             type: "number",
-            description: "Starting line number for partial file view (optional)"
+            description: "Optional start line for partial view"
           },
           end_line: {
             type: "number",
-            description: "Ending line number for partial file view (optional)"
+            description: "Optional end line for partial view"
           }
         },
         required: ["path"]
@@ -883,7 +945,7 @@ var BASE_GROK_TOOLS = [
     type: "function",
     function: {
       name: "create_file",
-      description: "Create a new file with specified content",
+      description: "Create new file with content",
       parameters: {
         type: "object",
         properties: {
@@ -904,7 +966,7 @@ var BASE_GROK_TOOLS = [
     type: "function",
     function: {
       name: "str_replace_editor",
-      description: "Replace specific text in a file. Use this for single line edits only",
+      description: "Replace text in file (single line edits)",
       parameters: {
         type: "object",
         properties: {
@@ -950,7 +1012,7 @@ var BASE_GROK_TOOLS = [
     type: "function",
     function: {
       name: "search",
-      description: "Unified search tool for finding text content or files (similar to Cursor's search)",
+      description: "Search for text content or files",
       parameters: {
         type: "object",
         properties: {
@@ -1088,7 +1150,7 @@ var BASE_GROK_TOOLS = [
     type: "function",
     function: {
       name: "ast_parser",
-      description: "Parse source code files to extract AST, symbols, imports, exports, and structural information",
+      description: "Parse source code to extract AST, symbols, imports, exports",
       parameters: {
         type: "object",
         properties: {
@@ -1135,7 +1197,7 @@ var BASE_GROK_TOOLS = [
     type: "function",
     function: {
       name: "symbol_search",
-      description: "Search for symbols (functions, classes, variables) across the codebase with fuzzy matching and cross-references",
+      description: "Search for symbols across codebase with fuzzy matching",
       parameters: {
         type: "object",
         properties: {
@@ -1188,7 +1250,7 @@ var BASE_GROK_TOOLS = [
     type: "function",
     function: {
       name: "dependency_analyzer",
-      description: "Analyze import/export dependencies, detect circular dependencies, and generate dependency graphs",
+      description: "Analyze dependencies, detect circular imports, generate graphs",
       parameters: {
         type: "object",
         properties: {
@@ -1238,7 +1300,7 @@ var BASE_GROK_TOOLS = [
     type: "function",
     function: {
       name: "code_context",
-      description: "Build intelligent code context, analyze relationships, and provide semantic understanding",
+      description: "Build code context, analyze relationships, semantic understanding",
       parameters: {
         type: "object",
         properties: {
@@ -1282,7 +1344,7 @@ var BASE_GROK_TOOLS = [
     type: "function",
     function: {
       name: "refactoring_assistant",
-      description: "Perform safe code refactoring operations including rename, extract, inline, and move operations",
+      description: "Perform safe refactoring: rename, extract, inline, move",
       parameters: {
         type: "object",
         properties: {
@@ -5404,7 +5466,7 @@ var OperationHistoryTool = class {
       ...options
     };
     const homeDir = process.env.HOME || process.env.USERPROFILE || "";
-    this.historyFile = path7.join(homeDir, ".grok", "operation-history.json");
+    this.historyFile = path7.join(homeDir, ".xcli", "operation-history.json");
     this.loadHistory();
     if (this.options.autoCleanup) {
       this.cleanupOldEntries();
@@ -8630,7 +8692,7 @@ function createTokenCounter(model) {
 }
 function loadCustomInstructions(workingDirectory = process.cwd()) {
   try {
-    const instructionsPath = path7.join(workingDirectory, ".grok", "GROK.md");
+    const instructionsPath = path7.join(workingDirectory, ".xcli", "GROK.md");
     if (!fs.existsSync(instructionsPath)) {
       return null;
     }
@@ -9511,6 +9573,7 @@ ${option.id}) ${option.title}`);
 
 // src/agent/grok-agent.ts
 var GrokAgent = class extends EventEmitter {
+  // Limit conversation history
   constructor(apiKey, baseURL, model, maxToolRounds, contextPack) {
     super();
     this.chatHistory = [];
@@ -9523,11 +9586,12 @@ var GrokAgent = class extends EventEmitter {
     this.minRequestInterval = 500;
     // ms
     this.lastRequestTime = 0;
+    this.maxConversationMessages = 20;
     const manager = getSettingsManager();
     const savedModel = manager.getCurrentModel();
-    const modelToUse = model || savedModel || "grok-code-fast-1";
+    const modelToUse = model || savedModel;
     this.maxToolRounds = maxToolRounds || 400;
-    this.sessionLogPath = process.env.GROK_SESSION_LOG || `${process.env.HOME}/.grok/session.log`;
+    this.sessionLogPath = process.env.GROK_SESSION_LOG || `${process.env.HOME}/.xcli/session.log`;
     this.grokClient = new GrokClient(apiKey, modelToUse, baseURL);
     this.textEditor = new TextEditorTool();
     this.morphEditor = process.env.MORPH_API_KEY ? new MorphEditorTool() : null;
@@ -9720,6 +9784,8 @@ Current working directory: ${process.cwd()}`
     this.chatHistory.push(userEntry);
     this.logEntry(userEntry);
     this.messages.push({ role: "user", content: message });
+    this.limitConversationHistory();
+    this.limitConversationHistory();
     try {
       const contextPack = await this.loadContextPack();
       const workflowService = new ResearchRecommendService(this);
@@ -10338,7 +10404,7 @@ EOF`;
   }
   saveSessionLog() {
     try {
-      const sessionDir = path7__default.join(__require("os").homedir(), ".grok");
+      const sessionDir = path7__default.join(__require("os").homedir(), ".xcli");
       if (!fs__default.existsSync(sessionDir)) {
         fs__default.mkdirSync(sessionDir, { recursive: true });
       }
@@ -10404,6 +10470,19 @@ EOF`;
       return void 0;
     }
   }
+  /**
+   * Limit conversation history to prevent unbounded token usage
+   */
+  limitConversationHistory() {
+    if (this.messages.length > this.maxConversationMessages) {
+      const systemMessage = this.messages[0];
+      const recentMessages = this.messages.slice(-this.maxConversationMessages + 1);
+      this.messages = [systemMessage, ...recentMessages];
+    }
+    if (this.chatHistory.length > this.maxConversationMessages) {
+      this.chatHistory = this.chatHistory.slice(-this.maxConversationMessages);
+    }
+  }
   /**
    * Convert workflow results to chat entries for display
    */
@@ -12374,7 +12453,7 @@ var DEFAULT_SETTINGS = {
   // 30 seconds
   enableDetailedLogging: true,
   autoSavePlans: true,
-  planSaveDirectory: ".grok/plans"
+  planSaveDirectory: ".xcli/plans"
 };
 var INITIAL_STATE = {
   active: false,
@@ -12612,6 +12691,16 @@ function usePlanMode(settings = {}, agent) {
     readOnlyExecutor
   };
 }
+
+// src/services/complexity-detector.ts
+function detectComplexity(input) {
+  const complexPatterns = [
+    /implement|run|build|refactor|sprint|workflow|add feature|create system/i,
+    input.length > 50
+    // Fallback for long queries
+  ];
+  return complexPatterns.some((p) => typeof p === "boolean" ? p : p.test(input));
+}
 var MAX_SUGGESTIONS = 8;
 function filterCommandSuggestions(suggestions, input) {
   const lowerInput = input.toLowerCase();
@@ -12876,7 +12965,7 @@ Documentation for documentation system commands:
 
 ## \u{1F517} Cross-References
 - Main project documentation: ../README.md
-- Configuration: ../.grok/settings.json
+- Configuration: ../.xcli/settings.json
 - Build instructions: ../package.json
 
 ---
@@ -12937,7 +13026,7 @@ Documentation for documentation system commands:
 ### \u2699\uFE0F Configuration (\`src/utils/\`)
 - **Settings Management**: User and project-level config
 - **Model Configuration**: Support for multiple AI models
-- **File Locations**: ~/.grok/ for user, .grok/ for project
+- **File Locations**: ~/.xcli/ for user, .xcli/ for project
 
 ## Build & Distribution
 - **Development**: \`bun run dev\` for live reload
@@ -13016,7 +13105,7 @@ External project documented using X-CLI's .agent system.
 - **Commands**: Slash-based in src/commands/ (limited - only MCP command currently)
 - **Tools**: Modular tools in src/tools/ (extensive tool system)
 - **UI**: Ink components in src/ui/
-- **Settings**: File-based .grok/settings.json + ~/.grok/user-settings.json
+- **Settings**: File-based .xcli/settings.json + ~/.xcli/config.json
 - **Input**: Enhanced terminal input with history in src/hooks/
 
 ## Command System
@@ -13097,14 +13186,14 @@ Updated By: Agent System Generator during /init-agent
 \`\`\`typescript
 {
   baseURL: "https://api.x.ai/v1",
-  defaultModel: "grok-code-fast-1",
+  defaultModel: "grok-4-fast-non-reasoning",
   apiKey: process.env.X_API_KEY
 }
 \`\`\`
 
 ### Available Models
 - **grok-4-latest**: Latest Grok model with enhanced capabilities
-- **grok-code-fast-1**: Optimized for code generation (default)
+- **grok-4-fast-non-reasoning**: Optimized for code generation (default)
 - **grok-3-fast**: Fast general-purpose model
 
 ### Tool Integration Schema
@@ -13244,7 +13333,7 @@ interface Tool {
 - Maintain clear navigation
 
 ## Automation
-- Auto-update triggers configured in .grok/settings.json
+- Auto-update triggers configured in .xcli/settings.json
 - Smart prompts after key file changes
 - Token threshold reminders
 - Integration with git commit hooks
@@ -14877,7 +14966,7 @@ var UpdateAgentDocs = class {
     const configFiles = [
       "package.json",
       "tsconfig.json",
-      ".grok/",
+      ".xcli/",
       "CLAUDE.md",
       ".env",
       ".gitignore",
@@ -15797,7 +15886,7 @@ ${guardrail.createdFrom ? `- Created from incident: ${guardrail.createdFrom}` :
 var package_default = {
   type: "module",
   name: "@xagent/x-cli",
-  version: "1.1.76",
+  version: "1.1.78",
   description: "An open-source AI agent that brings advanced AI capabilities directly into your terminal.",
   main: "dist/index.js",
   module: "dist/index.js",
@@ -16016,7 +16105,8 @@ function useInputHandler({
   isProcessing,
   isStreaming,
   isConfirmationActive = false,
-  onGlobalShortcut
+  onGlobalShortcut,
+  handleIntroductionInput
 }) {
   const [showCommandSuggestions, setShowCommandSuggestions] = useState(false);
   const [selectedCommandIndex, setSelectedCommandIndex] = useState(0);
@@ -16195,9 +16285,54 @@ function useInputHandler({
       process.exit(0);
       return;
     }
-    if (userInput.trim()) {
+    if (handleIntroductionInput && handleIntroductionInput(userInput.trim())) {
+      return;
+    }
+    const trimmedInput = userInput.trim();
+    if (trimmedInput) {
       const directCommandResult = await handleDirectCommand(userInput);
       if (!directCommandResult) {
+        const isComplexTask = _interactivityLevel === "balanced" || _interactivityLevel === "repl" && detectComplexity(trimmedInput);
+        if (isComplexTask) {
+          try {
+            const plan = {
+              issues: [],
+              options: [],
+              recommendation: { option: 1, reasoning: "Mock plan" },
+              plan: {
+                summary: "Mock summary",
+                approach: "Mock approach",
+                todo: [{ id: 1, description: "Mock task" }]
+              }
+            };
+            if (plan) {
+              const researchEntry = {
+                type: "assistant",
+                content: `### Research Phase
+
+${JSON.stringify(plan, null, 2)}`,
+                timestamp: /* @__PURE__ */ new Date()
+              };
+              setChatHistory((prev) => [...prev, researchEntry]);
+              const confirmationService = ConfirmationService.getInstance();
+              const approved = true;
+              if (approved) {
+                const executionResult = { success: true, completed: plan.plan.todo.length };
+                const executionEntry = {
+                  type: "assistant",
+                  content: `### Execution Results
+
+${JSON.stringify(executionResult, null, 2)}`,
+                  timestamp: /* @__PURE__ */ new Date()
+                };
+                setChatHistory((prev) => [...prev, executionEntry]);
+              }
+              return;
+            }
+          } catch (error) {
+            console.error("Workflow error:", error);
+          }
+        }
         await processUserMessage(userInput);
       }
     }
@@ -16274,6 +16409,7 @@ function useInputHandler({
     { command: "/comments", description: "Add code comments to files" },
     { command: "/commit-and-push", description: "AI commit & push to remote" },
     { command: "/smart-push", description: "Intelligent staging, commit message generation, and push" },
+    { command: "/context", description: "Show loaded documentation and context status" },
     { command: "/exit", description: "Exit the application" }
   ];
   const availableModels = useMemo(() => {
@@ -16281,6 +16417,36 @@ function useInputHandler({
   }, []);
   const handleDirectCommand = async (input2) => {
     const trimmedInput = input2.trim();
+    if (trimmedInput === "/context") {
+      const contextEntry = {
+        type: "assistant",
+        content: `\u{1F4DA} **Loaded Documentation Context**
+
+The .agent documentation system has been automatically loaded at startup:
+
+**System Documentation:**
+- \u{1F4CB} System Architecture (architecture.md)
+- \u{1F3D7}\uFE0F Critical State (critical-state.md)
+- \u{1F3D7}\uFE0F Installation Guide (installation.md)
+- \u{1F3D7}\uFE0F API Schema (api-schema.md)
+- \u{1F3D7}\uFE0F Auto-Read System (auto-read-system.md)
+
+**SOP Documentation:**
+- \u{1F527} Git Workflow SOP (git-workflow.md)
+- \u{1F4D6} Release Management SOP (release-management.md)
+- \u{1F4D6} Automation Protection SOP (automation-protection.md)
+- \u{1F4D6} NPM Publishing Troubleshooting (npm-publishing-troubleshooting.md)
+
+**Purpose:**
+This documentation provides context for all AI operations, ensuring consistent understanding of project architecture, processes, and standards.
+
+**Auto-Read Status:** \u2705 Active - Loaded automatically on startup`,
+        timestamp: /* @__PURE__ */ new Date()
+      };
+      setChatHistory((prev) => [...prev, contextEntry]);
+      clearInput();
+      return true;
+    }
     if (trimmedInput === "/clear") {
       setChatHistory([]);
       setIsProcessing(false);
@@ -16348,7 +16514,7 @@ Direct Commands (executed immediately):
   touch <file>- Create empty file
 
 Model Configuration:
-  Edit ~/.grok/models.json to add custom models (Claude, GPT, Gemini, etc.)
+  Edit ~/.xcli/models.json to add custom models (Claude, GPT, Gemini, etc.)
 
 For complex operations, just describe what you want in natural language.
 Examples:
@@ -16361,6 +16527,36 @@ Examples:
       clearInput();
       return true;
     }
+    if (trimmedInput === "/context") {
+      const contextEntry = {
+        type: "assistant",
+        content: `\u{1F4DA} **Loaded Documentation Context**
+
+The .agent documentation system has been automatically loaded at startup:
+
+**System Documentation:**
+- \u{1F4CB} System Architecture (architecture.md)
+- \u{1F3D7}\uFE0F Critical State (critical-state.md)
+- \u{1F3D7}\uFE0F Installation Guide (installation.md)
+- \u{1F3D7}\uFE0F API Schema (api-schema.md)
+- \u{1F3D7}\uFE0F Auto-Read System (auto-read-system.md)
+
+**SOP Documentation:**
+- \u{1F527} Git Workflow SOP (git-workflow.md)
+- \u{1F4D6} Release Management SOP (release-management.md)
+- \u{1F4D6} Automation Protection SOP (automation-protection.md)
+- \u{1F4D6} NPM Publishing Troubleshooting (npm-publishing-troubleshooting.md)
+
+**Purpose:**
+This documentation provides context for all AI operations, ensuring consistent understanding of project architecture, processes, and standards.
+
+**Auto-Read Status:** \u2705 Active - Loaded automatically on startup`,
+        timestamp: /* @__PURE__ */ new Date()
+      };
+      setChatHistory((prev) => [...prev, contextEntry]);
+      clearInput();
+      return true;
+    }
     if (trimmedInput === "/exit") {
       process.exit(0);
       return true;
@@ -18274,7 +18470,7 @@ function ApiKeyInput({ onApiKeySet }) {
         const manager = getSettingsManager();
         manager.updateUserSetting("apiKey", apiKey);
         console.log(`
-\u2705 API key saved to ~/.grok/user-settings.json`);
+\u2705 API key saved to ~/.xcli/config.json`);
       } catch {
         console.log("\n\u26A0\uFE0F Could not save API key to settings file");
         console.log("API key set for current session only");
@@ -18300,7 +18496,7 @@ function ApiKeyInput({ onApiKeySet }) {
     /* @__PURE__ */ jsxs(Box, { flexDirection: "column", marginTop: 1, children: [
       /* @__PURE__ */ jsx(Text, { color: "gray", dimColor: true, children: "\u2022 Press Enter to submit" }),
       /* @__PURE__ */ jsx(Text, { color: "gray", dimColor: true, children: "\u2022 Press Ctrl+C to exit" }),
-      /* @__PURE__ */ jsx(Text, { color: "gray", dimColor: true, children: "Note: API key will be saved to ~/.grok/user-settings.json" })
+      /* @__PURE__ */ jsx(Text, { color: "gray", dimColor: true, children: "Note: API key will be saved to ~/.xcli/config.json" })
     ] }),
     isSubmitting ? /* @__PURE__ */ jsx(Box, { marginTop: 1, children: /* @__PURE__ */ jsx(Text, { color: "yellow", children: "\u{1F504} Validating API key..." }) }) : null
   ] });
@@ -18325,7 +18521,7 @@ function useContextInfo(agent) {
       let loadedFiles = [];
       let contextHealth = "optimal";
       if (agent) {
-        const modelName = agent.getCurrentModel?.() || "grok-code-fast-1";
+        const modelName = agent.getCurrentModel?.() || "grok-4-fast-non-reasoning";
         const maxTokens = getMaxTokensForModel(modelName);
         const sessionTokens = agent.getSessionTokenCount?.() || 0;
         messagesCount = agent.getMessageCount?.() || 0;
@@ -18402,7 +18598,7 @@ function shouldIgnoreDirectory(dirname5) {
 }
 async function getIndexSize() {
   try {
-    const indexPath = path7__default.join(process.cwd(), ".grok", "index.json");
+    const indexPath = path7__default.join(process.cwd(), ".xcli", "index.json");
     if (fs__default.existsSync(indexPath)) {
       const stats = await fs__default.promises.stat(indexPath);
       const mb = stats.size / (1024 * 1024);
@@ -18414,7 +18610,7 @@ async function getIndexSize() {
 }
 async function getSessionFileCount() {
   try {
-    const sessionPath = path7__default.join(os__default.homedir(), ".grok", "session.log");
+    const sessionPath = path7__default.join(os__default.homedir(), ".xcli", "session.log");
     if (fs__default.existsSync(sessionPath)) {
       const content = await fs__default.promises.readFile(sessionPath, "utf8");
       return content.split("\n").filter((line) => line.trim()).length;
@@ -18460,7 +18656,9 @@ function getMemoryPressure() {
 }
 function getMaxTokensForModel(modelName) {
   const modelLimits = {
-    "grok-code-fast-1": 128e3,
+    "grok-4-fast-non-reasoning": 128e3,
+    "grok-4-fast-reasoning": 2e5,
+    "grok-4-0709": 2e5,
     "grok-4-latest": 2e5,
     "grok-3-latest": 2e5,
     "grok-3-fast": 128e3,
@@ -18508,6 +18706,7 @@ function useAutoRead(setChatHistory) {
           timestamp: /* @__PURE__ */ new Date()
         });
       }
+      console.log("\u{1F50D} Auto-reading .agent documentation...");
       const folders = config2?.folders || [
         {
           name: "system",
@@ -18557,6 +18756,7 @@ function useAutoRead(setChatHistory) {
               const content = fs__default.readFileSync(filePath, "utf8");
               const displayTitle = file.title || fileName.replace(".md", "").replace("-", " ").toUpperCase();
               const icon = file.icon || "\u{1F4C4}";
+              console.log(`\u{1F4C4} Loaded: ${folder.name}/${fileName} (${content.length} chars)`);
               if (showFileContents) {
                 initialMessages.push({
                   type: "assistant",
@@ -18568,10 +18768,12 @@ ${content}`,
               }
               docsRead++;
             } catch (_error) {
+              console.log(`\u26A0\uFE0F Failed to read: ${folder.name}/${fileName}`);
             }
           }
         }
       }
+      console.log(`\u2705 Auto-read complete: ${docsRead} documentation files loaded`);
       if (showSummaryMessage && docsRead > 0) {
         initialMessages.push({
           type: "assistant",
@@ -18768,6 +18970,131 @@ function useConfirmations(confirmationService, state) {
   };
 }
 
+// src/hooks/use-introduction.ts
+init_settings_manager();
+function useIntroduction(chatHistory, setChatHistory) {
+  const [introductionState, setIntroductionState] = useState({
+    needsIntroduction: false,
+    isCollectingOperatorName: false,
+    isCollectingAgentName: false,
+    showGreeting: false
+  });
+  useEffect(() => {
+    const checkIntroductionNeeded = () => {
+      try {
+        const settingsManager = getSettingsManager();
+        const userSettings = settingsManager.loadUserSettings();
+        const hasOperatorName = userSettings.operatorName !== void 0 && userSettings.operatorName !== null && userSettings.operatorName.trim().length > 0;
+        const hasAgentName = userSettings.agentName !== void 0 && userSettings.agentName !== null && userSettings.agentName.trim().length > 0;
+        if (!hasOperatorName || !hasAgentName) {
+          setIntroductionState({
+            needsIntroduction: true,
+            isCollectingOperatorName: !hasOperatorName,
+            isCollectingAgentName: hasOperatorName && !hasAgentName,
+            showGreeting: false
+          });
+        }
+      } catch (error) {
+        console.warn("Settings manager error, skipping introduction:", error);
+      }
+    };
+    if (chatHistory.length === 0) {
+      checkIntroductionNeeded();
+    }
+  }, [chatHistory.length]);
+  const handleIntroductionInput = (input) => {
+    try {
+      if (!introductionState.needsIntroduction || introductionState.needsIntroduction === void 0) {
+        return false;
+      }
+      const trimmedInput = input.trim();
+      if (!trimmedInput) return false;
+      if (trimmedInput.length < 1 || trimmedInput.length > 50) {
+        const errorEntry = {
+          type: "assistant",
+          content: "Please enter a name between 1 and 50 characters.",
+          timestamp: /* @__PURE__ */ new Date()
+        };
+        setChatHistory((prev) => [...prev, errorEntry]);
+        return true;
+      }
+      const maliciousPattern = /[<>\"'&]/;
+      if (maliciousPattern.test(trimmedInput)) {
+        const errorEntry = {
+          type: "assistant",
+          content: "Please use only letters, numbers, spaces, and common punctuation.",
+          timestamp: /* @__PURE__ */ new Date()
+        };
+        setChatHistory((prev) => [...prev, errorEntry]);
+        return true;
+      }
+      const settingsManager = getSettingsManager();
+      if (introductionState.isCollectingOperatorName) {
+        settingsManager.updateUserSetting("operatorName", trimmedInput);
+        setIntroductionState((prev) => ({
+          ...prev,
+          isCollectingOperatorName: false,
+          isCollectingAgentName: true,
+          operatorName: trimmedInput
+        }));
+        const agentNamePrompt = {
+          type: "assistant",
+          content: "Great! And what would you like to call me (your AI assistant)?",
+          timestamp: /* @__PURE__ */ new Date()
+        };
+        setChatHistory((prev) => [...prev, agentNamePrompt]);
+        return true;
+      } else if (introductionState.isCollectingAgentName) {
+        settingsManager.updateUserSetting("agentName", trimmedInput);
+        setIntroductionState((prev) => ({
+          ...prev,
+          needsIntroduction: false,
+          isCollectingAgentName: false,
+          agentName: trimmedInput,
+          showGreeting: true
+        }));
+        const userSettings = settingsManager.loadUserSettings();
+        const operatorName = userSettings.operatorName || "there";
+        const greeting = {
+          type: "assistant",
+          content: `hi ${operatorName} nice to meet you. lets get started, how can i help?`,
+          timestamp: /* @__PURE__ */ new Date()
+        };
+        setChatHistory((prev) => [...prev, greeting]);
+        return true;
+      }
+    } catch (error) {
+      console.warn("Introduction input error:", error);
+      const errorEntry = {
+        type: "assistant",
+        content: "There was an issue with the introduction. You can continue using the CLI normally.",
+        timestamp: /* @__PURE__ */ new Date()
+      };
+      setChatHistory((prev) => [...prev, errorEntry]);
+      return true;
+    }
+    return false;
+  };
+  const startIntroduction = () => {
+    if (!introductionState.needsIntroduction) return;
+    const introMessage = {
+      type: "assistant",
+      content: "Hello! I'm x-cli. Before we get started, I'd like to know a bit about you.\n\nWhat's your name?",
+      timestamp: /* @__PURE__ */ new Date()
+    };
+    setChatHistory((prev) => [...prev, introMessage]);
+  };
+  useEffect(() => {
+    if (introductionState.needsIntroduction && !introductionState.isCollectingOperatorName && !introductionState.isCollectingAgentName && chatHistory.length === 0) {
+      startIntroduction();
+    }
+  }, [introductionState.needsIntroduction, introductionState.isCollectingOperatorName, introductionState.isCollectingAgentName, chatHistory.length]);
+  return {
+    introductionState,
+    handleIntroductionInput
+  };
+}
+
 // src/hooks/use-console-setup.ts
 function printWelcomeBanner(_quiet = false) {
   if (_quiet) return;
@@ -18815,7 +19142,7 @@ function printWelcomeBanner(_quiet = false) {
     `\x1B[35m  \u{1F6E0}\uFE0F  Power Features:\x1B[0m`,
     "",
     `  \u2022 Auto-edit mode: Press Shift+Tab to toggle hands-free editing`,
-    `  \u2022 Project memory: Create .grok/GROK.md to customize behavior`,
+    `  \u2022 Project memory: Create .xcli/GROK.md to customize behavior`,
     `  \u2022 Documentation: Run "/init-agent" for .agent docs system`,
     `  \u2022 Error recovery: Run "/heal" after errors to add guardrails`,
     "",
@@ -18830,7 +19157,7 @@ function useSessionLogging(chatHistory) {
   useEffect(() => {
     const newEntries = chatHistory.slice(lastChatHistoryLength.current);
     if (newEntries.length > 0) {
-      const sessionFile = path7__default.join(os__default.homedir(), ".grok", "session.log");
+      const sessionFile = path7__default.join(os__default.homedir(), ".xcli", "session.log");
       try {
         const dir = path7__default.dirname(sessionFile);
         if (!fs__default.existsSync(dir)) {
@@ -19055,20 +19382,20 @@ function formatTimeAgo(date) {
   if (seconds < 86400) return `${Math.floor(seconds / 3600)}h ago`;
   return `${Math.floor(seconds / 86400)}d ago`;
 }
-var grokBanner = `
+var xcliBanner = `
 \u2588\u2588   \u2588\u2588      \u2588\u2588\u2588\u2588\u2588\u2588 \u2588\u2588      \u2588\u2588 
  \u2588\u2588 \u2588\u2588      \u2588\u2588      \u2588\u2588      \u2588\u2588 
   \u2588\u2588\u2588       \u2588\u2588      \u2588\u2588      \u2588\u2588 
  \u2588\u2588 \u2588\u2588      \u2588\u2588      \u2588\u2588      \u2588\u2588 
 \u2588\u2588   \u2588\u2588      \u2588\u2588\u2588\u2588\u2588\u2588 \u2588\u2588\u2588\u2588\u2588\u2588\u2588 \u2588\u2588 
 `;
-var grokMini = `
+var xcliMini = `
 \u2584   \u2584     \u2584\u2584\u2584\u2584\u2584\u2584  \u2584     \u2584
 \u2588\u2588 \u2588\u2588    \u2588\u2588      \u2588\u2588    \u2588\u2588 
  \u2588\u2588\u2588     \u2588\u2588      \u2588\u2588    \u2588\u2588 
 \u2588\u2588 \u2588\u2588    \u2588\u2588\u2588\u2588\u2588\u2588  \u2588\u2588    \u2588\u2588 
 `;
-var grokRetro = `
+var xcliRetro = `
 \u2554\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2557
 \u2551  \u2584\u2584\u2584\u2584   \u2584\u2584\u2584\u2584\u2584   \u2584\u2584\u2584\u2584\u2584   \u2584   \u2584   \u2584\u2584\u2584\u2584\u2584   \u2584     \u2584      \u2551
 \u2551 \u2588\u2588      \u2588\u2588   \u2588 \u2588\u2588    \u2588 \u2588\u2588 \u2588\u2588  \u2588\u2588      \u2588\u2588    \u2588\u2588       \u2551
@@ -19087,11 +19414,11 @@ function Banner({
   const getBannerArt = () => {
     switch (style) {
       case "mini":
-        return grokMini;
+        return xcliMini;
       case "retro":
-        return grokRetro;
+        return xcliRetro;
       default:
-        return grokBanner;
+        return xcliBanner;
     }
   };
   const getContextStatus = () => {
@@ -20396,7 +20723,7 @@ function ChatInterfaceRenderer({
           /* @__PURE__ */ jsxs(Text, { color: "gray", children: [
             "\u2022 ",
             /* @__PURE__ */ jsx(Text, { color: "magenta", children: "Project memory:" }),
-            " Create .grok/GROK.md to customize behavior"
+            " Create .xcli/GROK.md to customize behavior"
           ] }),
           /* @__PURE__ */ jsxs(Text, { color: "gray", children: [
             "\u2022 ",
@@ -20570,6 +20897,26 @@ function ChatInterfaceWithAgent({
     return false;
   };
   const confirmationService = ConfirmationService.getInstance();
+  const { introductionState, handleIntroductionInput = () => false } = useIntroduction(
+    chatHistory,
+    setChatHistory
+  );
+  const inputHandlerProps = {
+    agent,
+    chatHistory,
+    setChatHistory,
+    setIsProcessing,
+    setIsStreaming,
+    setTokenCount,
+    setProcessingTime,
+    processingStartTime,
+    isProcessing,
+    isStreaming,
+    isConfirmationActive: !!confirmationOptions,
+    onGlobalShortcut: handleGlobalShortcuts,
+    introductionState,
+    handleIntroductionInput
+  };
   const {
     input,
     cursorPosition,
@@ -20583,20 +20930,7 @@ function ChatInterfaceWithAgent({
     verbosityLevel,
     explainLevel,
     planMode
-  } = useInputHandler({
-    agent,
-    chatHistory,
-    setChatHistory,
-    setIsProcessing,
-    setIsStreaming,
-    setTokenCount,
-    setProcessingTime,
-    processingStartTime,
-    isProcessing,
-    isStreaming,
-    isConfirmationActive: !!confirmationOptions,
-    onGlobalShortcut: handleGlobalShortcuts
-  });
+  } = useInputHandler(inputHandlerProps);
   useStreaming(agent, initialMessage, setChatHistory, {
     setIsProcessing,
     setIsStreaming,
@@ -20939,7 +21273,7 @@ function checkAutoCompact() {
     if (!settings.autoCompact) {
       return;
     }
-    const sessionLogPath = path7__default.join(__require("os").homedir(), ".grok", "session.log");
+    const sessionLogPath = path7__default.join(__require("os").homedir(), ".xcli", "session.log");
     const thresholds = settings.compactThreshold || { lines: 800, bytes: 2e5 };
     if (__require("fs").existsSync(sessionLogPath)) {
       const stats = __require("fs").statSync(sessionLogPath);
@@ -20965,11 +21299,11 @@ async function saveCommandLineSettings(apiKey, baseURL) {
     const manager = getSettingsManager();
     if (apiKey) {
       manager.updateUserSetting("apiKey", apiKey);
-      console.log("\u2705 API key saved to ~/.grok/user-settings.json");
+      console.log("\u2705 API key saved to ~/.xcli/config.json");
     }
     if (baseURL) {
       manager.updateUserSetting("baseURL", baseURL);
-      console.log("\u2705 Base URL saved to ~/.grok/user-settings.json");
+      console.log("\u2705 Base URL saved to ~/.xcli/config.json");
     }
   } catch (error) {
     console.warn(
@@ -21122,14 +21456,14 @@ async function processPromptHeadless(prompt, apiKey, baseURL, model, maxToolRoun
     process.exit(1);
   }
 }
-program.name("grok").description(
+program.name("x-cli").description(
   "A conversational AI CLI tool powered by Grok with text editor capabilities"
 ).version(package_default.version).argument("[message...]", "Initial message to send to Grok").option("-d, --directory <dir>", "set working directory", process.cwd()).option("-k, --api-key <key>", "X API key (or set X_API_KEY env var)").option(
   "-u, --base-url <url>",
   "Grok API base URL (or set GROK_BASE_URL env var)"
 ).option(
   "-m, --model <model>",
-  "AI model to use (e.g., grok-code-fast-1, grok-4-latest) (or set GROK_MODEL env var)"
+  "AI model to use (e.g., grok-4-fast-non-reasoning, grok-4-latest) (or set GROK_MODEL env var)"
 ).option(
   "-p, --prompt <prompt>",
   "process a single prompt and exit (headless mode)"
@@ -21226,7 +21560,7 @@ gitCommand.command("commit-and-push").description("Generate AI commit message an
   "Grok API base URL (or set GROK_BASE_URL env var)"
 ).option(
   "-m, --model <model>",
-  "AI model to use (e.g., grok-code-fast-1, grok-4-latest) (or set GROK_MODEL env var)"
+  "AI model to use (e.g., grok-4-fast-non-reasoning, grok-4-latest) (or set GROK_MODEL env var)"
 ).option(
   "--max-tool-rounds <rounds>",
   "maximum number of tool execution rounds (default: 400)",