| 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
