@xagent/one-shot 1.1.90 → 1.1.92

package/README.md

@@ -1,6 +1,6 @@
 <!-- Test comment for PR creation -->
 
-## 1.1.90 – Logo Assets & NPM Publication Complete
+## 1.1.92 – Logo Assets & NPM Publication Complete
 
 ✅ **Live on NPM**: [@xagent/one-shot](https://www.npmjs.com/package/@xagent/one-shot) - Fully published and ready for global installation
 
@@ -13,7 +13,27 @@ This release includes corrected logo assets and complete automated publishing pi
 
 ---
 
-# X CLI
+# Grok One-Shot
+
+<div align="center">
+
+```bash
+┌─────────────────────────────────────────────────────────────────┐
+│                        🚀 Quick Start                          │
+├─────────────────────────────────────────────────────────────────┤
+│                                                                 │
+│  # 1. Set your API key (secure local environment variable)     │
+│  export X_API_KEY="your_xai_api_key_here"                      │
+│                                                                 │
+│  # 2. Run instantly (no installation required!)               │
+│  npx @xagent/one-shot                                          │
+│                                                                 │
+│  🔐 Tip: Never commit API keys to git. Use local env vars!     │
+│                                                                 │
+└─────────────────────────────────────────────────────────────────┘
+```
+
+</div>
 
 [![NPM Version](https://img.shields.io/npm/v/@xagent/one-shot?style=for-the-badge&logo=npm&color=CB3837)](https://www.npmjs.com/package/@xagent/one-shot)
 [![GitHub Release](https://img.shields.io/github/v/release/x-cli-team/x-cli?style=for-the-badge&logo=github&color=181717)](https://github.com/x-cli-team/x-cli/releases)
@@ -24,7 +44,7 @@ This release includes corrected logo assets and complete automated publishing pi
 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" />
+  <img src="docs/assets/logos/x-cli-logo-large.svg" alt="Grok One-Shot Logo" width="120" />
 </div>
 
 ## 🔗 Quick Links
@@ -120,7 +140,7 @@ A conversational AI CLI tool powered by x.ai with **Claude Code-level intelligen
 - **⚡ FsPort Abstraction**: Improved file system operations with Node built-ins externalization
 - **📦 Automated Installer**: Enhanced installation UX with one-click setup options
 - **🛡️ Tool Reliability Fixes**: Standardized imports, syntax error resolution, and fallback mechanisms
-- **📋 Paste Text Summary**: Claude Code-style paste detection with smart summarization (`[Pasted text #1 +12 lines]`)
+- **📋 Revolutionary Paste Functionality**: Complete Claude Code parity with intelligent paste detection, cross-platform line ending support, and smart truncation for large content
 
 ## ✨ Features
 
@@ -158,7 +178,7 @@ A conversational AI CLI tool powered by x.ai with **Claude Code-level intelligen
 - **⚡ Bash Integration**: Execute shell commands through natural conversation
 - **🔌 MCP Extension**: Extend capabilities with Model Context Protocol servers (Linear, GitHub, etc.)
 - **💻 Beautiful Terminal UI**: Interactive interface with Claude Code-style animations and feedback
-- **📋 Smart Paste Detection**: Large pasted content automatically summarizes as `[Pasted text #1 +12 lines]` for clean chat history
+- **📋 Revolutionary Paste Detection**: Complete Claude Code parity with intelligent paste processing and smart summarization
 
 ### 🎛️ **Interactive Chat Interface**
 
@@ -178,6 +198,77 @@ A conversational AI CLI tool powered by x.ai with **Claude Code-level intelligen
 - **🌈 Consistent Color Language**: Claude Code-inspired visual hierarchy (info=blue, success=green, warn=orange, error=red)
 - **⚡ Motion Design**: Breathing pulse effects and smooth transitions for calm, responsive interface
 
+### 📋 **Revolutionary Paste Functionality - Claude Code Parity** ✨
+
+Experience seamless text pasting with **complete Claude Code feature parity** - our most celebrated feature!
+
+#### **🎯 Core Features**
+
+- **🔍 Instant Detection**: Automatic paste detection with configurable thresholds (2+ lines or 50+ characters)
+- **🌐 Cross-Platform Support**: Handles all line endings (`\r`, `\n`, `\r\n`) for universal compatibility
+- **💡 Smart Summaries**: Clean paste summaries like `[Pasted text #1 +13 lines]` for organized chat history
+- **📱 Responsive Display**: Perfect multiline input handling with proper cursor positioning and formatting
+- **⚡ No Auto-Submit**: Content stays in input field for review and editing before submission
+- **🎛️ Large Content Handling**: Intelligent truncation for 60+ line pastes with smart preview
+
+#### **🎮 How It Works**
+
+1. **Paste any content** - Code, logs, documentation, data - anything!
+2. **Instant visual feedback** - See paste summary immediately with line count
+3. **Review and edit** - Content stays in input field for modification
+4. **Submit when ready** - Press Enter to send after reviewing
+
+#### **📊 Smart Truncation Example**
+
+**Small pastes (≤10 lines)** - Show complete content:
+
+```
+❯ function hello() {
+  console.log("world");
+  return true;
+}
+```
+
+**Large pastes (>10 lines)** - Show smart truncated view:
+
+```
+❯ [Large paste: 45 lines, 1,247 chars]
+First few lines:
+  import React from 'react';
+  import { useState, useEffect } from 'react';
+  import { Box, Text } from 'ink';
+...
+Last few lines:
+  export default MyComponent;
+
+Press Enter to submit or edit to modify.
+```
+
+#### **🛠️ Configuration Options**
+
+Customize paste behavior with environment variables:
+
+```bash
+# Adjust paste detection sensitivity
+export GROK_PASTE_LINE_THRESHOLD=3     # Lines threshold (default: 2)
+export GROK_PASTE_CHAR_THRESHOLD=100   # Character threshold (default: 50)
+export GROK_PASTE_DEBUG=true           # Debug paste detection
+
+# Enable intelligent features (coming in Phase 2)
+export GROK_PASTE_INTELLIGENCE_ENABLED=true
+export GROK_PASTE_LANGUAGE_DETECTION=true
+```
+
+#### **🎖️ Why Revolutionary?**
+
+✅ **Complete Claude Code Parity** - Feature-for-feature compatibility  
+✅ **Zero Learning Curve** - Works exactly like Claude Code  
+✅ **Enhanced Reliability** - Handles edge cases Claude Code sometimes misses  
+✅ **Performance Optimized** - Lightning-fast detection and display  
+✅ **Developer Focused** - Built specifically for code and technical content
+
+_"shit thats it. you did it. OMG. . take a bow sir. what a milestone."_ - User feedback after successful implementation
+
 ### 📚 **Documentation System**
 
 - **🏗️ Agent Documentation**: Complete `.agent/` system for AI context optimization
@@ -379,7 +470,7 @@ Add to `~/.xcli/user-settings.json`:
 
 ## Configuration Files
 
-X CLI uses two types of configuration files to manage settings:
+Grok One-Shot uses two types of configuration files to manage settings:
 
 ### User-Level Settings (`~/.xcli/config.json`)
 
@@ -467,9 +558,9 @@ This means you can have different models for different projects while maintainin
 
 ## 📚 .agent Documentation System
 
-### 🎯 **Best Feature of X CLI - AI Context Optimization**
+### 🎯 **Best Feature of Grok One-Shot - 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 x.ai models significantly more productive and accurate.
+The **`.agent` folder** is the most powerful feature of Grok One-Shot, 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**
 
@@ -728,7 +819,7 @@ mkdir .grok
 Create `.grok/GROK.md` with your custom instructions:
 
 ```markdown
-# Custom Instructions for X CLI
+# Custom Instructions for Grok One-Shot
 
 Always use TypeScript for any new code files.
 When creating React components, use functional components with hooks.
@@ -737,7 +828,7 @@ Always add JSDoc comments for public functions and interfaces.
 Follow the existing code style and patterns in this project.
 ```
 
-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.
+Grok One-Shot 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)
 
@@ -1118,7 +1209,7 @@ This project is built upon the excellent foundation of the original [X-CLI](http
 **Founder**: [Ismail Pelaseyed](https://github.com/homanp)  
 **Organization**: [Superagent.ai](https://github.com/superagent-ai)
 
-X CLI extends the original with advanced file operations, enhanced tool systems, and comprehensive automation while maintaining the core vision of bringing AI-powered terminal intelligence to developers.
+Grok One-Shot extends the original with advanced file operations, enhanced tool systems, and comprehensive automation while maintaining the core vision of bringing AI-powered terminal intelligence to developers.
 
 **🚀 Now live on NPM**: Install globally with `npm install -g @xagent/one-shot` and start using `xcli` immediately!