@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 +1 -1
- package/README.md +21 -18
- package/dist/index.js +11323 -2806
- package/dist/index.js.map +1 -1
- package/package.json +2 -2
package/LICENSE
CHANGED
package/README.md
CHANGED
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
## 1.1.
|
|
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.
|
|
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
|
-
### 🧠 **
|
|
172
|
+
### 🧠 **Advanced Codebase Intelligence** ⭐ **NEW - 75% Complete**
|
|
172
173
|
|
|
173
|
-
- **🔍
|
|
174
|
-
-
|
|
175
|
-
-
|
|
176
|
-
-
|
|
177
|
-
-
|
|
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 `~/.
|
|
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
|
|
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 `~/.
|
|
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 `~/.
|
|
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 (`~/.
|
|
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 (`.
|
|
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 `.
|
|
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 `~/.
|
|
802
|
+
Add to `~/.grok/user-settings.json`:
|
|
800
803
|
|
|
801
804
|
```json
|
|
802
805
|
{
|