agentstategraph

A versioned state store for AI agents: content-addressed, branchable, and blameable. Every commit records structured intent — who made the change, on whose authority, why, and with what confidence — so agent work can be audited and governed mechanically.

This is the high-level Repository API. It ties together agentstategraph-core (types and algorithms) and agentstategraph-storage (pluggable backends), and re-exports both as agentstategraph::core and agentstategraph::storage.

cargo add agentstategraph

Quick start

use agentstategraph::core::{IntentCategory, Object};
use agentstategraph::storage::SqliteStorage;
use agentstategraph::{CommitOptions, Repository};

let repo = Repository::new(Box::new(SqliteStorage::open("state.db")?));
repo.init()?;

// Every write is an atomic commit carrying intent metadata.
repo.set(
    "main",
    "/app/name",
    &Object::string("my-project"),
    CommitOptions::new("developer", IntentCategory::Checkpoint, "Initialize project"),
)?;

// Branches are instant. Explore on one, then merge it back.
repo.branch("feature/dark-mode", "main")?;
repo.set(
    "feature/dark-mode",
    "/app/theme",
    &Object::string("dark"),
    CommitOptions::new("developer", IntentCategory::Explore, "Try dark mode"),
)?;
let changes = repo.diff("main", "feature/dark-mode")?;
repo.merge(
    "feature/dark-mode",
    "main",
    CommitOptions::new("developer", IntentCategory::Merge, "Adopt dark mode"),
)?;

for commit in repo.log("main", 10)? {
    println!("{} {}", commit.id.short(), commit.intent.description);
}

Features

The in-memory and Postgres backends are features of agentstategraph-storage.

The crate family

More

• Project README
• RFC — data model, intent lifecycle, authority and delegation
• Examples

License

Licensed under either of Apache License, Version 2.0 or MIT license, at your option.