Skip to main content

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

Project description

AgenticAudit 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.3.0.tar.gz (5.5 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.3.0-py3-none-any.whl (7.0 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: agentic_audit_hook-0.3.0.tar.gz
  • Upload date:
  • Size: 5.5 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.11.1 {"installer":{"name":"uv","version":"0.11.1","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.3.0.tar.gz
Algorithm Hash digest
SHA256 c51cbba4037de6aa249cc26151be1b168b9cb0b7e7af2dbc024b715af559684b
MD5 ed3cd105cdc4784a2c8a63a499a2e6d4
BLAKE2b-256 c3ce294c0109c5145a2e2dd4b98838649d78bb36bc09b67bd39c94e22ce517bf

See more details on using hashes here.

File details

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

File metadata

  • Download URL: agentic_audit_hook-0.3.0-py3-none-any.whl
  • Upload date:
  • Size: 7.0 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.11.1 {"installer":{"name":"uv","version":"0.11.1","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.3.0-py3-none-any.whl
Algorithm Hash digest
SHA256 cf10fc7038f43d3ee6af9f13f8e2bdb6ea292365b1db1612efc4281318a18f1f
MD5 075410ab9a7b6717edb76549c36b52ea
BLAKE2b-256 245041d0ee67a0fcb9344018edf0aab6a49979d2eb0ed017d93ad6afaff49dd5

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