Skip to main content

Agentmetry

A local-first endpoint sensor for AI coding agents.

Agentmetry records events reported by supported hooks for Claude Code, Cursor, Codex, GitHub Copilot, Antigravity, Qwen, Kimi, Qoder and CodeBuddy, and by wrapped stdio MCP servers. It writes those events to a hash-chained JSONL trail on your machine and runs sequence detection over the session. A credential read followed by network egress can trigger a finding. Findings carry MITRE ATT&CK labels, and MITRE ATLAS labels where ATLAS says something ATT&CK cannot.

Nothing leaves the machine unless you configure it, and there is no telemetry. Forwarding to Splunk HEC, Elastic ECS, Google SecOps, Microsoft Sentinel or a webhook (canonical JSON or CloudEvents) is off by default.

Try it with nothing installed

uvx agentmetry demo

It replays a session into a temporary directory it deletes: a private-key read, then an upload. That raises one critical finding. It then edits the trail and shows agentmetry verify fail.

Record a real agent

pip install agentmetry
agentmetry hooks install
agentmetry start
agentmetry doctor

agentmetry dashboard opens the local console with a one-time sign-in link.

Check the detection claims yourself

The corpus ships inside the package, so this works from a clean install:

agentmetry benchmark

It replays recorded sessions through the real rule engine and exits non-zero on any missed rule or any false positive. The benign half is the number that matters: any tool can fire on an attack, and a feed that cries wolf gets muted.

What it does not do

  • It is not a CASB. It records the agents you wire in. An unmanaged browser assistant, or an IDE with its hooks off, is invisible to it.
  • It is a recorder, not a sandbox. By default it records. DLP and tool policy can deny a call in the hook, before it runs, when you set them to block.
  • The DLP is regex, not ML. A starting pack you extend in YAML.
  • macOS is in preview. CI runs the full suite on Windows, Linux and macOS, but only Windows and Linux are required checks, and no hook has been exercised against a live agent on a Mac.
  • It is a public alpha. Integration surfaces may still change.

For a fleet, a managed policy file can lock settings such as the DLP and tool policy modes so a developer cannot change them. See docs/managed-policy.md.

Full documentation, the event schema, and the SIEM integration guides are in the repository.

Apache-2.0.

Metadata

Release files for agentmetry 0.12.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 agentmetry 0.12.0
File Size Uploaded Provenance Actions
agentmetry-0.12.0.tar.gz 1.3 MB With provenance Details for agentmetry-0.12.0.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for agentmetry 0.12.0
File Interpreter ABI Platform Actions
agentmetry-0.12.0-py3-none-any.whl Python 3 none any Details for agentmetry-0.12.0-py3-none-any.whl

Total release size: 2.5 MB

Release files / agentmetry-0.12.0.tar.gz

Download URL agentmetry-0.12.0.tar.gz
Size 1.3 MB
Tags Source
SHA-256 checksum
How to use checksums
8620a105f0e24bf3376a8e1b2324bcf976b3ae7d07129943e6f2721bfb1c9e04
BLAKE2b-256 checksum
How to use checksums
369ecd4ad917d24d7086ed4b8288047ec012bf48e72bb6c0a253b3d5979315dd
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

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.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 12, 2026.

Transparency log

Release files / agentmetry-0.12.0-py3-none-any.whl

Download URL agentmetry-0.12.0-py3-none-any.whl
Size 1.2 MB
Tags Python 3
SHA-256 checksum
How to use checksums
5066ba24b45aa7709f52480109a63016732d6b4fe01e36677c89c9b80887fa8d
BLAKE2b-256 checksum
How to use checksums
11d55140589d0311e3cdd7e0f3a2bf44d306cf098a7c7acbad10963ac416b2cf
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

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.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 12, 2026.

Transparency log

Security for agentmetry 0.12.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.

Full provenance

Both files in this release have been uploaded with provenance metadata.

Select from 2 files

Attestation for agentmetry-0.12.0.tar.gz

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 12, 2026.

Transparency log

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.

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