assurance
Your AI agent says it's done. Assurance tells you what it didn't check.
uvx assurance audit # in a project where you've used Claude Code
uvx assurance audit --demo # or see a report on a bundled sample session
No uvx? Install uv (brew install uv, or
curl -LsSf https://astral.sh/uv/install.sh | sh, or pipx install uv), or use
pip install assurance and run assurance audit.
Real output on the bundled sample. The agent was asked to fix a rounding bug "and make sure the tests pass", and ended with "All done — the totals are correct now."
Claude Code session demo-8f2 — 13 min in /home/you/my-app
10 tool calls, 3 failed — Bash 6, Edit 2, Grep 1, Read 1
Looped: 3 rounds of Bash `pytest -q tests/test_invoice.py` failing the same way, with nothing new read
After the last edit (14:09): no test or check it recognises; 2 unclassified commands ran after it (make lint-fix, python script)
Not classified: 2 shell commands (make lint-fix, python script), so whether they read, wrote or tested anything is unknown.
Also in the transcript: 1 assistant turn, 1 user turn, 1 bookkeeping record.
Not read: 0 lines.
Run it after every session. When Claude finishes without testing its last edit, you're told, and
Claude is sent back to run the tests. assurance hook install adds the Stop hook after showing you the
change, and assurance hook remove takes it out again. Run that one yourself: in auto mode, Claude Code
refuses to let Claude remove the hook, as tampering with an audit.
uvx assurance@latest hook install # --scope project to share it with everyone on the repository
uvx assurance hook remove
Or as a Claude Code plugin, which also adds /assurance:audit for the whole report in a session:
claude plugin marketplace add i-ops-hq/assurance
claude plugin install assurance@i-ops-hq
Or add it to ~/.claude/settings.json yourself:
{ "hooks": { "Stop": [ { "hooks": [ { "type": "command", "command": "uvx --offline assurance@0.1.12 audit --hook --nudge" } ] } ] } }
Run uvx assurance@0.1.12 --version once first: --offline runs the copy uv already has, so the hook
never waits on PyPI.
Every command
| command | question |
|---|---|
assurance audit |
what did a Claude Code session actually do, and what did it skip? |
assurance hook |
install, remove or check the Stop hook that runs the audit after every turn |
assurance diff / assurance check |
did the work cover what it was supposed to, and what did it miss? |
assurance pin |
did an MCP server change a tool definition after you approved it? |
assurance deps |
what will a pip install or npm install execute, read without executing it? |
assurance budget |
where did an agent run's budget go, and where did it loop going nowhere? |
assurance authority |
may this task proceed for the person who asked? |
assurance drift |
did a failure rate actually shift, or was the week noise? |
Nothing here consults a model, opens the network, or reports a check it could not run as a pass.
This package contains no code of its own. It installs
assurance-cli,
assurance-deps,
assurance-budget and
assurance-authority, each of which also installs on
its own. The MCP server is separate: pip install assurance-mcp.
Source, issues and documentation: https://github.com/i-ops-hq/assurance · Apache-2.0.
1 maintainer
Metadata
1 maintainer
Release files for assurance 0.1.12
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| assurance-0.1.12.tar.gz | 12.9 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| assurance-0.1.12-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 20.1 kB
Release files / assurance-0.1.12.tar.gz
| Download URL | assurance-0.1.12.tar.gz |
|---|---|
| Size | 12.9 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
c1dd38c2e6f4e8654960d9b51a09b887bcf94e5357cde0dbfed55aa449801e29
|
|
BLAKE2b-256 checksum How to use checksums |
ab1cd1b6f6a07b574e8ddb186539fc355b57370097dca7456bd8a6cb9f9f223d
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
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 Sep 28, 2026.
Transparency logRelease files / assurance-0.1.12-py3-none-any.whl
| Download URL | assurance-0.1.12-py3-none-any.whl |
|---|---|
| Size | 7.2 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
f88ecac237e03218984afed07a38cd5a4b76794a74e08e48ca0833b5f2b42b3c
|
|
BLAKE2b-256 checksum How to use checksums |
46645ad05a30d3159c2734054c489f6b73f775b4d5339b792509ebdfe7936a3c
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
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 Sep 28, 2026.
Transparency log
