@xerg/cli 0.5.0 → 0.5.1

package/README.md

@@ -4,6 +4,8 @@ Audit OpenClaw and Hermes workflows in dollars, compare fixes, and optionally co
 
 Xerg runs locally by default. Local audits and `--compare` are free. No account is required for local value, and no data leaves your machine unless you explicitly push results to Xerg Cloud.
 
+The `npx @xerg/cli` path fetches and executes the published npm package before running Xerg. If you want to avoid a runtime fetch, install once with `npm install -g @xerg/cli` or run a local build from source.
+
 ## Fastest first run
 
 ```bash
@@ -54,6 +56,8 @@ node_modules/@xerg/cli/skills/xerg/SKILL.md
 
 For a global install, the same file lives inside the global npm package directory instead. That file is a packaged copy of the canonical repo skill at [`skills/xerg/SKILL.md`](../../skills/xerg/SKILL.md). Use it if your agent platform imports skills from disk; installing the npm package does not automatically register the skill with every agent product.
 
+The bundled skill frontmatter declares the CLI/package surface plus optional Xerg Cloud, SSH, rsync, and Railway requirements so registries can distinguish the default local audit workflow from opt-in hosted sync and remote audit workflows.
+
 ## Supported runtime
 
 `@xerg/cli` supports Node `22` and `24`.
@@ -152,7 +156,7 @@ xerg mcp-setup
 ```
 
 - `connect` resolves auth from `XERG_API_KEY`, `~/.xerg/config.json`, or stored browser credentials, then offers to push the latest audit
-- `mcp-setup` prints or writes hosted MCP config for Cursor, Claude Code, or another client
+- `mcp-setup` prints or writes hosted MCP config for Cursor, Claude Code, Codex, or another client
 
 You can skip both and keep using local audits and compare.
 

package/dist/index.js

@@ -5989,6 +5989,7 @@ function renderRailwayDoctorReport(report) {
 import { existsSync as existsSync2, mkdirSync as mkdirSync6, readFileSync as readFileSync9, writeFileSync as writeFileSync2 } from "fs";
 import { dirname as dirname3, join as join8 } from "path";
 var HOSTED_MCP_URL = "https://mcp.xerg.ai/mcp";
+var MCP_SERVER_NAME = "xerg";
 async function runMcpSetupCommand() {
   await runMcpSetupFlow();
 }
@@ -6031,6 +6032,11 @@ async function runMcpSetupFlow() {
       value: "claude-code",
       description: "Project-scoped Claude Code MCP config"
     },
+    {
+      name: "Codex",
+      value: "codex",
+      description: "Codex config.toml snippet"
+    },
     {
       name: "Other",
       value: "other",
@@ -6042,6 +6048,14 @@ async function runMcpSetupFlow() {
     await handleCursorSetup(snippet, config);
     return;
   }
+  if (client === "codex") {
+    process.stdout.write(`${buildCodexMcpConfig(config)}
+`);
+    process.stderr.write(
+      "Add this to `~/.codex/config.toml`, then restart Codex so it loads the Xerg MCP tools.\n"
+    );
+    return;
+  }
   process.stdout.write(`${snippet}
 `);
   if (client === "claude-code") {
@@ -6079,7 +6093,7 @@ async function handleCursorSetup(snippet, config) {
 function buildHostedMcpConfig(config) {
   return {
     mcpServers: {
-      xerg: {
+      [MCP_SERVER_NAME]: {
         type: "http",
         url: HOSTED_MCP_URL,
         headers: {
@@ -6089,6 +6103,19 @@ function buildHostedMcpConfig(config) {
     }
   };
 }
+function buildCodexMcpConfig(config) {
+  return [
+    `[mcp_servers.${MCP_SERVER_NAME}]`,
+    "enabled = true",
+    `url = ${tomlString(HOSTED_MCP_URL)}`,
+    "",
+    `[mcp_servers.${MCP_SERVER_NAME}.http_headers]`,
+    `Authorization = ${tomlString(`Bearer ${config.apiKey}`)}`
+  ].join("\n");
+}
+function tomlString(value) {
+  return JSON.stringify(value);
+}
 function writeCursorConfig(filePath, config) {
   mkdirSync6(dirname3(filePath), { recursive: true });
   let parsed = {};
@@ -6425,7 +6452,7 @@ Notes:
 function renderMcpSetupHelp(commandPrefix) {
   return `${formatCommand("mcp-setup", commandPrefix)}
 
-Generate hosted MCP client configuration for Cursor, Claude Code, or another MCP client.
+Generate hosted MCP client configuration for Cursor, Claude Code, Codex, or another MCP client.
 
 Usage:
   ${formatCommand("mcp-setup", commandPrefix)}
@@ -6434,6 +6461,7 @@ Notes:
   - Interactive in v1 because client selection is prompt-driven
   - Uses the hosted MCP endpoint at https://mcp.xerg.ai/mcp
   - Can write a project-scoped Cursor config when .cursor/ already exists
+  - Prints a Codex config.toml snippet when Codex is selected
   - Local audits and compare stay available even if you skip hosted MCP setup
 
   -h, --help                  Show help