Skip to content
pcguestPublic

About

Tamper-evident, locally verifiable audit trails for AI agents. Hash-chained bundles, incident forensics, cross-language verify (MIT).

Resources

Code of conduct

Contributing

Security policy

Stars

0 stars

Watchers

0 watching

Forks

Latest commit

 

History

1,085 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

ATB: portable evidence for AI-agent incidents

Source version: v2.0.0 (unreleased; not a publication claim).

CI Go version MIT licence

ATB captures agent and tool activity in portable, tamper-evident bundles that can be verified offline.

ATB proves the integrity and order of records in a bundle. It does not prove that every relevant event was captured, that the actor was honest, or that a recorded claim is true.

The pinned CLI code revision for this developer preview is 07ec8ba793a5f0cf5ca99a95e7e280131b6863b4. It covers local capture, portable bundles, integrity verification, optional signing, profile evaluation, and machine-readable output. This documentation correction sits above that code revision and does not alter CLI behaviour. This preview is not a published release, a custody service, or a compliance certification.

The preview scope is the Go CLI only. The Python and TypeScript SDK examples are supporting documentation; their execution is not part of the preview scope. ATB retains its tested Python 3.9 SDK contract for the v1 patch line. Its install path is verified by the Python 3.9 compatibility CI job; the security audit runs on Python 3.11. Python 3.9 reached upstream end of life in October 2025; retention is a dated compatibility decision. See the support matrix and security gate policy.

The source-built investigation UI remains an experimental local surface. It is implemented, and independent manual keyboard, screen-reader, focus-order, and 200%/400% zoom acceptance has not been run or recorded for the pinned code revision. This page records the candidate and its boundary, not acceptance.

Quickstart

Choose an installation route:

Route CLI verification Visual investigation
Published CLI release Features of that release; use its matching docs Check that release’s assets and documentation
go install Yes, for the module version Go resolves Install-guidance page only; no embedded investigation UI
Source checkout + make build Yes Experimental embedded UI; implemented, manual accessibility acceptance not run

As of 2026-11-08, the latest GitHub release, Python SDK and TypeScript SDK are 1.18.1. The current source reports 2.0.0; no 2.0.0 tag or SDK publication is recorded at that checkpoint. SDK packages are libraries, not the full Go CLI or viewer. Hosted CI, remote tag state and registry publication are not independently verified by this page; check them separately before treating this page as release evidence.

Install the pinned CLI code revision without the embedded UI:

atb_install_dir="$HOME/.local/bin"
GOBIN="$atb_install_dir" go install github.com/pcguest/atb/v2/cmd/atb@07ec8ba793a5f0cf5ca99a95e7e280131b6863b4
export PATH="$atb_install_dir:$PATH"
"$atb_install_dir/atb" version
go version -m "$atb_install_dir/atb"

The module version at this checkpoint for that commit is v2.0.0-20261109054510-07ec8ba793a5, commit 07ec8ba793a5f0cf5ca99a95e7e280131b6863b4. atb version still prints 2.0.0 from the source string. That string is not a published release. go install github.com/pcguest/atb/v2/cmd/atb@latest remains the unpinned module query. It follows Go’s version-selection rules and is not a reproducible pin; it may resolve to a different pseudo-version as main advances. For prerequisites, see installation options.

Create a bundle, record an event, and verify it:

atb bundle new
atb append ai.request.received --data='{"request_id":"req-1042"}'
atb verify run.atb/bundle.atb

For a complete walkthrough, including supporting Python and TypeScript SDK examples, see the five-minute quickstart.

The source build below is optional. It is outside the CLI preview acceptance sequence. The embedded viewer is implemented and remains experimental. Independent manual keyboard, screen-reader, focus-order, and 200%/400% zoom acceptance has not been run or recorded for the pinned code revision.

git clone https://github.com/pcguest/atb.git
cd atb
git checkout 07ec8ba793a5f0cf5ca99a95e7e280131b6863b4
make build
./atb version
./atb bundle new
./atb append ai.request.received --data='{"request_id":"req-1042"}'
./atb view run.atb/bundle.atb

Use Go 1.26.10 and Node.js 22 with npm; dependency downloads require network access. make build builds the web assets before embedding them in ./atb. go install does not embed that UI.

Use ATB

Verification is local. Optional signing, timestamp, encryption, and external custody integrations add capabilities without changing ATB's capture boundary.

Documentation

Start with the quickstart → architecture → verification and limitations → integrations → contributing. See the documentation hub for reference material and task guides.

Documentation hub · Architecture · Trust model · Bundle format · Event semantics · Local viewer API

Security and contributing

See SECURITY.md for private vulnerability reporting and CONTRIBUTING.md for setup, development, and validation. ATB's licence is MIT.

About

Tamper-evident, locally verifiable audit trails for AI agents. Hash-chained bundles, incident forensics, cross-language verify (MIT).

Resources

Code of conduct

Contributing

Security policy

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Used by

Contributors

Languages