Folders and files
| Name | Name | Last commit date | ||
|---|---|---|---|---|
Turn local Git diffs into evidence-backed, traceable audit reports.
Use EvidentLoop to inspect a local Git diff, trace each finding to the changed lines, record a human decision, and explicitly verify a later fix.
Your coding agent makes the judgment. EvidentLoop validates the result and saves the evidence in a self-contained HTML report with its JSON record. The result stays traceable without being presented as proof that the code is safe.
Prefer to see the report first? Jump to the real audit evidence.
Requirements: Git, Python 3.10 or newer, uv, Node.js/npx for Skill installation, and a coding agent with Skill support.
# Try the bundled offline demo
uvx evidentloop demo
# Install the CLI and Skill
uv tool install evidentloop
npx skills@latest add evidentloop/evidentloop --skill evidentloop -g
evidentloop doctorpipx install evidentloop is the CLI fallback.
Inside the Git repository to inspect, ask your coding agent:
Use EvidentLoop to audit my staged changes and generate the HTML report.
Representative schema 0.5 report · decision and comment · Alpha UI in Simplified Chinese
The animation uses a representative schema 0.5 report generated by the current renderer to show a finding, its complete diff, and a local decision with a comment. The separate self-audit report covers 43/43 files and ends complete / pass_candidate with 0 findings. It proves report generation, validation, and rendering for that range. The public evidence does not yet include a real two-diff fix-verification run.
- Review a complete diff. Your coding agent returns its judgment; EvidentLoop validates the result and renders one self-contained report.
- Revise the report, not the code. Feedback on the same diff updates only the existing report and JSON record without asking the model to review again.
- Verify a later diff explicitly. A source report, chosen finding, and claim start a new full-diff review. Old reports remain unchanged and EvidentLoop does not guess finding matches.
| File | Purpose |
|---|---|
| audit.json | Validated audit record linking Git changes, findings, decisions, and report lineage. |
| audit.html | Self-contained report showing the result, relevant diff, and browser-local decisions. |
| audit-feedback.jsonl | Optional machine-readable decision export for a coding agent. |
Pending feedback stays in each viewer's browser until copied or downloaded. The HTML can be shared after redaction, but it is not a multi-user review service.
| Supported | Not supported |
|---|---|
| Local Git staged, unstaged, ref, and range diffs | Folder diffs, file-only review, or remote PR URLs |
| Added, modified, deleted, renamed, and binary-file metadata | Automatic fixes or command execution |
| Schema 0.5, exact changed-line evidence, and same-diff report revision | Automatic model re-review from feedback |
| Explicit next-diff verification from a source report, finding, and claim | Automatic finding matching or inferred repair from disappearance |
| Complete, partial, failed, and inconclusive states | Silent stale-feedback merging or cross-workspace report search |
Use EvidentLoop through the Skill as a standalone product; no other workflow is required. Integrators can follow the prepare -> external review -> finalize path in AI host integration, use the public API in evidentloop.api, and rely on diff_version plus report_version for artifact identity.
For local development:
python -m pip install -e '.[dev]'
python -m pytest -q
python -m ruff check .
python -m buildReferences: Pages · V0 scope · Data model · AI host integration
Alpha feedback and bug reports are welcome in GitHub Issues.
Licensed under the MIT License.