Skip to content
Attestack

Quick start

Record your first Attestack session in a few minutes.

Prerequisites

Section titled “Prerequisites”
RequirementNotes
ShellLinux, macOS, or Windows
GitRequired for snapshot; recommended for real projects
Rust (optional)Only if building from source

Install

Section titled “Install”
Terminal window
curl -fsSL https://raw.githubusercontent.com/kiket-dev/attestack/main/scripts/install.sh | bash

See the Installation guide for manual downloads or building from source.

Terminal demo of a full Attestack session from init through verify
End-to-end session: init → start → record → bundle → verify.

Regenerate locally: ./scripts/render-demos.sh (requires VHS).

Walkthrough

Section titled “Walkthrough”

1. Initialize a project

Section titled “1. Initialize a project”

Create a Git repo and initialize Attestack in it:

Terminal window
mkdir my-project && cd my-project
git init -b main
echo "hello" > README.md
git add README.md && git commit -m "init"


attestack init
attestack doctor

2. Start a session

Section titled “2. Start a session”

Open a session with a descriptive title. Attestack captures an initial Git snapshot when inside a repo:

Terminal window
attestack start "demo session"
attestack status

3. Record work

Section titled “3. Record work”

Run commands, add notes, and capture Git state as you go:

Terminal window
attestack run -- echo hello
attestack note "Reviewed generated change"
attestack snapshot

4. Close and review

Section titled “4. Close and review”

Stopping the session writes a Markdown report under .attestack/sessions/<id>/reports/:

Terminal window
attestack stop
attestack report

5. Export and verify

Section titled “5. Export and verify”

Create a signed bundle and verify it offline:

Terminal window
attestack bundle create
attestack verify .attestack/bundles/*.attestack.zip

Scripting with JSON

Section titled “Scripting with JSON”

Most commands accept --json for automation:

Terminal window
attestack status --json
attestack verify .attestack/bundles/demo.attestack.zip --json
attestack doctor --json

Next steps

Section titled “Next steps”