Skip to main content

agent-audit-cli

Fail-closed audit CLI for AI agent tool calls — adjudicate one request, verify the hash-chained trail.

A thin command-line wrapper over the agent-call-audit engine (audit_guard), designed as a WorkBuddy Connector (CLI + Skill scheme): an AI assistant can adjudicate agent tool calls against a rule set and verify the tamper-evident trail, using only this command.

Install

pip install agent-audit-cli

Commands

Command Purpose Exit
agent-audit check Adjudicate one tool-call JSON request, print verdict 0 = allowed, 2 = denied, 3 = error
agent-audit verify Verify a hash-chained trail file 0 = ok, 2 = fail
agent-audit status Self-check (rules load, engine import) 0 = ok, 3 = error

check

agent-audit check --request-json '{"caller_id":"agent-alpha","target_capability":"data.lookup","action_type":"read","data_class":"internal","request_hash":"...","nonce":"..."}'
agent-audit check --request-file req.json --rules rules.json --trail trail.jsonl

Human verdicts exit 0 — the caller must resolve them via a human channel.

verify

agent-audit verify --trail trail.jsonl

status

agent-audit status [--rules rules.json]

Exit codes

  • 0 — success / ALLOWED / human verdict
  • 2 — denied / FAIL (trail corrupt)
  • 3 — error (bad usage, missing rule set, engine failure — fail-closed)

Fail-closed guarantee

Any engine or rule-loading failure produces an error verdict and a non-zero exit code — the caller must treat it as deny, never silently allow.

License

MIT

Metadata

Release files for agent-audit-cli 0.1.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for agent-audit-cli 0.1.0
File Size Uploaded Provenance Actions
agent_audit_cli-0.1.0.tar.gz 4.3 kB Without provenance Details for agent_audit_cli-0.1.0.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for agent-audit-cli 0.1.0
File Interpreter ABI Platform Actions
agent_audit_cli-0.1.0-py3-none-any.whl Python 3 none any Details for agent_audit_cli-0.1.0-py3-none-any.whl

Total release size: 9.2 kB

Release files / agent_audit_cli-0.1.0.tar.gz

Download URL agent_audit_cli-0.1.0.tar.gz
Size 4.3 kB
Tags Source
SHA-256 checksum
How to use checksums
76d045a275378d6d7d8421f6c19f218274f5159abdf9ece13abedfe031257f6a
BLAKE2b-256 checksum
How to use checksums
09e7fbd5655a355e8dde320c5f84763d8a8c41a59a2b8bbf529924fd96dac92b
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.13.14

Release files / agent_audit_cli-0.1.0-py3-none-any.whl

Download URL agent_audit_cli-0.1.0-py3-none-any.whl
Size 4.9 kB
Tags Python 3
SHA-256 checksum
How to use checksums
f5785a5048391c152684b262329975da82c6b82cd10beb83d5e8ae82b4189c5a
BLAKE2b-256 checksum
How to use checksums
b55703c07c33341892efcdf3f8f2fd0cbcb5b1d6c1eb51e77b8161464a08ce7b
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.13.14

Security for agent-audit-cli 0.1.0

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

0.1.0 This release

2 release files No provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page