@remember-md/remember

Remember.md — One Brain. Every AI Tool.

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.

Memory vs Brain

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

Install

OpenClaw

openclaw plugins install @remember-md/remember
/remember:init

Claude Code

/plugin marketplace add remember-md/marketplace
/plugin install remember
/remember:init

/remember:init creates your second brain structure and configures permissions.

What You Get

~/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.

Commands

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

How It Works

Process old sessions

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)

Instant capture

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

Adaptive Persona

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.

Supported Tools

• 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.

Customize

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.

Privacy & Portability

• 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

FAQ

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.

Requirements

• OpenClaw or Claude Code (latest version)
• Node.js (bundled with Claude Code; required for OpenClaw)
• Git (optional, for version control)

Credits

Built on ideas from:

• continuous-learning-v2 — Hooks architecture
• PARA Method (Tiago Forte) — Organization structure
• Zettelkasten (Niklas Luhmann) — Linked thinking

License

MIT — see LICENSE.

Remember.md — One brain. Every AI tool. Star on GitHub