@xerg/cli 0.2.0 → 0.3.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/README.md +18 -10
- package/dist/index.js +1328 -531
- package/dist/index.js.map +1 -1
- package/package.json +15 -3
- package/skills/xerg/SKILL.md +16 -7
package/README.md
CHANGED
|
@@ -1,8 +1,8 @@
|
|
|
1
1
|
# xerg
|
|
2
2
|
|
|
3
|
-
Audit OpenClaw workflows in dollars, compare fixes, and export daily spend and waste trends.
|
|
3
|
+
Audit OpenClaw and Hermes workflows in dollars, compare fixes, and export daily spend and waste trends.
|
|
4
4
|
|
|
5
|
-
Xerg audits OpenClaw workflows in dollars, not tokens. It reads
|
|
5
|
+
Xerg audits OpenClaw and Hermes workflows in dollars, not tokens. It reads local gateway logs and session transcripts, surfaces daily spend and waste rollups plus the highest-leverage findings, and lets you re-run the same audit with `--compare` so you can see exactly what changed after a fix.
|
|
6
6
|
|
|
7
7
|
Everything runs locally by default. No account is required for local audits. No data leaves your machine unless you explicitly `--push` results to the Xerg API for a team dashboard.
|
|
8
8
|
|
|
@@ -89,10 +89,10 @@ xerg audit --compare
|
|
|
89
89
|
xerg audit --since 24h --compare
|
|
90
90
|
```
|
|
91
91
|
|
|
92
|
-
## Works where your
|
|
92
|
+
## Works where your agent data lives
|
|
93
93
|
|
|
94
94
|
- Local machine: yes
|
|
95
|
-
- VPS or remote server:
|
|
95
|
+
- VPS or remote server: OpenClaw only in this phase
|
|
96
96
|
- If OpenClaw runs remotely, you can audit it from your local machine with `xerg audit --remote user@host`
|
|
97
97
|
- Or point Xerg at exported files directly with flags
|
|
98
98
|
|
|
@@ -105,23 +105,31 @@ Remote prerequisites:
|
|
|
105
105
|
|
|
106
106
|
By default, Xerg checks:
|
|
107
107
|
|
|
108
|
-
- `/tmp/openclaw/openclaw-*.log`
|
|
109
|
-
- `~/.openclaw/agents/*/sessions/*.jsonl`
|
|
108
|
+
- OpenClaw: `/tmp/openclaw/openclaw-*.log`
|
|
109
|
+
- OpenClaw: `~/.openclaw/agents/*/sessions/*.jsonl`
|
|
110
|
+
- Hermes: `~/.hermes/logs/agent.log*` with `gateway.log*` fallback
|
|
111
|
+
- Hermes: `~/.hermes/sessions/`
|
|
110
112
|
|
|
111
113
|
Use explicit paths when needed:
|
|
112
114
|
|
|
113
115
|
```bash
|
|
114
|
-
xerg audit --log-file /path/to/openclaw.log
|
|
115
|
-
xerg audit --sessions-dir /path/to/sessions
|
|
116
|
+
xerg audit --runtime openclaw --log-file /path/to/openclaw.log
|
|
117
|
+
xerg audit --runtime openclaw --sessions-dir /path/to/sessions
|
|
118
|
+
xerg audit --runtime hermes --log-file ~/.hermes/logs/agent.log
|
|
119
|
+
xerg audit --runtime hermes --sessions-dir ~/.hermes/sessions
|
|
116
120
|
```
|
|
117
121
|
|
|
118
|
-
If
|
|
122
|
+
If only one supported local runtime is present, Xerg auto-selects it. If both OpenClaw and Hermes are present locally, rerun with `--runtime openclaw` or `--runtime hermes`.
|
|
123
|
+
|
|
124
|
+
If your local machine has no OpenClaw or Hermes files, inspect remote targets directly instead:
|
|
119
125
|
|
|
120
126
|
```bash
|
|
121
127
|
xerg doctor --remote user@host
|
|
122
128
|
xerg doctor --railway
|
|
123
129
|
```
|
|
124
130
|
|
|
131
|
+
Remote SSH and Railway flows are still OpenClaw-only.
|
|
132
|
+
|
|
125
133
|
## Authentication and config
|
|
126
134
|
|
|
127
135
|
Push commands resolve credentials in this order:
|
|
@@ -164,7 +172,7 @@ Xerg v0 stores economic metadata and audit summaries locally. It does not store
|
|
|
164
172
|
|
|
165
173
|
- `0`: success
|
|
166
174
|
- `1`: general failure
|
|
167
|
-
- `2`: no
|
|
175
|
+
- `2`: no supported local runtime data was found
|
|
168
176
|
- `3`: a `--fail-above-waste-rate` or `--fail-above-waste-usd` threshold was exceeded
|
|
169
177
|
|
|
170
178
|
## Troubleshooting
|