Skip to main content

Documentation Index

Fetch the complete documentation index at: https://xerg.ai/docs/llms.txt

Use this file to discover all available pages before exploring further.

Xerg audits OpenClaw and Hermes usage in dollars rather than tokens. It reads local gateway logs and session transcripts, normalizes runs locally, and surfaces where spend is leaking.
Local audits and --compare are free. Hosted pushes, Ask Xerg, and hosted MCP are optional paid workspace features.

​
What Xerg does

  • Guides first-time local setup with xerg init.
  • Audits local OpenClaw and Hermes activity from default paths or explicit files.
  • Compares the current audit with the newest compatible cached snapshot.
  • Audits OpenClaw SSH and Railway targets from your local machine.
  • Exports human-readable, Markdown, and machine-readable JSON output.
  • Connects to Xerg Cloud with xerg connect, pushes summaries when you choose, and can fail CI when confirmed waste is above a threshold.
  • Exposes hosted audit history, recommendations, and selected control actions through a hosted MCP server for paid workspaces.

​
What Xerg surfaces

Xerg splits findings into two buckets:
  • Confirmed waste: retry-waste and loop-waste
  • Savings opportunities: context-outlier, idle-spend, and candidate-downgrade
The opportunity classes are directional. They are worth testing, but they are not proven waste.

​
Default data sources

By default, Xerg looks for:
  • OpenClaw gateway logs at /tmp/openclaw/openclaw-*.log
  • OpenClaw session transcripts at ~/.openclaw/agents/*/sessions/*.jsonl
  • Hermes logs at ~/.hermes/logs/agent.log* with gateway.log* fallback
  • Hermes session transcripts at ~/.hermes/sessions/
If your data lives elsewhere, use --log-file and --sessions-dir.

​
Start here

  1. Install Xerg.
  2. Start with xerg init or run the quickstart.
  3. Keep the most useful commands nearby with the CLI cheat sheet.
  4. If the data lives elsewhere, start with doctor. Use remote audits for OpenClaw SSH and Railway targets.
  5. Learn the core model in waste taxonomy, metrics, and how it works.
  6. When you want hosted features, use connect and push and hosted MCP.
  7. When you want local automation, use CI gates.

​
Hosted and Pro features

If you use Xerg Pro or Enterprise, you can:
  • connect and push audit summaries into a hosted workspace with authentication and push
  • configure Cursor or Claude Code for hosted audit access with hosted MCP
  • use Ask Xerg in the dashboard after your workspace has hosted data

​
Important v0 limits

  • Cost per outcome is intentionally unavailable in v0.
  • Opportunity findings are recommendations to test, not proven waste.
  • Xerg stores economic metadata and audit summaries locally. It does not store prompt or response content.