tree-ring-memory

Tree Ring Memory is a local-first memory lifecycle practice for Claude Code
agents.
This plugin packages one Claude Code skill plus a few explicit slash commands
that teach agents when to recall, write, audit, consolidate, and forget project
memory using the open-source
Tree Ring Memory CLI.
The plugin registers native startup recall and bounded stop checkpoints.
Automatic lifecycle hooks require CLI 0.15.6 or newer. It does not run a
background service, scrape chats, capture transcripts, or ship a networked MCP
server. The active agent evaluates durable outcomes before any capture.
What It Adds
- Recall before context-dependent project work.
- Concise memory writes for validated decisions, lessons, warnings, and user
preferences.
- Evidence-backed outcomes through tree-ring evidence.
- Explicit forgetting, redaction, and supersession guidance.
- DOX and Revolve adapter usage with dry-run-first guardrails.
- Same-host multi-agent identity, idempotency, filtered fan-in, and optional
coordinator write-policy guidance.
- Receipt-backed harness readiness that distinguishes configured bridges from
observed use in a fresh Claude Code session.
- Verified project-local CLI bootstrap and scope-preserving update guidance.
Install Tree Ring Memory
From the actual project root, after the user has authorized Tree Ring setup:
Download the official version-pinned v0.15.0/install.sh to a temporary file,
verify its SHA-256 is
ef0d5eb8f09cbe2e4c3abe80ee9a98a56759c89ad4ddd103d6c68314cd653ade, inspect
it, then run these commands from the project root:
Do not pipe a network response directly to a shell.
The plugin requires Tree Ring Memory v0.15.0 or
newer:
Before a current binary upgrades a pre-v0.13 store to schema v3, stop every
Tree Ring process, checkpoint and back up the complete store, and upgrade every
CLI, plugin, and bundled worker. Do not use a v0.12 writer against schema v3;
all mixed-version operation is unsupported.
If the CLI is missing or older, the plugin may bootstrap or update it when the
user's request already authorizes Tree Ring setup. Otherwise it explains the
exact operation and asks before downloading or changing software. Use
tree-ring update --check for a read-only release check and, with update
authorization, tree-ring update to preserve the active install scope. It does
not edit shell configuration, change global scope, or claim that a memory
action ran without the required authorization and observed command output.
For other install paths, use the canonical project README:
Install The Plugin
Add this repository as a Claude Code plugin marketplace:
After installation, Claude Code can use:
Use
Ask Claude Code:
The skill looks for project-local .tree-ring/SKILL.md and .tree-ring/CLI.md
first. If they are absent, it falls back to the public CLI commands documented
in the main framework repository.
For DOX projects, the plugin reads the applicable AGENTS.md chain before
edits and keeps those live contracts authoritative. /tree-ring-memory:tree-ring-dox-sync
previews the local adapter output before any persistence and never rewrites the
source contracts.
Before any DOX write, verify the selected project-local or PATH binary with
--version and require CLI **0.15.11 or newer**. Older compatible runtimes may
preview with --dry-run, but must not persist DOX summaries. After an authorized
upgrade, rerun and review the preview. This DOX-only minimum adds atomic
source-root collision checks so a conflicting batch cannot overwrite another
project's guidance; general CLI and lifecycle-hook compatibility is unchanged.
/tree-ring-memory:tree-ring-certify uses the installed CLI for harness or
recall-quality evidence. The larger scripts/certify-tree-ring.sh suite remains