@xagent/x-cli 1.1.85 → 1.1.89
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/README.md +50 -25
- package/dist/index.js +4 -4
- package/dist/index.js.map +1 -1
- package/package.json +5 -63
package/README.md
CHANGED
|
@@ -1,8 +1,8 @@
|
|
|
1
1
|
<!-- Test comment for PR creation -->
|
|
2
2
|
|
|
3
|
-
## 1.1.
|
|
3
|
+
## 1.1.89 – Logo Assets & NPM Publication Complete
|
|
4
4
|
|
|
5
|
-
✅ **Live on NPM**: [@xagent/
|
|
5
|
+
✅ **Live on NPM**: [@xagent/one-shot](https://www.npmjs.com/package/@xagent/one-shot) - Fully published and ready for global installation
|
|
6
6
|
|
|
7
7
|
This release includes corrected logo assets and complete automated publishing pipeline.
|
|
8
8
|
|
|
@@ -15,9 +15,9 @@ This release includes corrected logo assets and complete automated publishing pi
|
|
|
15
15
|
|
|
16
16
|
# X CLI
|
|
17
17
|
|
|
18
|
-
[](https://www.npmjs.com/package/@xagent/one-shot)
|
|
19
19
|
[](https://github.com/x-cli-team/x-cli/releases)
|
|
20
|
-
[](https://www.npmjs.com/package/@xagent/one-shot)
|
|
21
21
|
[](https://github.com/x-cli-team/x-cli/blob/main/LICENSE)
|
|
22
22
|
[](https://discord.com/channels/1315720379607679066/1315822328139223064)
|
|
23
23
|
|
|
@@ -29,12 +29,37 @@ A conversational AI CLI tool powered by x.ai with **Claude Code-level intelligen
|
|
|
29
29
|
|
|
30
30
|
## 🔗 Quick Links
|
|
31
31
|
|
|
32
|
-
- **📦 [NPM Package](https://www.npmjs.com/package/@xagent/
|
|
32
|
+
- **📦 [NPM Package](https://www.npmjs.com/package/@xagent/one-shot)** - Install globally with `npm install -g @xagent/one-shot`
|
|
33
33
|
- **🐙 [GitHub Repository](https://github.com/x-cli-team/x-cli)** - Source code, issues, and contributions
|
|
34
34
|
- **🎯 [Competitive Parity Analysis](./.agent/parity/)** - Strategic analysis vs Claude Code, Cursor IDE, and OpenAI Codex
|
|
35
35
|
- **💬 [xAI Community Discord](https://discord.com/channels/1315720379607679066/1315822328139223064)** - Official xAI API community support
|
|
36
36
|
- **📚 [Releases](https://github.com/x-cli-team/x-cli/releases)** - Version history and changelogs
|
|
37
37
|
|
|
38
|
+
## Featured In
|
|
39
|
+
|
|
40
|
+
<!-- AUTO-GENERATED: DO NOT EDIT -->
|
|
41
|
+
|
|
42
|
+
- **[superagent-ai/grok-cli](https://github.com/superagent-ai/grok-cli)** – Submitted via [Issue #XX](https://github.com/superagent-ai/grok-cli/issues/XX)
|
|
43
|
+

|
|
44
|
+
|
|
45
|
+
- **[RMNCLDYO/grok-ai-toolkit](https://github.com/RMNCLDYO/grok-ai-toolkit)** – Submitted via [Issue #XX](https://github.com/RMNCLDYO/grok-ai-toolkit/issues/XX)
|
|
46
|
+

|
|
47
|
+
|
|
48
|
+
- **[coldcanuk/grok-cli](https://github.com/coldcanuk/grok-cli)** – Submitted via [Issue #XX](https://github.com/coldcanuk/grok-cli/issues/XX)
|
|
49
|
+

|
|
50
|
+
|
|
51
|
+
- **[HyperCoherence/Grok4Git](https://github.com/HyperCoherence/Grok4Git)** – Submitted via [Issue #XX](https://github.com/HyperCoherence/Grok4Git/issues/XX)
|
|
52
|
+

|
|
53
|
+
|
|
54
|
+
- **[MustCodeAl/awesome-ai-cli](https://github.com/MustCodeAl/awesome-ai-cli)** – Submitted via [Issue #XX](https://github.com/MustCodeAl/awesome-ai-cli/issues/XX)
|
|
55
|
+

|
|
56
|
+
|
|
57
|
+
- **[xai-org/xai-cookbook](https://github.com/xai-org/xai-cookbook)** – Submitted via [Issue #XX](https://github.com/xai-org/xai-cookbook/issues/XX)
|
|
58
|
+

|
|
59
|
+
|
|
60
|
+
- **[milisp/awesome-grok](https://github.com/milisp/awesome-grok)** – **Merged!**
|
|
61
|
+

|
|
62
|
+
|
|
38
63
|
## 🆕 What's New in v1.0+
|
|
39
64
|
|
|
40
65
|
### 🎯 **P0: Plan Mode - Claude Code Parity** (Latest)
|
|
@@ -164,7 +189,7 @@ A conversational AI CLI tool powered by x.ai with **Claude Code-level intelligen
|
|
|
164
189
|
|
|
165
190
|
### 🌍 **Installation & Setup**
|
|
166
191
|
|
|
167
|
-
- **📦 Global Installation**: Install anywhere with `npm install -g @xagent/
|
|
192
|
+
- **📦 Global Installation**: Install anywhere with `npm install -g @xagent/one-shot`
|
|
168
193
|
- **⚙️ Flexible Configuration**: Environment variables, user settings, or project-specific configs
|
|
169
194
|
- **🔄 CI/CD Ready**: Headless mode perfect for automation and scripting
|
|
170
195
|
|
|
@@ -183,7 +208,7 @@ A conversational AI CLI tool powered by x.ai with **Claude Code-level intelligen
|
|
|
183
208
|
┌────────────────────────────────────┐
|
|
184
209
|
│ 🚀 One-Command Start │
|
|
185
210
|
├────────────────────────────────────┤
|
|
186
|
-
│ npx -y @xagent/
|
|
211
|
+
│ npx -y @xagent/one-shot@latest │
|
|
187
212
|
├────────────────────────────────────┤
|
|
188
213
|
│ Always latest version • Zero setup │
|
|
189
214
|
└────────────────────────────────────┘
|
|
@@ -193,7 +218,7 @@ A conversational AI CLI tool powered by x.ai with **Claude Code-level intelligen
|
|
|
193
218
|
**Option 1: Run without installing (Recommended)**
|
|
194
219
|
|
|
195
220
|
```bash
|
|
196
|
-
npx -y @xagent/
|
|
221
|
+
npx -y @xagent/one-shot@latest
|
|
197
222
|
```
|
|
198
223
|
|
|
199
224
|
_Always gets the latest version, no local installation needed_
|
|
@@ -201,20 +226,20 @@ _Always gets the latest version, no local installation needed_
|
|
|
201
226
|
**Option 2: Global installation**
|
|
202
227
|
|
|
203
228
|
```bash
|
|
204
|
-
npm install -g @xagent/
|
|
229
|
+
npm install -g @xagent/one-shot@latest
|
|
205
230
|
```
|
|
206
231
|
|
|
207
232
|
**Option 3: Alternative package managers**
|
|
208
233
|
|
|
209
234
|
```bash
|
|
210
235
|
# Using Yarn
|
|
211
|
-
yarn global add @xagent/
|
|
236
|
+
yarn global add @xagent/one-shot@latest
|
|
212
237
|
|
|
213
238
|
# Using pnpm
|
|
214
|
-
pnpm add -g @xagent/
|
|
239
|
+
pnpm add -g @xagent/one-shot@latest
|
|
215
240
|
|
|
216
241
|
# Using bun
|
|
217
|
-
bun add -g @xagent/
|
|
242
|
+
bun add -g @xagent/one-shot@latest
|
|
218
243
|
```
|
|
219
244
|
|
|
220
245
|
### 🛠️ PATH Setup (If `xcli` command not found)
|
|
@@ -253,13 +278,13 @@ which xcli # Should show installation path
|
|
|
253
278
|
**Try without installing:**
|
|
254
279
|
|
|
255
280
|
```bash
|
|
256
|
-
X_API_KEY=your_api_key_here npx -y @xagent/
|
|
281
|
+
X_API_KEY=your_api_key_here npx -y @xagent/one-shot@latest --help
|
|
257
282
|
```
|
|
258
283
|
|
|
259
284
|
**Or install globally:**
|
|
260
285
|
|
|
261
286
|
```bash
|
|
262
|
-
npm install -g @xagent/
|
|
287
|
+
npm install -g @xagent/one-shot@latest && \
|
|
263
288
|
echo 'export X_API_KEY=your_api_key_here' >> ~/.zshrc && \
|
|
264
289
|
source ~/.zshrc && \
|
|
265
290
|
xcli --help
|
|
@@ -448,7 +473,7 @@ The **`.agent` folder** is the most powerful feature of X CLI, enabling **self-d
|
|
|
448
473
|
|
|
449
474
|
### 🏗️ **How It Works**
|
|
450
475
|
|
|
451
|
-
When you run `npx -y @xagent/
|
|
476
|
+
When you run `npx -y @xagent/one-shot@latest`, the CLI automatically detects and reads `.agent/` documentation:
|
|
452
477
|
|
|
453
478
|
1. **Auto-Discovery**: Scans for `.agent/` folder in current directory
|
|
454
479
|
2. **Configuration Loading**: Reads `.xcli/auto-read-config.json` (distributed) or `.agent/auto-read-config.json` (project override)
|
|
@@ -850,7 +875,7 @@ Every push to the `main` branch automatically:
|
|
|
850
875
|
1. **🔄 Bumps version** (patch increment: 1.0.X → 1.0.X+1)
|
|
851
876
|
2. **📝 Updates README** with new version number
|
|
852
877
|
3. **🏗️ Builds the project** with fresh dependencies
|
|
853
|
-
4. **📦 Publishes to NPM** at https://www.npmjs.com/package/@xagent/
|
|
878
|
+
4. **📦 Publishes to NPM** at https://www.npmjs.com/package/@xagent/one-shot
|
|
854
879
|
5. **🏷️ Creates git tag** (e.g., `v1.0.87`)
|
|
855
880
|
|
|
856
881
|
**⏱️ Timeline**: ~3-5 minutes from push to NPM availability
|
|
@@ -911,7 +936,7 @@ npm run smart-push
|
|
|
911
936
|
|
|
912
937
|
```json
|
|
913
938
|
{
|
|
914
|
-
"name": "@xagent/
|
|
939
|
+
"name": "@xagent/one-shot", // ⚠️ NEVER change - breaks publishing
|
|
915
940
|
"publishConfig": {
|
|
916
941
|
"access": "public" // ⚠️ Must NOT include registry override
|
|
917
942
|
}
|
|
@@ -946,7 +971,7 @@ git push origin main --follow-tags
|
|
|
946
971
|
### 📊 Monitoring
|
|
947
972
|
|
|
948
973
|
- **GitHub Actions**: https://github.com/x-cli-team/x-cli/actions
|
|
949
|
-
- **NPM Package**: https://www.npmjs.com/package/@xagent/
|
|
974
|
+
- **NPM Package**: https://www.npmjs.com/package/@xagent/one-shot
|
|
950
975
|
- **Release History**: Check git tags or NPM version history
|
|
951
976
|
|
|
952
977
|
### 🛠️ Troubleshooting
|
|
@@ -995,7 +1020,7 @@ This project is based on [xcli-cli](https://github.com/superagent-ai/xcli-cli) b
|
|
|
995
1020
|
|
|
996
1021
|
```bash
|
|
997
1022
|
# Check if xcli is installed
|
|
998
|
-
npm list -g @xagent/
|
|
1023
|
+
npm list -g @xagent/one-shot
|
|
999
1024
|
|
|
1000
1025
|
# If installed but not in PATH, add npm global bin to PATH:
|
|
1001
1026
|
echo 'export PATH="$(npm config get prefix)/bin:$PATH"' >> ~/.zshrc
|
|
@@ -1009,7 +1034,7 @@ xcli --version
|
|
|
1009
1034
|
|
|
1010
1035
|
```bash
|
|
1011
1036
|
# Option 1: Use npx (no installation needed)
|
|
1012
|
-
npx @xagent/
|
|
1037
|
+
npx @xagent/one-shot@latest
|
|
1013
1038
|
|
|
1014
1039
|
# Option 2: Fix npm permissions (macOS/Linux)
|
|
1015
1040
|
sudo chown -R $(whoami) $(npm config get prefix)/{lib/node_modules,bin,share}
|
|
@@ -1026,8 +1051,8 @@ source ~/.zshrc
|
|
|
1026
1051
|
```bash
|
|
1027
1052
|
# Clear npm cache and reinstall
|
|
1028
1053
|
npm cache clean --force
|
|
1029
|
-
npm uninstall -g @xagent/
|
|
1030
|
-
npm install -g @xagent/
|
|
1054
|
+
npm uninstall -g @xagent/one-shot
|
|
1055
|
+
npm install -g @xagent/one-shot@latest
|
|
1031
1056
|
```
|
|
1032
1057
|
|
|
1033
1058
|
**🚨 Outdated version**
|
|
@@ -1035,10 +1060,10 @@ npm install -g @xagent/x-cli@latest
|
|
|
1035
1060
|
```bash
|
|
1036
1061
|
# Check current version
|
|
1037
1062
|
xcli --version
|
|
1038
|
-
npm view @xagent/
|
|
1063
|
+
npm view @xagent/one-shot version
|
|
1039
1064
|
|
|
1040
1065
|
# Update to latest
|
|
1041
|
-
npm update -g @xagent/
|
|
1066
|
+
npm update -g @xagent/one-shot@latest
|
|
1042
1067
|
```
|
|
1043
1068
|
|
|
1044
1069
|
### Tool Execution Errors
|
|
@@ -1095,7 +1120,7 @@ This project is built upon the excellent foundation of the original [X-CLI](http
|
|
|
1095
1120
|
|
|
1096
1121
|
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.
|
|
1097
1122
|
|
|
1098
|
-
**🚀 Now live on NPM**: Install globally with `npm install -g @xagent/
|
|
1123
|
+
**🚀 Now live on NPM**: Install globally with `npm install -g @xagent/one-shot` and start using `xcli` immediately!
|
|
1099
1124
|
|
|
1100
1125
|
## 👥 Contributors
|
|
1101
1126
|
|
package/dist/index.js
CHANGED
|
@@ -16196,8 +16196,8 @@ var init_package = __esm({
|
|
|
16196
16196
|
"package.json with { type: 'json' }"() {
|
|
16197
16197
|
package_default = {
|
|
16198
16198
|
type: "module",
|
|
16199
|
-
name: "@xagent/
|
|
16200
|
-
version: "1.1.
|
|
16199
|
+
name: "@xagent/one-shot",
|
|
16200
|
+
version: "1.1.89",
|
|
16201
16201
|
description: "An open-source AI agent that brings advanced AI capabilities directly into your terminal.",
|
|
16202
16202
|
main: "dist/index.js",
|
|
16203
16203
|
module: "dist/index.js",
|
|
@@ -21778,8 +21778,8 @@ var require_package = __commonJS({
|
|
|
21778
21778
|
"package.json"(exports, module) {
|
|
21779
21779
|
module.exports = {
|
|
21780
21780
|
type: "module",
|
|
21781
|
-
name: "@xagent/
|
|
21782
|
-
version: "1.1.
|
|
21781
|
+
name: "@xagent/one-shot",
|
|
21782
|
+
version: "1.1.89",
|
|
21783
21783
|
description: "An open-source AI agent that brings advanced AI capabilities directly into your terminal.",
|
|
21784
21784
|
main: "dist/index.js",
|
|
21785
21785
|
module: "dist/index.js",
|