Skip to main content

Hooks Installer

The AgentWarden hooks installer configures supported coding-agent runtimes to emit runtime events to AgentWarden.

Use the hooks installer when a supported coding-agent runtime owns the agent loop and emits hook events for prompts, tools, and responses.

AgentWarden hooks are currently used for supported coding-agent runtimes such as Cursor, Claude Code, and Codex. Contact the Dynamo AI support team for current runtime support.

Access and Setup​

Contact the Dynamo AI support team for the AgentWarden hooks installer package.

Install with an AgentWarden server URL and a runtime API key:

agentwarden-hooks-installer install \
  --url <agentwarden-server-url> \
  --api-key <runtime-api-key>

The runtime API key should be associated with the use case whose policy should be enforced.

What the Installer Does​

At a high level, the installer:

  1. verifies the AgentWarden server URL and runtime API key,
  2. detects supported coding-agent runtimes on the machine,
  3. configures those runtimes to emit AgentWarden events,
  4. verifies that events can be evaluated by AgentWarden.

After installation, supported runtimes send normalized events to AgentWarden at runtime boundaries such as prompt input, tool request, tool output, and final response.

How Enforcement Works​

The hook integration:

  1. receives a native runtime event,
  2. maps it to a normalized AgentWarden event,
  3. sends the event to AgentWarden for policy evaluation,
  4. applies the returned decision inside the runtime.

The SDK and hooks installer use the same policy model. Hooks simply emit events from a runtime the developer does not fully control.