tree-ring-memory

Tree Ring Memory

Overview

Tree Ring Memory is a framework-agnostic, local-first memory lifecycle layer for AI agents. Use this skill when an agent should recall, preserve, audit, or forget durable project memory without treating raw conversation transcripts as memory.

The public runtime is a Rust CLI/TUI with local SQLite/FTS storage, scoped recall, evidence records, audit, deterministic consolidation, maintenance, DOX/Revolve source adapters, framework discovery, redaction, and explicit forgetting.

When to Use This Skill

• Use before resuming a project where prior decisions, warnings, preferences,

or failed approaches may matter.

• Use before changing architecture, storage, security, privacy, release, or

agent-memory behavior.

• Use when the user asks to remember, recall, audit, redact, forget, or

consolidate agent memory.

• Use after tests, reviews, incidents, or production behavior validate a lesson

future agents should preserve.

• Use when a project contains .tree-ring/SKILL.md, .tree-ring/CLI.md, or

other Tree Ring bridge files.

How It Works

Step 1: Discover Local Guidance

Check whether the current project already has Tree Ring guidance:

test -f .tree-ring/SKILL.md && sed -n '1,220p' .tree-ring/SKILL.md
test -f .tree-ring/CLI.md && sed -n '1,220p' .tree-ring/CLI.md

Treat project-local .tree-ring files as more authoritat