@xagent/one-shot 1.1.115 → 1.2.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/LICENSE CHANGED
@@ -1,6 +1,6 @@
1
1
  MIT License
2
2
 
3
- Copyright (c) [year] [copyright holders]
3
+ Copyright (c) 2025 x-cli-team
4
4
 
5
5
  Permission is hereby granted, free of charge, to any person obtaining a copy
6
6
  of this software and associated documentation files (the "Software"), to deal
package/README.md CHANGED
@@ -1,4 +1,4 @@
1
- ## 1.1.113 – Repository Migration Complete
1
+ ## 1.1.116 – Repository Migration Complete
2
2
 
3
3
  ✅ **Repository Successfully Renamed**: `x-cli-team/x-cli` → `x-cli-team/grok-one-shot`
4
4
  ✅ **Live on NPM**: [@xagent/one-shot](https://www.npmjs.com/package/@xagent/one-shot) - Fully published and ready for global installation
@@ -40,7 +40,7 @@ This release includes the complete repository migration with critical streaming
40
40
  │ # 1. Set your API key (secure local environment variable) │
41
41
  │ export X_API_KEY="your_xai_api_key_here" │
42
42
  │ │
43
- │ # 2. Run instantly (no installation required!)
43
+ │ # 2. Run instantly (no installation required!)
44
44
  │ npx @xagent/one-shot │
45
45
  │ │
46
46
  │ 🔐 Tip: Never commit API keys to git. Use local env vars! │
@@ -59,7 +59,7 @@ This release includes the complete repository migration with critical streaming
59
59
  A conversational AI CLI tool powered by x.ai with **Claude Code-level intelligence** and advanced tool capabilities.
60
60
 
61
61
  <div align="center">
62
- <img src="apps/site/static/img/logo.svg" alt="Grok One-Shot Logo" width="120" />
62
+ <img src="apps/site/static/img/logo.png" alt="Grok One-Shot Logo" width="120" />
63
63
  </div>
64
64
 
65
65
  ## 🔗 Quick Links
@@ -159,7 +159,7 @@ A conversational AI CLI tool powered by x.ai with **Claude Code-level intelligen
159
159
 
160
160
  ## ✨ Features
161
161
 
162
- ### 🎯 **Plan Mode - Claude Code's Signature Feature**
162
+ ### 🎯 **Plan Mode - Claude Code's Signature Feature** ⭐ **Production Ready**
163
163
 
164
164
  - **🎯 Shift+Tab Twice**: Activate read-only exploration mode (exact Claude Code parity)
165
165
  - **🔍 Codebase Analysis**: Comprehensive project structure, dependencies, and complexity analysis
@@ -167,14 +167,17 @@ A conversational AI CLI tool powered by x.ai with **Claude Code-level intelligen
167
167
  - **🛡️ Read-Only Safety**: Zero file modifications during exploration with tool simulation
168
168
  - **📊 Progress Tracking**: Real-time exploration progress with phase-specific guidance
169
169
  - **📋 Plan Approval**: Review and approve implementation plans before execution
170
+ - **⚙️ Advanced Architecture**: 5-phase activation system with rich visual feedback (3800+ lines of code)
170
171
 
171
- ### 🧠 **Claude Code-Level Intelligence**
172
+ ### 🧠 **Advanced Codebase Intelligence** ⭐ **NEW - 75% Complete**
172
173
 
173
- - **🔍 AST Code Analysis**: Parse TypeScript, JavaScript, Python files to extract symbols, imports, and structure
174
- - **🔎 Symbol Search**: Fuzzy search for functions, classes, variables across entire codebases
175
- - **📊 Dependency Analysis**: Detect circular dependencies and generate dependency graphs
176
- - **🎯 Code Context**: Intelligent relationship mapping with semantic analysis and quality metrics
177
- - **🔧 Safe Refactoring**: Rename, extract, inline operations with preview and rollback support
174
+ - **🔍 Deep Code Understanding**: Million-line codebase indexing with comprehensive symbol extraction
175
+ - **🌐 Semantic Search**: Natural language code discovery ("find authentication logic", "how does user registration work")
176
+ - **🏗️ Architectural Analysis**: Feature mapping, cross-cutting concern detection, and pattern recognition
177
+ - **🔄 Flow Tracing**: Execution path analysis from entry points with complexity metrics
178
+ - **📊 Symbol Intelligence**: Complete relationship mapping, usage tracking, and dependency analysis
179
+ - **🎯 Context-Aware Relevance**: Multi-factor scoring with detailed match explanations
180
+ - **⚡ High Performance**: 10,000+ files indexed in ~30 seconds with parallel processing
178
181
 
179
182
  ### 🚀 **Advanced File Operations**
180
183
 
@@ -202,7 +205,7 @@ A conversational AI CLI tool powered by x.ai with **Claude Code-level intelligen
202
205
  - **Research Phase**: Agent explains investigation approach with progress indicators
203
206
  - **Options Presentation**: Clear recommendations with pros/cons for complex tasks
204
207
  - **Confirmation Workflow**: Keyboard shortcuts (y/n/modify/cancel) for efficient decisions
205
- - **State Persistence**: Settings saved to `~/.xcli/config.json` across sessions
208
+ - **State Persistence**: Settings saved to `~/.grok/config.json` across sessions
206
209
 
207
210
  ### 🎨 **Enhanced User Experience**
208
211
 
@@ -400,7 +403,7 @@ grok-one-shot --help
400
403
 
401
404
  ```bash
402
405
  git clone <repository>
403
- cd xcli-cli
406
+ cd grok-one-shot
404
407
  npm install
405
408
  npm run build
406
409
  npm link
@@ -432,7 +435,7 @@ grok-one-shot --api-key your_api_key_here
432
435
  ```
433
436
 
434
437
  **Method 4: User Settings File**
435
- Create `~/.xcli/user-settings.json`:
438
+ Create `~/.grok/user-settings.json`:
436
439
 
437
440
  ```json
438
441
  {
@@ -474,7 +477,7 @@ grok-one-shot --api-key your_api_key_here --base-url https://your-custom-endpoin
474
477
  ```
475
478
 
476
479
  **Method 3: User Settings File**
477
- Add to `~/.xcli/user-settings.json`:
480
+ Add to `~/.grok/user-settings.json`:
478
481
 
479
482
  ```json
480
483
  {
@@ -487,7 +490,7 @@ Add to `~/.xcli/user-settings.json`:
487
490
 
488
491
  Grok One-Shot uses two types of configuration files to manage settings:
489
492
 
490
- ### User-Level Settings (`~/.xcli/config.json`)
493
+ ### User-Level Settings (`~/.grok/config.json`)
491
494
 
492
495
  This file stores **global settings** that apply across all projects. These settings rarely change and include:
493
496
 
@@ -513,7 +516,7 @@ This file stores **global settings** that apply across all projects. These setti
513
516
  }
514
517
  ```
515
518
 
516
- ### Project-Level Settings (`.xcli/settings.json`)
519
+ ### Project-Level Settings (`.grok/settings.json`)
517
520
 
518
521
  This file stores **project-specific settings** in your current working directory. It includes:
519
522
 
@@ -582,7 +585,7 @@ The **`.agent` folder** is the most powerful feature of Grok One-Shot, enabling
582
585
  When you run `npx -y @xagent/one-shot@latest`, the CLI automatically detects and reads `.agent/` documentation:
583
586
 
584
587
  1. **Auto-Discovery**: Scans for `.agent/` folder in current directory
585
- 2. **Configuration Loading**: Reads `.xcli/auto-read-config.json` (distributed) or `.agent/auto-read-config.json` (project override)
588
+ 2. **Configuration Loading**: Reads `.grok/auto-read-config.json` (distributed) or `.agent/auto-read-config.json` (project override)
586
589
  3. **Smart Loading**: Reads configured documentation files into chat context
587
590
  4. **Context Enhancement**: Provides comprehensive project understanding to AI
588
591
 
@@ -796,7 +799,7 @@ grok-one-shot
796
799
  ```
797
800
 
798
801
  **Method 3: User Settings File**
799
- Add to `~/.xcli/user-settings.json`:
802
+ Add to `~/.grok/user-settings.json`:
800
803
 
801
804
  ```json
802
805
  {