v0.3 — open source

Your AI's memory layer

A personal vault that gives any LLM instant context on startup. Your priorities, your people, your plans — in plain markdown, owned by you.

Download (.zip) View on GitHub
Terminal — portable-brain
# One command. Five minutes. Your AI gets you.

$ bash start.sh

🧠 My Portable Brain — v0.3

Hey.
What's the one thing on your mind right now
that you haven't dealt with yet?

finish the investor deck by friday

Saved. Your assistant will pick this up on your first session.

# ...a few questions later...

✓ Vault created at ~/Brain
✓ Agent configured: Sage 🧠
✓ Background jobs activated (4 jobs)
✓ 127 files created

What you get

Not another AI wrapper

This is the context layer. It doesn't replace your AI — it makes any AI immediately useful. Drop it in, and your assistant knows who you are.

🎯

Planning that adapts

Monday kickoffs, daily focus, Friday reviews, quarterly rocks. Your agent detects the day type and adapts its greeting — no manual switching.

🤝

Relationship CRM

Not a sales CRM. A people manager. Tracks the whole person — birthdays, gift ideas, open loops — alongside professional context. Auto-updated from your notes.

Background scripts

Bash scripts run overnight — vault health scores, contact scanning, pattern detection. Free to run, no AI needed. The smart layer kicks in when you're present.

🔄

Session continuity

Your agent writes a handoff note at the end of every session. Next morning, it picks up where you left off — no more cold starts.

👤

Agent with personality

Name it, shape its tone, set boundaries. Your agent reads SOUL.md on startup and behaves the way you want — direct, warm, no-fluff, whatever.

📁

Plain markdown

No databases, no lock-in, no proprietary formats. Everything is .md files in folders. Works with Obsidian, VS Code, or any editor. Works forever.


Planning system

Your agent knows what day it is

Different days need different conversations. The agent adapts automatically.

DayWhat your agent does
MondayLast week's results, suggested Big 3 with reasoning, project pulse, calendar, follow-ups
Tue — ThuBig 3 progress, today's schedule, anything needing attention
FridayWeek review snapshot, then a planning conversation for next week
Quarter endBig Rocks status, area check, then next quarter planning
Ad-hocSay "let's do a weekly review" any day — it loads the right context

Everything has a place

PARA-based folder system with agent runtime, planning cascade, and relationship intelligence built in.

Capture first

Everything lands in the inbox. The agent routes it later.

Projects have finish lines

If it doesn't end, it's an area — not a project.

Agent reads on startup

CLAUDE.md points to the agent runtime. Any LLM picks it up.

Two-layer intelligence

Bash detects (free, runs overnight). LLM processes (smart, runs when you're present).

~/Brain/
├── 00-Inbox/ ← everything lands here
│ ├── meetings/
│ ├── emails/
│ └── captures/
├── 01-Projects/ ← active work
├── 02-Areas/ ← ongoing responsibilities
├── 03-Resources/ ← knowledge base
├── 04-Archive/ ← done or abandoned
├── 05-Meta/ ← how the vault works
├── 06-Agent/ ← AI runtime
│ ├── workspace/
│ │ ├── AGENTS.md ← operating instructions
│ │ ├── SOUL.md ← personality
│ │ ├── USER.md ← your profile
│ │ └── memory.md ← long-term context
│ ├── state/
│ │ ├── handoff.md ← session continuity
│ │ └── observations.md ← silent patterns
│ ├── subagents/ ← CRM, calendar, inbox
│ └── cron/jobs/ ← background scripts
├── 07-Systems/ ← CRM, goals, planning
│ ├── CRM/contacts/
│ └── goals/ ← daily → weekly → quarterly
└── 08-CoreSystem/ ← roles, principles, values

Background intelligence

Your vault stays alive between sessions

Bash scripts run on schedule — no AI tokens, no cost. They detect patterns and prepare briefings for your next session.

daily-briefing.sh
Creates morning note with dashboard stats, Big 3 status, project pulse, CRM follow-ups
⏰ Every morning
crm-scan.sh
Detects contact mentions in your daily notes, updates last-contact dates, refreshes CRM briefing
⏰ Nightly
pattern-check.sh
Surfaces recurring carries, stale project actions, CRM open loops, unchecked items
⏰ Nightly
vault-health.sh
Scores vault hygiene 0–100. Catches stale projects, inbox overflow, dormant contacts
⏰ Weekly

Getting started

Five minutes to your second brain

No accounts, no cloud, no subscriptions. Download, answer a few questions, done.

1

Download & run

Download the zip, double-click Install Brain.command (macOS), or run bash start.sh in Terminal. Answer a few questions about yourself.

2

Open in Obsidian

Open the vault folder in Obsidian (or any markdown editor). Your files, your folders, your data — all local, all yours.

3

Talk to your agent

Open the vault in Claude, ChatGPT, or any LLM. It reads CLAUDE.md automatically. Your agent introduces itself and starts helping.


Stop organizing. Start thinking.

Open source. Plain markdown. Works with any AI.

$ git clone https://github.com/Bermanmt/My-Portable-Brain && cd My-Portable-Brain && bash start.sh click to copy
Download v0.3 Star on GitHub