AIP
Install
Experimental protocol, local-first

Every change
has a reason.Keep it.

Version control for autonomous coding agents. Record the intent, the operations, the resulting state, and the evidence that backs it up.

Install AIPRead the specification
  • No Git required
  • One Go binary
  • Immutable, content-addressed states
macOS / LinuxARM64 · x64
$ curl -fsSL https://aip-project.org/install.sh | shInstalled AIP v0.1.0-preview.2 to ~/.local/bin/aip $ cd my-project$ aip init$ aip agent setup

Verifies the SHA-256 checksum, installs to ~/.local/bin, never runs sudo.Read the script

The development record

More context. Less reconstruction.

A commit tells you what changed. AIP keeps why it changed, what exactly was done, and what was proven about the result, as linked objects.

Try the first workflow

  1. Intent

    Add greeting endpoint

    The goal, the constraints, the reason. Recorded before the change.

    Keep existing routes compatible

  2. Operation

    Observe workspace changes

    The exact transformation of the project.

    + main.go+ main_test.go

  3. State

    A candidate, preserved

    Content-addressed and immutable. Inspect it, compare it, materialize it.

  4. Evidence

    PASSgo test ./...

    What was tested, executed against this exact state.

Work where you already work

Your editor. Your tools. A better record.

Files stay ordinary files. Agents use structured CLI output. Alternative solutions become sibling states in a shared history, each with its own evidence.

The agent workflow

hello-projectTerminal
# Initialize a normal directory$ aip init # Capture the purpose before the change$ aip intent create \    --title "Add greeting endpoint" \    --goal "Expose GET /hello returning JSON" # Edit files, then preserve the candidate$ aip snapshot --intent <intent-id> # Test the immutable state$ aip evaluate HEAD -- go test ./...

Local today. Collaborative next.

A protocol first. AIPHub comes next.

See what works today

Local CLI Available, preview

Intents, immutable states, diffs, alternative candidates, materialization and executed evaluation. One Go binary for macOS and Linux.

Install

Protocol specification Open

Canonical objects, deterministic CBOR encoding, SHA-256 identities, states, evaluation and transport. Language-independent.

Read the spec

AIPHub Planned

Hosted public and private repositories, candidate comparison and shared evidence. Not available yet.

Roadmap

Start with one repository.

Install the CLI, run aip init, and snapshot your first intent. Your files stay where they are.

Install AIPRead the docs