@xagent/x-cli 1.1.76 → 1.1.78

package/README.md

@@ -1,6 +1,6 @@
 <!-- Test comment for PR creation -->
 
-## 1.1.76 – Logo Assets & NPM Publication Complete
+## 1.1.78 – 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**
 
@@ -356,13 +356,13 @@ Add to `~/.xcli/user-settings.json`:
 
 X CLI uses two types of configuration files to manage settings:
 
-### User-Level Settings (`~/.grok/user-settings.json`)
+### User-Level Settings (`~/.xcli/config.json`)
 
 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`)
+- **Default Model**: Your preferred model (e.g., `grok-4-fast-non-reasoning`)
 - **Available Models**: List of models you can use
 
 **Example:**
@@ -371,9 +371,9 @@ This file stores **global settings** that apply across all projects. These setti
 {
   "apiKey": "your_api_key_here",
   "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-latest",
     "grok-3-latest",
     "grok-3-fast",
@@ -382,7 +382,7 @@ This file stores **global settings** that apply across all projects. These setti
 }
 ```
 
-### Project-Level Settings (`.grok/settings.json`)
+### Project-Level Settings (`.xcli/settings.json`)
 
 This file stores **project-specific settings** in your current working directory. It includes:
 
@@ -410,7 +410,7 @@ This file stores **project-specific settings** in your current working directory
 1. **Global Defaults**: User-level settings provide your default preferences
 2. **Project Override**: Project-level settings override defaults for specific projects
 3. **Directory-Specific**: When you change directories, project settings are loaded automatically
-4. **Fallback Logic**: Project model → User default model → System default (`grok-code-fast-1`)
+4. **Fallback Logic**: Project model → User default model → System default (`grok-4-fast-non-reasoning`)
 
 This means you can have different models for different projects while maintaining consistent global settings like your API key.
 
@@ -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,8 +646,8 @@ You can specify which AI model to use with the `--model` parameter or `GROK_MODE
 **Method 1: Command Line Flag**
 
 ```bash
-# Use Grok models
-xcli --model grok-code-fast-1
+# Use x.ai models
+xcli --model grok-4-fast-non-reasoning
 xcli --model grok-4-latest
 xcli --model grok-3-latest
 xcli --model grok-3-fast
@@ -660,7 +660,7 @@ xcli --model claude-sonnet-4-20250514 --base-url https://api-endpoint.com/v1
 **Method 2: Environment Variable**
 
 ```bash
-export GROK_MODEL=grok-code-fast-1
+export GROK_MODEL=grok-4-fast-non-reasoning
 xcli
 ```
 
@@ -670,11 +670,11 @@ Add to `~/.xcli/user-settings.json`:
 ```json
 {
   "apiKey": "your_api_key_here",
-  "defaultModel": "grok-code-fast-1"
+  "defaultModel": "grok-4-fast-non-reasoning"
 }
 ```
 
-**Model Priority**: `--model` flag > `GROK_MODEL` environment variable > user default model > system default (grok-code-fast-1)
+**Model Priority**: `--model` flag > `GROK_MODEL` environment variable > user default model > system default (grok-4-fast-non-reasoning)
 
 ### Command Line Options
 
@@ -684,9 +684,9 @@ 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)
-  -m, --model <model>    AI model to use (e.g., grok-code-fast-1, grok-4-latest) (or set GROK_MODEL 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-4-fast-non-reasoning, 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)
   -h, --help             display help for command
@@ -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)
 
@@ -1051,7 +1051,7 @@ curl -I https://api.x.ai/v1/models
 - **File operations fail**: Check that the file path exists and is accessible
 - **Bash commands fail**: Ensure you have the necessary permissions
 - **Tool timeouts**: Complex operations may take time; the spinner indicates progress
-- **Slow responses**: Try a different model with `xcli --model grok-code-fast-1`
+- **Slow responses**: Try a different model with `xcli --model grok-4-fast-non-reasoning`
 
 ## 🙏 Credits