@xerg/cli 0.1.7 → 0.1.8

package/README.md

@@ -1,8 +1,10 @@
 # xerg
 
-Audit OpenClaw agent spend, waste, and before/after improvements.
+Audit OpenClaw workflows in dollars, compare fixes, and surface savings opportunities.
 
-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.
+Xerg audits OpenClaw workflows in dollars, not tokens. It reads your gateway logs and session transcripts, surfaces five spend categories across confirmed waste and savings opportunities, and lets you re-run the same audit with `--compare` so you can see exactly what changed after a fix.
+
+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.
 
 ## 30-second quick start
 
@@ -140,7 +142,8 @@ Example `~/.xerg/config.json`:
 
 - Total spend by workflow and model, in dollars
 - Observed vs. estimated cost (always labeled)
-- Structural waste: retry, context bloat, loop, downgrade candidates, idle
+- Confirmed waste: retry, loop
+- Savings opportunities: context bloat, downgrade candidates, idle
 - Savings recommendations with suggested A/B tests
 - Before/after deltas on re-audit
 

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@xerg/cli",
-  "version": "0.1.7",
-  "description": "Audit OpenClaw agent spend, waste, and before/after improvements.",
+  "version": "0.1.8",
+  "description": "Audit OpenClaw workflows in dollars, compare fixes, and surface savings opportunities.",
   "keywords": ["ai", "agents", "finops", "llm", "openclaw", "cost", "cli"],
   "homepage": "https://xerg.ai",
   "repository": {

package/skills/xerg/SKILL.md

@@ -1,13 +1,23 @@
 ---
 name: xerg
-description: Audit OpenClaw agent spend in dollars. Use for local or remote audits, before/after comparisons, CI threshold gates, and machine-readable recommendations.
+description: Audit OpenClaw workflows in dollars. Local-first audits with compare mode, remote and Railway support, CI gates, and structured recommendations.
 ---
 
 # Xerg
 
 Use `xerg` if it is already installed. If not, use `npx @xerg/cli` with the same arguments.
 
-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.
+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`.
+
+Local audits need no account. No data leaves your machine unless you explicitly `--push` results to the Xerg API.
+
+## Quick Start
+
+```bash
+xerg doctor
+xerg audit
+xerg audit --compare
+```
 
 ## Inputs
 
@@ -180,6 +190,7 @@ Before finalizing work that used Xerg:
 - If `--compare` was used, confirm that it compared against a compatible stored snapshot
 - If no data was found, run `xerg doctor` or use explicit source flags rather than guessing
 - Say whether results were pushed to the Xerg API
+- Distinguish confirmed waste (`retry-waste`, `loop-waste`) from directional opportunities (`context-outlier`, `idle-spend`, `candidate-downgrade`)
 
 ## Notes