Gin

GinSource state for agents

Cheap, isolated, stackable workspaces with explicit publication, first-class conflicts and evidence memory, built for agents and machines rather than people.

Get started
What is Gin

  • Isolated workspaces

    Every agent edits its own private workspace with a crash-safe journal. Nothing is visible to anyone else until it is explicitly published.

  • Stacked on unpublished work

    A dependent workspace forks from another workspace's publication and keeps working while its parents move. It advances only when it asks to.

  • Preview before advance

    Preview composes the new parent set with your own changes and reports conflicts without touching anything. Advance switches atomically, or not at all.

  • Conflicts are data

    Conflicts carry labelled sides, exact paths and stable handles. Agents inspect them, propose resolutions and activate them through the same API.

  • Evidence memory

    Execution receipts and CI results are bound to exact source trees, with explicit trust levels, so a failing test can be compared with the baseline without a checkout.

  • Git at the edge

    Git stays the human system of record. Gin imports and exports at sync points and keeps its own history of checkpoints, metadata and comments.

One contract, several adapters ​

Gin is a Rust engine with one versioned API (gin.v1). You can reach it as an embedded library, through the gin command line, through a compact MCP server for agents, or over authenticated gRPC to a gin serve daemon. Every adapter sends the same requests and gets the same responses.

sh
gin context                        # where am I: epoch, generation, parents, sections
gin read src/lib.rs --content      # read the private tree
gin save --incarnation I --generation 3 --epoch E \
  --path src/lib.rs --expect CONTENT_ID --text 'pub fn f() {}'

Status

Gin is under active development. The first milestone is a Linux, headless slice. Durable stores currently need a Unix filesystem. See Getting started for details.

Part of the Tama toolchain.