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.

Supported Node runtime

@xerg/cli supports Node 22 and 24.

Supported data sources

  • local OpenClaw logs and session transcripts
  • local Hermes logs and session transcripts
  • local Cursor usage CSV exports
  • OpenClaw SSH, Railway, and multi-source remote audits in this phase

Run without a global install

npx @xerg/cli init
Direct commands remain available when you want explicit control:
npx @xerg/cli doctor
npx @xerg/cli audit

Install globally

npm install -g @xerg/cli
xerg init

Native dependency note

@xerg/cli depends on better-sqlite3 for local snapshot storage. If install fails:
  • make sure you are on Node 22 or 24
  • retry after installing normal native build tooling for your platform
  • run npx @xerg/cli init once the install succeeds to confirm the package is working

First-run defaults

xerg init is the default first-run path in v1. It is interactive and best when you want the fastest local result. Use direct doctor / audit commands when:
  • you need non-interactive behavior
  • you want JSON or Markdown output immediately
  • you want to script specific runtime or path flags
  • you want remote OpenClaw audits directly

Develop from this repo

If you are working from the Xerg repo itself:
nvm use
corepack prepare [email protected] --activate
pnpm install
pnpm lint
pnpm test
pnpm build
This repo pins the default development and release toolchain to Node 24.14.0 in .nvmrc.