Skip to content

README.md

Latest commit

 

History

History
46 lines (31 loc) · 1.32 KB

README.md

File metadata and controls

46 lines (31 loc) · 1.32 KB

cairn

Tamper-proof witnessed AI agent work. Stones stacked to mark "I was here."

cairn captures the complete lifecycle of AI agent sessions through content-addressed Fragment trees (built on fragmentation), with eager writes, deterministic key derivation, and mandatory verification.

Two modes:

  • Socket mode -- cairn spawns claude, captures stdout as thought Shards, handles MCP tool calls, verifies on exit, commits to git.
  • Daemon mode -- long-lived stdio MCP server installed into Claude Code. Bias witnessing + git tools + gestalt resources.

Documentation

Read order: docs/INDEX.md

  1. What Cairn Is -- the concept, the two modes, the session lifecycle.
  2. Witnessed -- trust model, key derivation, tamper detection.
  3. Modules -- how the nine modules compose.
  4. Agent Guide -- what agents need to know.

Run

# Daemon mode (stdio MCP server)
gleam run --module cairn/daemon

# Tests
gleam test

Install

gleam add cairn@1
import cairn
import cairn/daemon
import cairn/session

Licence

LICENSE.md contains the Apache-2.0 licence required by Hex. The actual governing terms are the systemic.engineering License v1.0.