Open-source markdown vault gives Claude persistent memory across sessions
What it is
My Portable Brain is an open-source tool that creates a persistent memory system for Claude AI sessions using a markdown vault structure with an agent runtime layer. It addresses the frustration of Claude starting each session with zero context about the user's identity, current work, or priorities.
Key details from the source
The system consists of:
- A markdown vault structure that stores user context in plain text files
- An agent runtime layer that manages the context loading and updating
- Automatic context loading on startup including: identity, projects, goals, CRM data, and weekly plans
- Background scripts that run nightly to keep context fresh and updated
- No plugins or databases required - just plain markdown files owned by the user
- Native compatibility with Claude Code and Claude Cowork
- MIT licensed and completely free
The developer notes that the main challenge wasn't implementing AI functionality, but rather structuring context in a way that Claude can use consistently across sessions.
Technical approach
The solution uses a file-based approach rather than a database or plugin architecture. This makes it portable and gives users full ownership of their data. The nightly background scripts ensure that context remains current without manual intervention.
The project is hosted at myportablebrain.ai with source code available on GitHub at https://github.com/Bermanmt/My-Portable-Brain.
📖 Read the full source: r/ClaudeAI
👀 See Also
Relational Memory for LLMs: Three-Layer System Models User Relationships
An open-source Python tool that adds relational memory to LLMs by modeling user-AI relationships across seven psychological dimensions, using a three-layer narrative structure instead of flat fact storage.
Files.md: Open-Source Local-First Markdown Note-Taking App with LLM-Friendly Design
Files.md is an open-source, local-first markdown app for notes, tasks, and journals. 886 stars, built in Go, works offline, syncs via iCloud/Dropbox/self-hosted server or hosted beta app.files.md.
ShareMyClaudeMD: Tool Converts Claude-Generated Markdown Files to Shareable Rendered Pages
A developer built sharemyclaudemd.com, a free tool that converts any Markdown file into a live, rendered page with a shareable URL and QR code. The tool addresses the friction of sharing Claude-generated Markdown files, which often requires recipients to open them in a specific editor or push to GitHub just for a rendered view.
Top 6 Open Source Claude Skills (April 15 – May 3)
Six open-source Claude skills from the last 15 days: brand-alchemy, npm-downloads-to-leads, hyperframes, email-newsletter, pricing, and more. Detailed breakdown of each skill's functionality.