@xerg/cli 0.1.10 → 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 +21 -12
- package/dist/index.js +2644 -578
- package/dist/index.js.map +1 -1
- package/package.json +15 -3
- package/skills/xerg/SKILL.md +16 -7
package/package.json
CHANGED
|
@@ -1,8 +1,20 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@xerg/cli",
|
|
3
|
-
"version": "0.
|
|
4
|
-
"description": "Audit OpenClaw workflows in dollars, compare fixes, and
|
|
5
|
-
"keywords": [
|
|
3
|
+
"version": "0.3.0",
|
|
4
|
+
"description": "Audit OpenClaw and Hermes workflows in dollars, compare fixes, and export daily spend and waste trends.",
|
|
5
|
+
"keywords": [
|
|
6
|
+
"xerg",
|
|
7
|
+
"ai",
|
|
8
|
+
"agents",
|
|
9
|
+
"finops",
|
|
10
|
+
"llm",
|
|
11
|
+
"openclaw",
|
|
12
|
+
"hermes",
|
|
13
|
+
"cost",
|
|
14
|
+
"cli",
|
|
15
|
+
"cursor",
|
|
16
|
+
"analytics"
|
|
17
|
+
],
|
|
6
18
|
"homepage": "https://xerg.ai",
|
|
7
19
|
"repository": {
|
|
8
20
|
"type": "git",
|
package/skills/xerg/SKILL.md
CHANGED
|
@@ -1,13 +1,13 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: xerg
|
|
3
|
-
description: Audit OpenClaw workflows in dollars. Local-first audits with compare mode, remote
|
|
3
|
+
description: Audit OpenClaw and Hermes workflows in dollars. Local-first audits with compare mode, OpenClaw remote 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 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`.
|
|
10
|
+
Xerg audits OpenClaw and Hermes 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
11
|
|
|
12
12
|
Local audits need no account. No data leaves your machine unless you explicitly `--push` results to the Xerg API.
|
|
13
13
|
|
|
@@ -27,6 +27,9 @@ Xerg needs one of these source inputs:
|
|
|
27
27
|
- Local OpenClaw data at the default paths:
|
|
28
28
|
- `/tmp/openclaw/openclaw-*.log`
|
|
29
29
|
- `~/.openclaw/agents/*/sessions/*.jsonl`
|
|
30
|
+
- Local Hermes data at the default paths:
|
|
31
|
+
- `~/.hermes/logs/agent.log*` with `gateway.log*` fallback
|
|
32
|
+
- `~/.hermes/sessions/`
|
|
30
33
|
- Explicit paths via `--log-file` and/or `--sessions-dir`
|
|
31
34
|
- An SSH target via `--remote`
|
|
32
35
|
- A Railway target via `--railway`
|
|
@@ -36,8 +39,8 @@ Additional requirements:
|
|
|
36
39
|
|
|
37
40
|
- `--compare` needs at least one previously stored compatible local snapshot
|
|
38
41
|
- Pushing needs auth via `XERG_API_KEY`, `~/.xerg/config.json`, or `xerg login`
|
|
39
|
-
- SSH audits require `ssh` and `rsync` on your local `PATH`
|
|
40
|
-
- Railway audits require the `railway` CLI on your local `PATH`
|
|
42
|
+
- SSH audits require `ssh` and `rsync` on your local `PATH` and are OpenClaw-only in this phase
|
|
43
|
+
- Railway audits require the `railway` CLI on your local `PATH` and are OpenClaw-only in this phase
|
|
41
44
|
|
|
42
45
|
## Default Flow
|
|
43
46
|
|
|
@@ -57,6 +60,8 @@ xerg doctor --railway
|
|
|
57
60
|
|
|
58
61
|
```bash
|
|
59
62
|
xerg audit
|
|
63
|
+
xerg audit --runtime openclaw
|
|
64
|
+
xerg audit --runtime hermes
|
|
60
65
|
```
|
|
61
66
|
|
|
62
67
|
3. Choose the right output mode for the task:
|
|
@@ -94,11 +99,15 @@ Local defaults:
|
|
|
94
99
|
xerg audit
|
|
95
100
|
```
|
|
96
101
|
|
|
102
|
+
If both OpenClaw and Hermes are present locally, pass `--runtime openclaw` or `--runtime hermes` explicitly.
|
|
103
|
+
|
|
97
104
|
Explicit local paths:
|
|
98
105
|
|
|
99
106
|
```bash
|
|
100
|
-
xerg audit --log-file /path/to/openclaw.log
|
|
101
|
-
xerg audit --sessions-dir /path/to/sessions
|
|
107
|
+
xerg audit --runtime openclaw --log-file /path/to/openclaw.log
|
|
108
|
+
xerg audit --runtime openclaw --sessions-dir /path/to/sessions
|
|
109
|
+
xerg audit --runtime hermes --log-file ~/.hermes/logs/agent.log
|
|
110
|
+
xerg audit --runtime hermes --sessions-dir ~/.hermes/sessions
|
|
102
111
|
```
|
|
103
112
|
|
|
104
113
|
SSH remote:
|
|
@@ -166,7 +175,7 @@ Documented exit codes:
|
|
|
166
175
|
|
|
167
176
|
- `0` success
|
|
168
177
|
- `1` runtime error
|
|
169
|
-
- `2` no
|
|
178
|
+
- `2` no supported local runtime data found
|
|
170
179
|
- `3` threshold exceeded
|
|
171
180
|
|
|
172
181
|
Automation can branch on those codes instead of scraping terminal output.
|