Skip to main content
Xerg has one canonical skill file and one hosted MCP endpoint. Client-specific differences are setup details, not separate skill files.

Public agent surfaces

  • https://xerg.ai/skill.md is the canonical public SKILL.md mirror.
  • https://xerg.ai/llms.txt is the short machine-readable site map.
  • https://xerg.ai/llms-full.txt is the longer agent reference.
  • @xerg/cli is the public npm CLI package.
  • @xerg/schemas is the MIT-licensed public wire-contract package.

Codex

Use SKILL.md for repeatable local audit workflows and hosted MCP for workspace data. For local skill use, copy or link the bundled skill directory into a Codex skill search path:
node_modules/@xerg/cli/skills/xerg
For user-wide Codex installs, use:
~/.agents/skills/xerg
For repo-scoped Codex installs, use:
.agents/skills/xerg
Codex hosted MCP config in ~/.codex/config.toml:
[mcp_servers.xerg]
url = "https://mcp.xerg.ai/mcp"
bearer_token_env_var = "XERG_API_KEY"
Set XERG_API_KEY to a workspace API key before starting Codex.

Cursor

Run the guided setup:
npx @xerg/cli mcp-setup
For project config, use Cursor’s remote MCP shape with the Xerg hosted endpoint and a Bearer token:
{
  "mcpServers": {
    "xerg": {
      "type": "http",
      "url": "https://mcp.xerg.ai/mcp",
      "headers": {
        "Authorization": "Bearer <XERG_API_KEY>"
      }
    }
  }
}

Claude Code and Claude Desktop

Use the standard remote MCP JSON shape:
{
  "mcpServers": {
    "xerg": {
      "type": "http",
      "url": "https://mcp.xerg.ai/mcp",
      "headers": {
        "Authorization": "Bearer <XERG_API_KEY>"
      }
    }
  }
}

Antigravity

Use the generic streamable HTTP MCP settings if your Antigravity install supports remote MCP servers with Bearer headers. Xerg does not publish Antigravity-specific setup steps yet because the product-specific import/config format still needs to be verified against official Antigravity documentation.

Generic MCP

Use this server endpoint:
https://mcp.xerg.ai/mcp
Use this auth header:
Authorization: Bearer <XERG_API_KEY>
Metadata endpoint:
https://mcp.xerg.ai/server.json

Local CLI for agents

Agents can run local audits without hosted auth:
npx @xerg/cli audit --json
npx @xerg/cli audit --compare
npx @xerg/cli audit --fail-above-waste-rate 0.30
Hosted push and hosted MCP require an active workspace API key.