Skip to main content

CLI hook for Claude Code and Cowork — automatic compliance monitoring for AI coding agents

Project description

AgentAudit Hook CLI

CLI for auditing Claude Code and Cowork sessions automatically.

Every tool call — file reads, writes, shell commands, web fetches — is logged, classified, and audit-ready with zero token overhead.

Install

pip install agentic-audit-hook

Setup

Add hooks to Claude Code:

// ~/.claude/settings.json
{
  "hooks": {
    "PreToolUse": [
      {
        "matcher": "",
        "hooks": [
          {"type": "command", "command": "agentaudit-hook pre"}
        ]
      }
    ],
    "PostToolUse": [
      {
        "matcher": "",
        "hooks": [
          {"type": "command", "command": "agentaudit-hook post"}
        ]
      }
    ]
  }
}

Set environment variables:

export AGENTAUDIT_API_KEY="aa_live_xxxxx"
export AGENTAUDIT_BASE_URL="http://localhost:8000"

Commands

Command Hook Description
agentaudit-hook pre PreToolUse Classify risk, optionally block
agentaudit-hook post PostToolUse Log completion
agentaudit-hook session-start SessionStart Log session start
agentaudit-hook session-end SessionEnd Log session end

Links

License

Apache 2.0

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

agentic_audit_hook-0.1.0.tar.gz (4.1 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

agentic_audit_hook-0.1.0-py3-none-any.whl (5.5 kB view details)

Uploaded Python 3

File details

Details for the file agentic_audit_hook-0.1.0.tar.gz.

File metadata

  • Download URL: agentic_audit_hook-0.1.0.tar.gz
  • Upload date:
  • Size: 4.1 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.10.9 {"installer":{"name":"uv","version":"0.10.9","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

File hashes

Hashes for agentic_audit_hook-0.1.0.tar.gz
Algorithm Hash digest
SHA256 1d8d355f7a82c86e45e4e9e1daafe79bc5401c4fb3bf4338ff67dd068bbf9c89
MD5 4b622bf9ed19ad127d6d3782294c4c3a
BLAKE2b-256 559a9c8a66eeb4fa1a93cd67ad4f9cc3824af2815c37172233f737d5acff4f27

See more details on using hashes here.

File details

Details for the file agentic_audit_hook-0.1.0-py3-none-any.whl.

File metadata

  • Download URL: agentic_audit_hook-0.1.0-py3-none-any.whl
  • Upload date:
  • Size: 5.5 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.10.9 {"installer":{"name":"uv","version":"0.10.9","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

File hashes

Hashes for agentic_audit_hook-0.1.0-py3-none-any.whl
Algorithm Hash digest
SHA256 bc051e6e247e39cdea71901f861e655305b737d6f1fc7bdab108ecc276c4d00d
MD5 f6a243ee463ccef707ba1069b54afab2
BLAKE2b-256 589bbff2456304d3445fdddcf9f3d5682e98c0f4753f975f3cb8899c391c2607

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page