@xerg/cli 0.1.7 → 0.1.9

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/package.json CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "@xerg/cli",
3
- "version": "0.1.7",
4
- "description": "Audit OpenClaw agent spend, waste, and before/after improvements.",
3
+ "version": "0.1.9",
4
+ "description": "Audit OpenClaw workflows in dollars, compare fixes, and surface savings opportunities.",
5
5
  "keywords": ["ai", "agents", "finops", "llm", "openclaw", "cost", "cli"],
6
6
  "homepage": "https://xerg.ai",
7
7
  "repository": {
@@ -1,13 +1,24 @@
1
1
  ---
2
2
  name: xerg
3
- description: Audit OpenClaw agent spend in dollars. Use for local or remote audits, before/after comparisons, CI threshold gates, and machine-readable recommendations.
3
+ description: Audit OpenClaw workflows in dollars. Local-first audits with compare mode, remote and Railway support, CI gates, and structured recommendations.
4
4
  ---
5
5
 
6
6
  # Xerg
7
7
 
8
8
  Use `xerg` if it is already installed. If not, use `npx @xerg/cli` with the same arguments.
9
9
 
10
- Xerg audits OpenClaw spend in dollars and surfaces both confirmed waste and savings opportunities. It can analyze local files, pull remote sources over SSH or Railway, compare against prior local snapshots, and optionally push audit summaries to the Xerg API.
10
+ Xerg audits OpenClaw workflows in dollars, not tokens. It reads gateway logs and session transcripts, surfaces five spend categories across confirmed waste and savings opportunities, and helps you measure fixes with `--compare`.
11
+
12
+ Local audits need no account. No data leaves your machine unless you explicitly `--push` results to the Xerg API.
13
+
14
+ ## Quick Start
15
+
16
+ ```bash
17
+ xerg doctor
18
+ xerg doctor --verbose
19
+ xerg audit
20
+ xerg audit --compare
21
+ ```
11
22
 
12
23
  ## Inputs
13
24
 
@@ -34,10 +45,14 @@ Additional requirements:
34
45
 
35
46
  ```bash
36
47
  xerg doctor
48
+ xerg doctor --verbose
37
49
  xerg doctor --remote user@host
38
50
  xerg doctor --railway
39
51
  ```
40
52
 
53
+ - `xerg doctor --verbose` shows progress on stderr while Xerg checks local paths or remote transports
54
+ - If local defaults are empty, prefer `xerg doctor --remote ...` or `xerg doctor --railway` instead of guessing paths
55
+
41
56
  2. Run a baseline audit:
42
57
 
43
58
  ```bash
@@ -180,6 +195,7 @@ Before finalizing work that used Xerg:
180
195
  - If `--compare` was used, confirm that it compared against a compatible stored snapshot
181
196
  - If no data was found, run `xerg doctor` or use explicit source flags rather than guessing
182
197
  - Say whether results were pushed to the Xerg API
198
+ - Distinguish confirmed waste (`retry-waste`, `loop-waste`) from directional opportunities (`context-outlier`, `idle-spend`, `candidate-downgrade`)
183
199
 
184
200
  ## Notes
185
201