Tree Ring Memory — Tools & Infrastructure

Tree Ring Memory is a framework-agnostic, local-first memory lifecycle layer for AI agents. It helps agents remember decisions, warnings, preferences, and lessons without turning memory into a transcript dump. It is for developers building AI agents that need persistent, structured memory.

agent-memory agent-skills ai-agents ai-memory claude-skills cli codex-skills context-engineering

🐙 View on GitHub ↗ 🌐 Website 📦 Install

✨ Key features

Local-first SQLite/FTS storage with no required cloud service.
Source-linked memories for decisions, scars, lessons, and truths.
Rust-native CLI with import/export, audit, consolidation, and maintenance.
Same-host multi-agent correlation and scoped recall filters.
Optional coordinator capability enforcement for shared writes.
Privacy defaults that block secret-like memory and hide sensitive details.

🎯 Use cases

Store project-specific lessons and decisions for AI agents.
Recall relevant memories with ranked search results.
Audit memory for stale, sensitive, or contradictory entries.
Sync memory with DOX/Revolve protocols.
Run a terminal UI to browse memory rings and evidence.

📦 Installation

🧰 Requirements: Requires macOS ARM64 or Linux x86_64 for prebuilt installs, or Rust and Cargo for source installs. No API keys or accounts needed.

Verified prebuilt install for macOS ARM64 or Linux x86_64

curl -fsSL https://raw.githubusercontent.com/TerminallyLazy/Tree-Ring-Memory/main/install.sh | sh -s -- --release latest

Recommended project-local install with first-run initialization

cd <project-root>
curl -fsSL https://raw.githubusercontent.com/TerminallyLazy/Tree-Ring-Memory/main/install.sh | sh -s -- --project --init --release latest --no-animation

macOS ARM64 install with Homebrew

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

Source install (requires Rust and Cargo)

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

🚀 Usage

Initialize a project-local store

tree-ring init

Store a memory

tree-ring remember "Use project-scoped recall before changing release behavior." \
  --event-type lesson \
  --scope project \
  --project example-service \
  --tag release \
  --tag workflow

Recall memories

tree-ring recall "release behavior" --project example-service

Open the terminal UI

tree-ring tui

⚠️ Good to know

Tree Ring Memory is in protocol-preview status; shared activation is supported only for same-host local filesystem processes, and it does not claim safe SQLite sharing across hosts or network filesystems.

❓ FAQ

What is Tree Ring Memory?

It is a framework-agnostic, local-first memory lifecycle layer for AI agents, helping them remember decisions, warnings, preferences, and lessons without turning memory into a transcript dump.

How do I install Tree Ring Memory?

You can use the one-line installer with --release latest for prebuilt binaries, use Homebrew on macOS ARM64, or build from source with Rust and Cargo.

Does Tree Ring Memory require cloud services?

No, it uses local SQLite/FTS storage and has no required cloud service.

What is the current status of the project?

It is in protocol-preview status, with version history up to v0.15.3.

📊 Repository

GitHub github.com/TerminallyLazy/Tree-Ring-Memory

Stars★ 16

Forks🍴 2

Open issues🐛 3

Last commit🕒 Aug 29, 2026

Created📅 Jul 2026

Language💻 Rust

License⚖️ MIT

Websiteterminallylazy.github.io/Tree-Ring-Memory

Topics agent-memory agent-skills ai-agents ai-memory claude-skills cli codex-skills context-engineering developer-tools dox llm-memory local-first

🤖 Overview, features, install steps and FAQ were generated from the project's README on Sep 4, 2026. Always check the original source before running commands.