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.