tree-ring-memory

name	tree-ring-memory
description	Use Tree Ring Memory for local-first AI-agent memory lifecycle work: recall, evidence, audit, forgetting, and consolidation without transcript dumping.
category	development
risk	safe
source	community
source_repo	TerminallyLazy/Tree-Ring-Memory
source_type	community
date_added	2026-07-08
author	TerminallyLazy
tags	["agent-memory","local-first","recall","privacy","codex","sqlite","cli"]
tools	["claude","codex","cursor","gemini","antigravity","opencode"]
license	Apache-2.0
license_source	https://github.com/TerminallyLazy/Tree-Ring-Memory/blob/main/LICENSE

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 authoritative than generic examples in this skill. If the CLI is installed, inspect the current command surface before assuming flags:

tree-ring --help
tree-ring recall --help
tree-ring remember --help
tree-ring evidence --help
tree-ring audit --help
tree-ring forget --help

If Tree Ring is not installed, do not run remote installer commands automatically. Point the user to the project repository or install docs and ask whether they want installation help.

Step 2: Recall Before Risky Work

Use narrow, project-scoped recall first:

tree-ring recall "release behavior" --scope project
tree-ring recall "sqlite migration" --scope project
tree-ring recall  --scope global