@agentegrity/claude-sdk

Zero-config agentegrity adapter for the Claude Agent SDK (@anthropic-ai/claude-agent-sdk). Mirrors the Python agentegrity.claude module 1:1.

Install

npm i @agentegrity/claude-sdk @anthropic-ai/claude-agent-sdk
# or: bun add @agentegrity/claude-sdk @anthropic-ai/claude-agent-sdk

Use

import { ClaudeSDKClient } from "@anthropic-ai/claude-agent-sdk";
import { hooks, report } from "@agentegrity/claude-sdk";

const client = new ClaudeSDKClient({ hooks: hooks() });
// ... run your agent ...
console.log(await report());

That's the full integration — three lines.

Config

Override the default profile:

const h = hooks({ profile: { name: "my-agent", risk_tier: "high" } });

Environment variables:

| Var | Default | What | |---|---|---| | AGENTEGRITY_URL | http://localhost:8787 | Exporter backend URL | | AGENTEGRITY_TOKEN | (none) | Bearer token | | AGENTEGRITY_DISABLED | (unset) | Set to 1 to no-op every hook |

API

| Function | Returns | |---|---| | hooks(options?) | Hook object for ClaudeSDKClient({ hooks }) | | report() | Session summary snapshot | | reset() | Discard the module-global adapter | | registerExporter(exporter) | Subscribe an additional SessionExporter | | adapter() | Escape hatch — returns the underlying DefaultAdapter |

License

Apache-2.0