llms.txt@docs git:20260814.9a0aba8B

Immutable. This exact content is served forever at /api/v1/blob/f385c90bcabe71cd.

# Tree Ring Memory Framework

> Tree Ring Memory is a framework-agnostic, local-first memory lifecycle layer
> for AI agents.

Website: https://terminallylazy.github.io/Tree-Ring-Memory/
Repository: https://github.com/TerminallyLazy/Tree-Ring-Memory
Launch release: https://github.com/TerminallyLazy/Tree-Ring-Memory/releases/tag/v0.14.0
Launch discussion: https://github.com/TerminallyLazy/Tree-Ring-Memory/discussions/27
Homebrew tap: https://github.com/TerminallyLazy/homebrew-tree-ring
Feedback: https://github.com/TerminallyLazy/Tree-Ring-Memory/issues/26
Feed: https://terminallylazy.github.io/Tree-Ring-Memory/feed.xml
License: MIT
Status: protocol-preview
Current version: 0.14.0

## Summary

Tree Ring Memory helps AI agents remember useful decisions, warnings,
preferences, and evidence without turning memory into raw transcript storage.
Fresh memory stays detailed, older learning compresses into rings, important
failures remain visible as scars, durable truths become heartwood, and future
ideas stay as seeds.

## What Ships Now

- Rust-native CLI and crates.
- Local SQLite/FTS storage.
- Explainable recall with ring, scope, confidence, and ranking signals.
- Explicit forgetting, redaction, supersession, audit, and maintenance.
- Deterministic consolidation without requiring an LLM.
- Source-linked evaluated outcomes through `tree-ring evidence`.
- Controlled workflow-proof artifacts with explicit model identity and exact structured-output checks.
- Same-host multi-agent identity, scoped recall, and exact-retry idempotency.
- Optional coordinator authorization for shared writes and lifecycle mutations.
- Project-local harness activation with receipt-backed readiness.
- DOX and Revolve sync adapters.
- Read-only agent-framework discovery.
- Terminal onboarding and a Ratatui operator console.

## Install From Source (Requires Rust and Cargo)

```bash
curl -fsSL https://raw.githubusercontent.com/TerminallyLazy/Tree-Ring-Memory/main/install.sh | sh
```

Linux x86_64 prebuilt install (glibc 2.36 or newer):

```bash
curl -fsSL https://raw.githubusercontent.com/TerminallyLazy/Tree-Ring-Memory/main/install.sh | sh -s -- \
  --archive-url https://github.com/TerminallyLazy/Tree-Ring-Memory/releases/download/v0.14.0/tree-ring-memory-0.14.0-linux-x86_64.tar.gz \
  --archive-sha256 c72191aca81f195472272a1962df354fe0af04a08b01a7472a1faf987cd177fa
```

macOS ARM64 Homebrew install:

```bash
brew tap TerminallyLazy/tree-ring
brew install tree-ring
```

## First Commands

```bash
tree-ring init
tree-ring remember "Use project-scoped recall before risky release changes." --event-type lesson --scope project
tree-ring recall "release changes"
tree-ring evidence "The eval passed after the fix." --outcome promoted --evidence-ref evals/run-042
tree-ring tui
```

## Ring Model

- `cambium`: fresh active context.
- `outer`: recent summarized learning.
- `inner`: older compressed learning.
- `heartwood`: durable high-confidence truths.
- `scar`: important failures, regressions, and warnings.
- `seed`: unresolved ideas and hypotheses.

## Privacy Boundary

Tree Ring Memory is local-first by default. It does not scrape transcripts, run
a hidden recorder, or turn terminal event pulses into durable memory. Durable
writes are explicit.

## Canonical Links

- Launch page: https://terminallylazy.github.io/Tree-Ring-Memory/
- Text launch note: https://terminallylazy.github.io/Tree-Ring-Memory/launch/tree-ring-memory-framework.md
- Rust article: https://terminallylazy.github.io/Tree-Ring-Memory/launch/rust-native-agent-memory-cli.md
- Press kit: https://terminallylazy.github.io/Tree-Ring-Memory/press-kit.md
- Repository: https://github.com/TerminallyLazy/Tree-Ring-Memory
- Launch release: https://github.com/TerminallyLazy/Tree-Ring-Memory/releases/tag/v0.14.0
- Launch discussion: https://github.com/TerminallyLazy/Tree-Ring-Memory/discussions/27
- Homebrew tap: https://github.com/TerminallyLazy/homebrew-tree-ring
- Feedback issue: https://github.com/TerminallyLazy/Tree-Ring-Memory/issues/26
- Atom feed: https://terminallylazy.github.io/Tree-Ring-Memory/feed.xml