# Amp Hooks

Akto Guardrails for Amp provides security validation for AI coding agent interactions. It intercepts tool executions before and after they run, validates against security policies, blocks risky behavior, and reports events to your Akto dashboard.

## Key Features

* ✅ **Zero Installation** - No standalone apps to install
* ✅ **Transparent Integration** - Uses Amp's native hook mechanism
* ✅ **Real-time Tool Blocking** - Can block dangerous tool executions before they run
* ✅ **Centralized Monitoring** - All events reported to Akto dashboard
* ✅ **Flexible Deployment** - Supports Argus and Atlas modes

## How It Works

Amp's hook system triggers policy checks at two critical points in every tool execution:

```mermaid
sequenceDiagram
    autonumber
    participant User
    participant PreToolHook as tool:pre-execute Hook
    participant Amp as Amp Tool Execution
    participant PostToolHook as tool:post-execute Hook
    participant Akto as Akto Dashboard

    User->>PreToolHook: Amp requests tool execution
    Note over PreToolHook: Validate tool use against policies
    alt Safe Tool Use
        PreToolHook->>Amp: Allow tool execution
        PreToolHook-->>Akto: Report event
    else Policy Violation
        PreToolHook-->>User: Block tool execution
        PreToolHook-->>Akto: Report security event
    end

    Amp->>PostToolHook: Tool execution completes
    Note over PostToolHook: Ingest tool result for analytics
    PostToolHook-->>Akto: Report event
    PostToolHook->>User: Result returned
```

**2 Hook Points:**

1. `tool:pre-execute` — Validates tool use before execution and **can block** dangerous operations
2. `tool:post-execute` — Ingests tool execution results for monitoring and audit

## Setup Guide

### Prerequisites

* Amp CLI installed and authenticated — run `amp --version` to verify
* macOS or Linux with bash/zsh

### Installation Steps

{% stepper %}
{% step %}
**Get the Akto Hook Configuration**

{% hint style="info" %}
Contact <support@akto.io> to get the Akto guardrail hook configuration for Amp. Akto provides a policy-based `amp.hooks` configuration tailored to your security requirements.
{% endhint %}
{% endstep %}

{% step %}
**Configure Hooks in settings.json**

Add the Akto-provided hook configuration to `~/.config/amp/settings.json`:

```json
{
  "amp.hooks": [
    {
      "compatibilityDate": "2025-05-14",
      "id": "akto-pre-tool-validation",
      "on": {
        "event": "tool:pre-execute",
        "tool": ["<tool_name>"],
        "input.contains": "..."
      },
      "action": {
        ...
      }
    },
    {
      "compatibilityDate": "2025-05-14",
      "id": "akto-post-tool-ingestion",
      "on": {
        "event": "tool:post-execute",
        "tool": ["<tool_name>"]
      },
      "action": {
        ...
      }
    }
  ]
}
```

{% endstep %}
{% endstepper %}

Once configured, Akto Guardrails will automatically run its checks on every tool execution. Any malicious or policy-violating events will appear in the **Guardrail Activity** section of your Akto dashboard.

## Resources

* **Amp Manual — Hooks**: <https://ampcode.com/manual>
* **GitHub**: <https://github.com/akto-api-security/akto>
* **Support**: <support@akto.io>
* **Community**: <https://www.akto.io/community>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://ai-security-docs.akto.io/akto-atlas-agentic-ai-security-for-employee-endpoints/endpoints-discovery-agents/amp-hooks.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.