@xerg/cli 0.1.2 → 0.1.4
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 +59 -29
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -1,73 +1,103 @@
|
|
|
1
1
|
# xerg
|
|
2
2
|
|
|
3
|
-
|
|
3
|
+
Audit OpenClaw agent spend, waste, and before/after improvements.
|
|
4
4
|
|
|
5
|
-
|
|
6
|
-
where money is leaking, and lets you re-run the same audit with `--compare` so
|
|
7
|
-
you can see what changed after a fix.
|
|
5
|
+
Xerg audits OpenClaw workflows in dollars, not tokens. It reads your gateway logs and session transcripts, shows where money is leaking, classifies waste into five categories, and lets you re-run the same audit with `--compare` so you can see what changed after a fix.
|
|
8
6
|
|
|
9
|
-
##
|
|
7
|
+
## 30-second quick start
|
|
10
8
|
|
|
11
9
|
```bash
|
|
12
|
-
|
|
10
|
+
npx @xerg/cli doctor
|
|
11
|
+
npx @xerg/cli audit
|
|
12
|
+
npx @xerg/cli audit --compare
|
|
13
13
|
```
|
|
14
14
|
|
|
15
|
-
|
|
15
|
+
Prefer a global install?
|
|
16
16
|
|
|
17
17
|
```bash
|
|
18
|
-
|
|
18
|
+
npm install -g @xerg/cli
|
|
19
|
+
xerg doctor
|
|
20
|
+
xerg audit
|
|
19
21
|
```
|
|
20
22
|
|
|
21
|
-
|
|
23
|
+
## Sample output
|
|
22
24
|
|
|
23
|
-
```
|
|
24
|
-
|
|
25
|
+
```text
|
|
26
|
+
Total spend: $148.00
|
|
27
|
+
Observed spend: $105.00
|
|
28
|
+
Estimated spend: $43.00
|
|
29
|
+
|
|
30
|
+
Waste taxonomy
|
|
31
|
+
- Retry waste: $12.40
|
|
32
|
+
- Context bloat: $18.90
|
|
33
|
+
- Loop waste: $7.10
|
|
34
|
+
- Downgrade candidates: $4.80
|
|
35
|
+
- Idle waste: $3.37
|
|
36
|
+
|
|
37
|
+
First savings test
|
|
38
|
+
- Move heartbeat_monitor from Claude Opus to Sonnet
|
|
25
39
|
```
|
|
26
40
|
|
|
27
41
|
## Commands
|
|
28
42
|
|
|
29
|
-
Inspect local audit readiness:
|
|
43
|
+
- Inspect local audit readiness:
|
|
30
44
|
|
|
31
45
|
```bash
|
|
32
46
|
xerg doctor
|
|
33
47
|
```
|
|
34
48
|
|
|
35
|
-
Run the first audit:
|
|
49
|
+
- Run the first audit:
|
|
36
50
|
|
|
37
51
|
```bash
|
|
38
52
|
xerg audit
|
|
39
53
|
```
|
|
40
54
|
|
|
41
|
-
Compare the latest run against the newest compatible prior local snapshot:
|
|
55
|
+
- Compare the latest run against the newest compatible prior local snapshot:
|
|
42
56
|
|
|
43
57
|
```bash
|
|
44
58
|
xerg audit --compare
|
|
45
59
|
```
|
|
46
60
|
|
|
47
|
-
Audit a specific window:
|
|
61
|
+
- Audit a specific window:
|
|
48
62
|
|
|
49
63
|
```bash
|
|
50
64
|
xerg audit --since 24h --compare
|
|
51
65
|
```
|
|
52
66
|
|
|
53
|
-
##
|
|
67
|
+
## Works where your OpenClaw logs live
|
|
54
68
|
|
|
55
|
-
-
|
|
56
|
-
-
|
|
57
|
-
-
|
|
58
|
-
-
|
|
59
|
-
- directional savings opportunities
|
|
60
|
-
- before/after re-audit deltas
|
|
69
|
+
- Local machine: yes
|
|
70
|
+
- VPS or remote server: yes
|
|
71
|
+
- If OpenClaw runs remotely, SSH into the machine where the logs live and run Xerg there
|
|
72
|
+
- Or point Xerg at exported files directly with flags
|
|
61
73
|
|
|
62
|
-
##
|
|
74
|
+
## Default paths
|
|
75
|
+
|
|
76
|
+
By default, Xerg checks:
|
|
77
|
+
|
|
78
|
+
- `/tmp/openclaw/openclaw-*.log`
|
|
79
|
+
- `~/.openclaw/agents/*/sessions/*.jsonl`
|
|
63
80
|
|
|
64
|
-
|
|
65
|
-
prompt or response content.
|
|
81
|
+
Use explicit paths when needed:
|
|
66
82
|
|
|
67
|
-
|
|
83
|
+
```bash
|
|
84
|
+
xerg audit --log-file /path/to/openclaw.log
|
|
85
|
+
xerg audit --sessions-dir /path/to/sessions
|
|
86
|
+
```
|
|
87
|
+
|
|
88
|
+
## What the audit shows
|
|
89
|
+
|
|
90
|
+
- Total spend by workflow and model, in dollars
|
|
91
|
+
- Observed vs. estimated cost (always labeled)
|
|
92
|
+
- Structural waste: retry, context bloat, loop, downgrade candidates, idle
|
|
93
|
+
- Savings recommendations with suggested A/B tests
|
|
94
|
+
- Before/after deltas on re-audit
|
|
95
|
+
|
|
96
|
+
## Privacy
|
|
68
97
|
|
|
69
|
-
|
|
98
|
+
Xerg v0 stores economic metadata and audit summaries locally. It does not store prompt or response content.
|
|
70
99
|
|
|
71
|
-
##
|
|
100
|
+
## Pilot and support
|
|
72
101
|
|
|
73
|
-
[xerg.ai](https://xerg.ai)
|
|
102
|
+
- Pilot: [xerg.ai/pilot](https://xerg.ai/pilot)
|
|
103
|
+
- Support: `query@xerg.ai`
|
package/package.json
CHANGED