AI agent verification gate · runner-local or browser-local

Don’t merge an agent’s claim. Check the record.

Traceplain turns Codex, Claude Code, and OpenTelemetry activity into a bounded human handback: recorded actions, unsupported claims, failures, unknowns, and the decision that still belongs to you.

Add the GitHub verification step Review a log locally

No Traceplain upload. The Action stays in your runner; the viewer stays in your browser.

HAND BACK / 14:32 REVIEW NEEDED

7actions observed

3files changed

1claim not proven

Observed

The agent changed three files and committed them locally.

Reported, not verified

“All tests pass.” No test execution was present in the activity record.

YOUR NEXT DECISIONReview the auth change before allowing a push.

RUNNER-LOCALBROWSER-LOCALNO ACCOUNT REQUIREDEVIDENCE-LABELLED

PRIMARY WORKFLOW · GITHUB ACTIONS

Put the handback where review already happens.

The free Action reads an existing Codex JSONL, Claude Code stream, or OTLP JSON file inside the runner. It writes a safe-mode handback directly to the native workflow summary and can fail the step when human review is required.

no request to Traceplain and no dependency installation;
agent-authored claims remain separate from recorded results;
fail-on-review: true turns attention signals into a CI hold;
the reviewer—not the agent—still owns approval.

Copy the workflow step

- name: Verify agent activity
  uses: harmonicfutures/traceplain-review-action@v1
  with:
    path: artifacts/agent-run.jsonl
    fail-on-review: true

TRY TRACEPLAIN

Turn activity into an answer.

For an ad-hoc or sensitive review, paste or choose JSON/NDJSON locally. Traceplain recognises supported event shapes and keeps uncertain facts uncertain.

01Activity record

Drop a log here or choose JSON, NDJSON, or text

OR PASTE

T/

Your handback will appear here

Traceplain labels evidence without pretending a log proves more than it does.

THE DIFFERENCE

Logs describe. Traceplain distinguishes.

Observed

A tool result, exit code, changed target, or other event present in the supplied record.

Governed

A policy decision or authority outcome recorded with a receipt reference.

Prevented

An action the record says was denied or blocked before its intended effect.

Reported

A statement by the agent or runtime that Traceplain cannot independently establish.

Inferred

A cautious interpretation drawn from names or context, clearly marked as inference.

Unknown

Evidence is missing, ambiguous, unsupported, or outside the imported record.

NEED A METHOD? Read the practical guide to reviewing an AI agent activity log →

NEED A HANDOFF? Download the free evidence-labelled AI agent handoff template →

USING CODEX? Capture and review codex exec --json output →

USING CLAUDE CODE? Review stream JSON and session tool calls locally →

USING OTEL? Review an OpenTelemetry GenAI trace locally →

DESIGNING LOGS? Use the minimal AI agent audit-log event schema →

APPLYING DLP? Keep sensitive content out of the agent review record →

REVIEWING IN CI? Build a bounded GitHub Actions handback →

AUTOMATING CI? Generate a bounded Markdown handback in GitHub Actions →

FOUNDING REVIEW KIT

A repeatable method for reviewing agent work.

The public viewer stays free. The Review Kit gives you the complete printable method and reusable handback files immediately after checkout.

Eight-page printable review system
Approval gate and seven-day team trial
Worked example and evidence labels
Markdown template and JSON Schema

Preview one of the eight pages

Preview of the five-pass Review Kit worksheet covering requested, authorised, executed, changed, and verified evidence — Page 2 of 8 · Five-pass review worksheet. The paid kit also includes the approval gate, team trial, worked example, handback, and reusable files.

TRACEPLAIN REVIEW KIT

^A$29

One time · immediate digital delivery through Stripe

Get the Review Kit Checkout collects your name and email for the receipt. Imported agent activity is never sent to Stripe.

NOT READY TO BUY?

Tell us what your agent leaves unclear.

Join the field notes or share the reason you stopped. That evidence decides what Traceplain becomes next.