Loop detection and
model stop-loss for
paid AI agents.

# ~/.codex/config.toml

[mcp_servers.aibrake]
command = "npx"
args = [ "-y", "aibrake@beta", "mcp" ]

# Restart Codex CLI. `mcp__aibrake__aibrake_check` is now a tool
# the agent can call before paid LLM calls, deploys, retries.

// Claude Code — one CLI command (canonical, v2.x+):

claude mcp add aibrake -- npx -y aibrake@beta mcp

// Or edit ~/.claude.json directly (Cursor uses .cursor/mcp.json,
// Cline uses VS Code Settings → "cline.mcpSettings" — same JSON shape):

{
  "mcpServers": {
    "aibrake": {
      "command": "npx",
      "args": ["-y", "aibrake@beta", "mcp"]
    }
  }
}

// Restart the IDE. Tool appears as `mcp__aibrake__aibrake_check`.
// Verify in Claude Code:  /mcp     → aibrake / connected

# Tested live with Hermes Agent v0.15.1 — see docs/HERMES_LIVE_TEST.md.
# 1. Install the AIBrake skill (agentskills.io SKILL.md format).

hermes skills install \
  "https://raw.githubusercontent.com/Askbsman/aibrake/main/skills/aibrake/SKILL.md" \
  --category agent-safety --name aibrake --force --yes

# 2. Install the MCP server globally — `npx -y aibrake@beta` is too slow
# for Hermes' 40s connect-test, install once and point at the resolved binary.

npm install -g aibrake@beta

# 3. Register the MCP server in Hermes' config.yaml (NOT mcp.json):
# ~/.hermes/config.yaml

mcp_servers:
  aibrake:
    command: <path-to>\aibrake.cmd   # or `aibrake` on macOS/Linux
    args: ["mcp"]
    enabled: true

# 4. Windows only — installer puts config in %LOCALAPPDATA%\hermes
# but the CLI reads %USERPROFILE%\.hermes by default. Bridge them:

setx HERMES_HOME "%LOCALAPPDATA%\hermes"

# 5. Verify:
#   hermes mcp list     → aibrake / enabled
#   hermes skills list  → aibrake / enabled
# Full guide: docs/HERMES_INSTALL.md

// For Node.js apps that call openai / anthropic directly.
// One side-effect import patches every chat.completions.create
// and messages.create — shadow mode by default (decisions log to
// stderr, calls never block). Switch to enforcement with
// AIBRAKE_MODE=hard.

// 1. Install
// $ npm install aibrake

// 2. Add to your entrypoint (one line — must be first):
import "aibrake/auto";
import OpenAI from "openai";

const client = new OpenAI();
await client.chat.completions.create({
  model: "gpt-4o",
  messages: [ /* ... */ ],
});  // ← AIBrake watches every call automatically

// Fine-grained control? Same class, three import names (backward compat):
//   import { OpenClawAdapter, HermesAdapter, CodingAgentAdapter } from "aibrake";
// All three resolve to one adapter — pick whichever matches your runtime name.

// Python / Go / shell? Two HTTP options:
//   Free (Bearer auth):  POST https://api.aibrake.dev/v1/check
//                        Header: Authorization: Bearer asg_v1_yourkey
//   Paid x402 (no key):  POST https://api.aibrake.dev/x402/v1/check
//                        $0.005 / call via USDC on Base mainnet
// Schema: github.com/Askbsman/aibrake#schema