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
Tendr Skill: Deterministic CLI Operations for Agent Memory Management
Tendr Skill is an Agent Skill that separates reasoning from execution for structured long-term memory, allowing agents to decide what needs changing while a CLI tool handles structural operations deterministically. It supports [[wikilinks]] and explicit semantic hierarchies across files.
ACO System: Open-Source Multi-Agent Pipeline from GitHub Issue to Merged PR
ACO System is an open-source multi-agent framework that autonomously runs a full software pipeline—from GitHub Issue to merged PR—using six specialized AI agents. Features a deterministic Architect gate that blocks hallucinations.
Flash-MoE: Running 397B Parameter Qwen Model on MacBook Pro with Pure C/Metal
Flash-MoE is a pure C/Metal inference engine that runs Qwen3.5-397B-A17B, a 397 billion parameter Mixture-of-Experts model, on a MacBook Pro with 48GB RAM at 4.4+ tokens/second. The 209GB model streams from SSD through custom Metal compute shaders with no Python or frameworks.
Sgai: Goal-Driven Multi-Agent Software Development Tool
Sgai is an open-source Go tool that coordinates AI agents to execute software goals defined in GOAL.md files. It decomposes goals into DAG workflows, runs tests for completion gates, and operates locally with a web dashboard for monitoring.