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.13.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.13.0
File Size Uploaded Provenance Actions
agentmetry-0.13.0.tar.gz 1.4 MB With provenance Details for agentmetry-0.13.0.tar.gz

Built distribution (wheel)

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

Total release size: 2.7 MB

Release files / agentmetry-0.13.0.tar.gz

Download URL agentmetry-0.13.0.tar.gz
Size 1.4 MB
Tags Source
SHA-256 checksum
How to use checksums
f3f81403b8fbb1ae98e44c4bc1f90d78cd6e58837bacea100c0aa58396b568a5
BLAKE2b-256 checksum
How to use checksums
3c52c697648b22674f375ebefa40aced791c45c6876479cf8209a79b4f5756da
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 18, 2026.

Transparency log

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

Download URL agentmetry-0.13.0-py3-none-any.whl
Size 1.3 MB
Tags Python 3
SHA-256 checksum
How to use checksums
39b2ef612e053ce53726904b69e24c159998953ee9bf4394e5b2373c2a8cc566
BLAKE2b-256 checksum
How to use checksums
f70b594e18e58500d966d0507fa7aa61495c2eb4399973cf85ee9855e7f46fb3
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 18, 2026.

Transparency log

Security for agentmetry 0.13.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.13.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 18, 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