@xerg/cli 0.4.0 → 0.5.1
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 +15 -5
- package/dist/index.js +325 -131
- package/dist/index.js.map +1 -1
- package/package.json +1 -1
- package/skills/xerg/SKILL.md +64 -9
package/README.md
CHANGED
|
@@ -4,10 +4,12 @@ Audit OpenClaw and Hermes workflows in dollars, compare fixes, and optionally co
|
|
|
4
4
|
|
|
5
5
|
Xerg runs locally by default. Local audits and `--compare` are free. No account is required for local value, and no data leaves your machine unless you explicitly push results to Xerg Cloud.
|
|
6
6
|
|
|
7
|
+
The `npx @xerg/cli` path fetches and executes the published npm package before running Xerg. If you want to avoid a runtime fetch, install once with `npm install -g @xerg/cli` or run a local build from source.
|
|
8
|
+
|
|
7
9
|
## Fastest first run
|
|
8
10
|
|
|
9
11
|
```bash
|
|
10
|
-
npx @xerg/cli
|
|
12
|
+
npx @xerg/cli init
|
|
11
13
|
```
|
|
12
14
|
|
|
13
15
|
`init` is the default first-run path. It:
|
|
@@ -54,6 +56,8 @@ node_modules/@xerg/cli/skills/xerg/SKILL.md
|
|
|
54
56
|
|
|
55
57
|
For a global install, the same file lives inside the global npm package directory instead. That file is a packaged copy of the canonical repo skill at [`skills/xerg/SKILL.md`](../../skills/xerg/SKILL.md). Use it if your agent platform imports skills from disk; installing the npm package does not automatically register the skill with every agent product.
|
|
56
58
|
|
|
59
|
+
The bundled skill frontmatter declares the CLI/package surface plus optional Xerg Cloud, SSH, rsync, and Railway requirements so registries can distinguish the default local audit workflow from opt-in hosted sync and remote audit workflows.
|
|
60
|
+
|
|
57
61
|
## Supported runtime
|
|
58
62
|
|
|
59
63
|
`@xerg/cli` supports Node `22` and `24`.
|
|
@@ -74,8 +78,14 @@ Waste taxonomy
|
|
|
74
78
|
- Downgrade candidates: $4.80
|
|
75
79
|
- Idle waste: $3.37
|
|
76
80
|
|
|
77
|
-
|
|
78
|
-
|
|
81
|
+
Action queue
|
|
82
|
+
Fix now
|
|
83
|
+
- Reduce retry waste in workspace: $12.40 (high)
|
|
84
|
+
Test next
|
|
85
|
+
- Evaluate a cheaper model for heartbeat_monitor: $4.80 (low)
|
|
86
|
+
Watch
|
|
87
|
+
- none
|
|
88
|
+
How to validate: `xerg audit --compare --push`
|
|
79
89
|
```
|
|
80
90
|
|
|
81
91
|
## Common commands
|
|
@@ -146,7 +156,7 @@ xerg mcp-setup
|
|
|
146
156
|
```
|
|
147
157
|
|
|
148
158
|
- `connect` resolves auth from `XERG_API_KEY`, `~/.xerg/config.json`, or stored browser credentials, then offers to push the latest audit
|
|
149
|
-
- `mcp-setup` prints or writes hosted MCP config for Cursor, Claude Code, or another client
|
|
159
|
+
- `mcp-setup` prints or writes hosted MCP config for Cursor, Claude Code, Codex, or another client
|
|
150
160
|
|
|
151
161
|
You can skip both and keep using local audits and compare.
|
|
152
162
|
|
|
@@ -183,7 +193,7 @@ Example `~/.xerg/config.json`:
|
|
|
183
193
|
- Observed vs. estimated cost (always labeled)
|
|
184
194
|
- Confirmed waste: retry, loop, cache carryover where applicable
|
|
185
195
|
- Savings opportunities: context bloat, downgrade candidates, idle, max mode concentration where applicable
|
|
186
|
-
-
|
|
196
|
+
- Ranked recommendations with where-to-change guidance and compare validation steps
|
|
187
197
|
- Before/after deltas on re-audit
|
|
188
198
|
|
|
189
199
|
## Privacy
|