@xagent/x-cli 1.1.75 → 1.1.77

package/README.md

@@ -1,6 +1,6 @@
 <!-- Test comment for PR creation -->
 
-## 1.1.75 – Logo Assets & NPM Publication Complete
+## 1.1.77 – Logo Assets & NPM Publication Complete
 
 ✅ **Live on NPM**: [@xagent/x-cli](https://www.npmjs.com/package/@xagent/x-cli) - Fully published and ready for global installation
 
@@ -21,7 +21,7 @@ This release includes corrected logo assets and complete automated publishing pi
 [![License](https://img.shields.io/github/license/x-cli-team/x-cli?style=for-the-badge&color=green)](https://github.com/x-cli-team/x-cli/blob/main/LICENSE)
 [![Discord](https://img.shields.io/badge/Discord-xAI_Community-5865F2?style=for-the-badge&logo=discord)](https://discord.com/channels/1315720379607679066/1315822328139223064)
 
-A conversational AI CLI tool powered by Grok with **Claude Code-level intelligence** and advanced tool capabilities.
+A conversational AI CLI tool powered by x.ai with **Claude Code-level intelligence** and advanced tool capabilities.
 
 <div align="center">
   <img src="docs/assets/logos/x-cli-logo-large.svg" alt="X CLI Logo" width="120" />
@@ -41,7 +41,7 @@ A conversational AI CLI tool powered by Grok with **Claude Code-level intelligen
 
 - **🎯 Shift+Tab Twice Activation**: Exact Claude Code Plan Mode with read-only exploration
 - **🔍 Comprehensive Codebase Analysis**: Project structure, dependencies, complexity metrics, and architecture patterns
-- **🧠 AI-Powered Implementation Planning**: Strategic plan generation using Grok models with risk assessment
+- **🧠 AI-Powered Implementation Planning**: Strategic plan generation using x.ai models with risk assessment
 - **🛡️ Read-Only Tool Execution**: Safe exploration with destructive operation blocking and simulation
 - **📊 Progress Visualization**: Real-time exploration and planning progress with phase-specific guidance
 - **📋 User Approval Workflow**: Complete plan review and confirmation before execution
@@ -103,7 +103,7 @@ A conversational AI CLI tool powered by Grok with **Claude Code-level intelligen
 
 - **🎯 Shift+Tab Twice**: Activate read-only exploration mode (exact Claude Code parity)
 - **🔍 Codebase Analysis**: Comprehensive project structure, dependencies, and complexity analysis
-- **🧠 AI-Powered Planning**: Strategic implementation plans generated by Grok models
+- **🧠 AI-Powered Planning**: Strategic implementation plans generated by x.ai models
 - **🛡️ Read-Only Safety**: Zero file modifications during exploration with tool simulation
 - **📊 Progress Tracking**: Real-time exploration progress with phase-specific guidance
 - **📋 Plan Approval**: Review and approve implementation plans before execution
@@ -128,7 +128,7 @@ A conversational AI CLI tool powered by Grok with **Claude Code-level intelligen
 
 ### 🤖 **Core AI Capabilities**
 
-- **💬 Conversational Interface**: Natural language powered by Grok models
+- **💬 Conversational Interface**: Natural language powered by x.ai models
 - **🔧 Intelligent Tool Selection**: AI automatically chooses the right tools for your requests
 - **⚡ Bash Integration**: Execute shell commands through natural conversation
 - **🔌 MCP Extension**: Extend capabilities with Model Context Protocol servers (Linear, GitHub, etc.)
@@ -277,7 +277,7 @@ npm link
 
 ## Setup
 
-1. Get your Grok API key from [X.AI](https://x.ai)
+1. Get your x.ai API key from [X.AI](https://x.ai)
 
 2. Set up your API key (choose one method):
 
@@ -328,7 +328,7 @@ MORPH_API_KEY=your_morph_api_key_here
 
 ### Custom Base URL (Optional)
 
-By default, the CLI uses `https://api.x.ai/v1` as the Grok API endpoint. You can configure a custom endpoint if needed (choose one method):
+By default, the CLI uses `https://api.x.ai/v1` as the x.ai API endpoint. You can configure a custom endpoint if needed (choose one method):
 
 **Method 1: Environment Variable**
 
@@ -360,7 +360,7 @@ X CLI uses two types of configuration files to manage settings:
 
 This file stores **global settings** that apply across all projects. These settings rarely change and include:
 
-- **API Key**: Your Grok API key
+- **API Key**: Your x.ai API key
 - **Base URL**: Custom API endpoint (if needed)
 - **Default Model**: Your preferred model (e.g., `grok-code-fast-1`)
 - **Available Models**: List of models you can use
@@ -420,7 +420,7 @@ This means you can have different models for different projects while maintainin
 
 **Popular Providers**:
 
-- **X.AI (Grok)**: `https://api.x.ai/v1` (default)
+- **X.AI**: `https://api.x.ai/v1` (default)
 - **OpenAI**: `https://api.openai.com/v1`
 - **OpenRouter**: `https://openrouter.ai/api/v1`
 - **Groq**: `https://api.groq.com/openai/v1`
@@ -444,7 +444,7 @@ This means you can have different models for different projects while maintainin
 
 ### 🎯 **Best Feature of X CLI - AI Context Optimization**
 
-The **`.agent` folder** is the most powerful feature of X CLI, enabling **self-documenting AI workflows** that automatically provide context to AI agents. This revolutionary approach ensures every AI interaction is informed by comprehensive project documentation, making conversations with Grok significantly more productive and accurate.
+The **`.agent` folder** is the most powerful feature of X CLI, enabling **self-documenting AI workflows** that automatically provide context to AI agents. This revolutionary approach ensures every AI interaction is informed by comprehensive project documentation, making conversations with x.ai models significantly more productive and accurate.
 
 ### 🏗️ **How It Works**
 
@@ -646,7 +646,7 @@ You can specify which AI model to use with the `--model` parameter or `GROK_MODE
 **Method 1: Command Line Flag**
 
 ```bash
-# Use Grok models
+# Use x.ai models
 xcli --model grok-code-fast-1
 xcli --model grok-4-latest
 xcli --model grok-3-latest
@@ -684,8 +684,8 @@ xcli [options]
 Options:
   -V, --version          output the version number
   -d, --directory <dir>  set working directory
-  -k, --api-key <key>    Grok API key (or set X_API_KEY env var)
-  -u, --base-url <url>   Grok API base URL (or set GROK_BASE_URL env var)
+  -k, --api-key <key>    x.ai API key (or set X_API_KEY env var)
+  -u, --base-url <url>   x.ai API base URL (or set GROK_BASE_URL env var)
   -m, --model <model>    AI model to use (e.g., grok-code-fast-1, grok-4-latest) (or set GROK_MODEL env var)
   -p, --prompt <prompt>  process a single prompt and exit (headless mode)
   --max-tool-rounds <rounds>  maximum number of tool execution rounds (default: 400)
@@ -712,7 +712,7 @@ Always add JSDoc comments for public functions and interfaces.
 Follow the existing code style and patterns in this project.
 ```
 
-Grok will automatically load and follow these instructions when working in your project directory. The custom instructions are added to Grok's system prompt and take priority over default behavior.
+X CLI will automatically load and follow these instructions when working in your project directory. The custom instructions are added to the AI model's system prompt and take priority over default behavior.
 
 ## Morph Fast Apply (Optional)
 

package/dist/index.js

@@ -15797,7 +15797,7 @@ ${guardrail.createdFrom ? `- Created from incident: ${guardrail.createdFrom}` :
 var package_default = {
   type: "module",
   name: "@xagent/x-cli",
-  version: "1.1.75",
+  version: "1.1.77",
   description: "An open-source AI agent that brings advanced AI capabilities directly into your terminal.",
   main: "dist/index.js",
   module: "dist/index.js",
@@ -16274,6 +16274,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 +16282,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);
@@ -16361,6 +16392,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;
@@ -18508,6 +18569,7 @@ function useAutoRead(setChatHistory) {
           timestamp: /* @__PURE__ */ new Date()
         });
       }
+      console.log("\u{1F50D} Auto-reading .agent documentation...");
       const folders = config2?.folders || [
         {
           name: "system",
@@ -18557,6 +18619,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 +18631,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",
@@ -19055,20 +19120,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 +19152,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 = () => {