Your AI tools have memory. But memory is not a brain.
Remember.md is a second brain plugin for OpenClaw and Claude Code. It organizes decisions, people, projects, and tasks from your AI sessions — past and future — into a structured, Obsidian-compatible knowledge base that travels with you across tools.
Free. Local. Open source. Portable.
Every AI tool now has memory — flat notes you can't search, browse, or take with you. Remember builds something different: a structured second brain with people, projects, decisions, and tasks connected via wikilinks.
| Built-in memory | Remember.md | |
|---|---|---|
| Structure | Flat key-value pairs | People, Projects, Notes, Tasks, Journal |
| Connections | None | [[wikilinks]] across all files |
| Browsable | No | Obsidian vault with graph view |
| Portable | Locked to one tool | One brain, every AI tool |
| Past sessions | No | Process months of history retroactively |
| Your patterns | No | Persona.md learns your code style |
openclaw plugins install @remember-md/remember
/remember:init/plugin marketplace add remember-md/marketplace
/plugin install remember
/remember:init/remember:init creates your second brain structure and configures permissions.
~/remember/
├── REMEMBER.md # Your custom rules (you edit this)
├── Persona.md # Your patterns (AI learns this)
├── People/ # One note per person
├── Projects/ # Active work with logs and tasks
├── Notes/ # Decisions, learnings, insights
├── Journal/ # Daily notes (YYYY-MM-DD.md)
├── Tasks/ # Focus + Next Up priorities
├── Areas/ # Ongoing responsibilities
├── Resources/ # Links, articles, references
├── Inbox/ # Quick capture
├── Templates/ # Note templates
└── Archive/ # Completed projects
All files use YAML frontmatter + [[wikilinks]] — Obsidian-native, browsable in any markdown editor.
| Command | What it does |
|---|---|
/remember:process |
Extract knowledge from past AI sessions into your brain |
/remember:status |
Show brain stats — file counts, recent activity |
remember this: ... |
Instant capture — routes to the right place automatically |
/remember:init |
Initialize your second brain structure |
Run /remember:process and recover months of lost knowledge from past OpenClaw and Claude Code sessions:
Found 47 unprocessed sessions.
✓ Extracted People/sarah-chen.md
✓ Extracted Notes/decision-database.md
✓ Created 12 journal entries
✓ Updated Tasks/tasks.md (+8 tasks)
✓ Updated Persona.md (learned your patterns)
Say "remember this: met with Sarah, decided to use Postgres for ACID compliance" and Remember routes it:
- Person →
People/sarah.md - Decision →
Notes/decision-database.md - Task →
Tasks/tasks.md
Persona.md evolves with you — code style, naming conventions, review preferences, communication patterns. Loaded automatically every OpenClaw and Claude Code session so your AI knows how you work.
- OpenClaw — full support (plugin + hooks + agent tools)
- Claude Code — full support (hooks + skills)
- Cursor / Codex — planned
One brain, shared across all tools. Knowledge captured in OpenClaw is available in Claude Code and vice versa.
Cascading REMEMBER.md files control how your brain works:
~/remember/REMEMBER.md— global preferences./REMEMBER.md— project-specific rules (layers on top)
Sections: Capture Rules, Processing, Custom Types, Connections, Language, Templates.
For full documentation, see REMEMBER.md Guide.
- Local markdown files — nothing leaves your machine
- No cloud, no telemetry, no tracking
- Git-friendly — version control your entire brain
- No vendor lock-in — works with Obsidian, Logseq, any editor
- Portable — one brain across every AI tool
Q: How is Remember different from OpenClaw memory or Claude MEMORY.md? A: Built-in memory stores flat notes locked inside one tool. Remember builds a structured second brain — People, Projects, Decisions, Tasks, Journal — connected via wikilinks and browsable in Obsidian. It processes past sessions retroactively and is portable across AI tools.
Q: Can it process old sessions?
A: Yes. Run /remember:process to scan past OpenClaw and Claude Code sessions and extract decisions, people, tasks, and insights into your knowledge base. Works on sessions from months ago.
Q: Can I use it with both OpenClaw and Claude Code? A: Yes. Both plugins point to the same brain directory. Knowledge captured in one tool is available in the other.
Q: Do I need Obsidian? A: No, but Obsidian gives the best experience — graph view, backlinks, search. Remember creates Obsidian-native markdown that works in any editor.
Q: How does it learn my coding patterns? A: Persona.md captures your code style, naming conventions, and workflow preferences over time. It's loaded at the start of every session so your AI knows how you work.
Q: How much does it cost? A: Free, always. MIT licensed, open source.
- OpenClaw or Claude Code (latest version)
- Node.js (bundled with Claude Code; required for OpenClaw)
- Git (optional, for version control)
Built on ideas from:
- continuous-learning-v2 — Hooks architecture
- PARA Method (Tiago Forte) — Organization structure
- Zettelkasten (Niklas Luhmann) — Linked thinking
MIT — see LICENSE.
Remember.md — One brain. Every AI tool. Star on GitHub