Stop re-explaining yourself to AI every session.
obrain hooks Obsidian into Claude Code. Your notes, your files, your projects — Claude reads them before you type a word.
Runs locally. Nothing phones home. No API keys.
You write notes in Obsidian. Claude Code loads them on launch. The more you use it, the more context it has — your projects, your voice, your working patterns. You never have to catch it up.
git clone https://github.com/wozacosta/obrain.git && cd obrain && ./setup.shOr via npm:
npx obrainInstalls Obsidian + Claude Code if needed, sets up the brain structure, and drops in the slash commands. Two minutes. Re-runnable.
Point the installer at it. Adds what's missing, backs up your CLAUDE.md, doesn't touch your notes.
cd ~/obrain && claude| Command | What it does |
|---|---|
/brain-setup |
One-time setup. Claude asks about your work and builds a tailored config. |
/morning |
Start of day. Opens today's note, checks what's new, asks what to focus on. |
/weekly |
End of week. Reviews daily notes, finds patterns, plans next week. |
/recap |
End of session. Captures what happened and files it. |
/todo |
Task manager. Add, complete, reprioritize. Lives in todo.md. |
/digest |
Reads a folder of files (PDFs, docs, images) and writes markdown summaries. |
/import-vault |
Pulls notes from another Obsidian vault into this brain. |
Drop anything into drop/ — PDFs, Word docs, images, whatever. Claude reads them natively.
cp ~/Downloads/stuff/* ~/obrain/drop/Then: "digest and sort drop/"
~/obrain/
├── CLAUDE.md your identity — loaded every session
├── memory.md session log, auto-maintained
├── todo.md task list
├── drop/ incoming files and ideas
├── daily/ one note per day
├── weekly/ weekly reviews
├── projects/ active work
├── refs/ reference material
└── done/ archived work
- Obsidian (free)
- Claude Code
Nothing else.
./uninstall.shnpm testThe obrain License — MIT with personality.