The honest origin story
I'm a PhD researcher. I've spent years training my brain to hold enormous amounts of information: papers, ideas, deadlines, people, half-baked theories at 2am. And for a while, it worked.
Then it didn't.
Memory started slipping. Not dramatically (no diagnosis, no crisis) just the slow, creeping realization that the mental budget was getting empty, and things were falling through the cracks. I'd forget what I'd read. Lose track of conversations. Feel constantly behind, constantly overwhelmed.
I started looking for solutions. I found a lot of Obsidian + Claude setups online. They were mostly clever note-capture tools, glorified search engines for your second brain. Useful. But not what I needed.
What I needed wasn't just a memory extension. I needed a brain dump system, something that could help me organize not just my knowledge, but my life: my overwhelmed mind, my wrecked physical health, the avalanche of emails and commitments and things I should have done last week.
So I built this.
What makes this different
Most "AI + Obsidian" tools are built for people who already have their life together and want to optimize. This one is for people who are drowning and need a lifeline.
1. The chat IS the interface.
I don't browse Obsidian. I don't drag files around. I don't maintain complex folder structures manually. I just talk to Claude. Everything else happens automatically.
2. It speaks your language, literally.
The system works in any language. You shouldn't need to think in English to manage your brain. Just talk in Italian, French, German, Spanish, Japanese, whatever feels natural. The agents match you.
3. The agents coordinate through a dispatcher.
When the transcription agent processes a meeting and discovers a new project, the dispatcher automatically chains the Architect to create the folder structure. It's a crew, not a collection of isolated tools.
4. 8 agents are just the starting point. Build your own.
The crew ships with 8 agents. But your life isn't generic, and your system shouldn't be either. Say "create a new agent" and the Architect walks you through a conversation to design one from scratch. No code, no config files, no templates to edit. You describe what you need, it builds it.
| Your problem | Your agent |
|---|
| "I can only spend 300 euros a month on groceries and I keep losing track" | budget-tracker: monitors spending notes, flags when you're close to the limit |
| "My partner says I dress like I pick clothes with my eyes closed" | wardrobe-coach: tracks what you own, suggests outfits from your notes, and gently stops you from wearing that shirt again |
| "I keep buying the same thing at IKEA because I forget what I already have at home" | home-inventory: catalogs what you own room by room, saves you from your third identical cutting board |
| "I keep starting side projects and abandoning them" | project-pulse: weekly check-in on all active projects, flags stale ones |
| "I have three freelance clients and I mix up their deadlines" | client-tracker: aggregates deadlines per client from notes and calendar |
Custom agents coordinate with the core crew, get discovered automatically by your agent platform, and respond in your language. They just solve the problems that are specific to your life.
Your custom agents, your responsibility. Custom agents are created by you and run on your data. The project provides no warranty on their behavior. See Terms of Use.
Who this is for
- PhD students, researchers, academics drowning in papers and commitments
- Anyone with brain fog, or just an overloaded working memory
- Non-native English speakers who want a system that works in their language
- Anyone who's tried Obsidian before and gave up because it felt like a second job
If you've ever thought "I need to get organized, but I'm too exhausted to get organized", this is for you.
Important disclaimers
Please read the full disclaimers before using this project.
Key points:
- This software is for personal use on your own data. You are responsible for GDPR/CCPA compliance if you process third-party data (e.g., emails containing other people's information).
- No warranty. Provided "as is". Back up your vault. The author accepts no liability.
- No responsibility for forks or misuse. This is a personal productivity tool. Malicious repurposing is explicitly condemned.
By using this software, you agree to the Terms of Use. During onboarding, the Architect will ask you to explicitly accept these terms before proceeding.
The Crew
| # | Agent | Role | Superpower |
|---|
| 1 | Architect | Vault Structure & Setup | Designs your entire vault, runs onboarding, sets the rules everyone follows |
| 2 | Scribe | Text Capture | Transforms your messy, typo-filled, stream-of-consciousness dumps into clean notes |
| 3 | Sorter | Inbox Triage | Empties your inbox every evening and routes every note to its perfect home |
| 4 | Seeker | Search & Intelligence | Finds anything in your vault, synthesizes answers across notes with citations |
| 5 | Connector | Knowledge Graph | Discovers hidden links between your notes, even ones you'd never think of |
| 6 | Librarian | Vault Maintenance | Weekly health checks, deduplication, broken link repair, growth analytics |
| 7 | Transcriber | Audio & Meetings | Turns recordings and transcripts into rich, structured meeting notes |
| 8 | Postman | Email & Calendar | Bridges email (Gmail or Hey.com) and Google Calendar with your vault: deadline radar, meeting prep |
Agents + Skills = the full system. Each agent handles quick, reactive tasks. For complex multi-step workflows (like onboarding, email triage, or vault audits), the dispatcher routes to one of 14 specialized skills that run as guided conversations. See the Skills section below.
Skills
Skills handle the complex, multi-step workflows that need conversational context. While agents are great for quick, one-shot tasks, some operations — like onboarding or email triage — require a back-and-forth conversation. Skills run in the main conversation context, so they can ask questions, wait for answers, and maintain state naturally.
The dispatcher automatically routes your message to the right skill or agent. You don't need to remember which is which.
| Skill | What it does | Extracted from |
|---|
/onboarding | Full vault setup conversation | Architect |
/create-agent | Design a custom agent step by step | Architect |
/manage-agent | Edit, remove, or list custom agents | Architect |
/defrag | Weekly vault defragmentation (5 phases) | Architect |
/email-triage | Scan and prioritize unread emails | Postman |
/meeting-prep | Comprehensive meeting brief | Postman |
/weekly-agenda | Day-by-day week overview | Postman |
/deadline-radar | Unified deadline timeline | Postman |
/transcribe | Process recordings into structured notes | Transcriber |
/vault-audit | Full 7-phase vault audit | Librarian |
/deep-clean | Extended vault cleanup | Librarian |
/tag-garden | Tag analysis and cleanup | Librarian |
/inbox-triage | Process and route inbox notes | Sorter |
/contact-sync | Sync contacts to Apple Contacts (search, create, update) | Postman |
How it works
You talk naturally → Dispatcher checks skills first → If match: invokes skill
→ If no match: invokes agent → Your vault gets updated
The dispatcher has two delegation mechanisms. Skills handle complex, multi-step conversational flows (onboarding, email triage, vault audits). Agents handle quick, reactive single-shot operations (capture a note, search the vault, create a folder). Skills are checked first because they cover the most involved workflows. If no skill matches, the dispatcher falls through to agents.
Each crew member is an isolated AI with its own system prompt, tool restrictions, and model assignment. You clone the repo into your vault, run a setup script, and from that moment on you manage everything through conversation. No GUI, no drag-and-drop, no manual file management.
Architecture
graph TB
User((You))
Dispatcher["Dispatcher"]
User -->|"talk naturally"| Dispatcher
Dispatcher -->|"skill match?\ninvoke skill"| Skills
Dispatcher -->|"no skill match?\ninvoke agent"| Agents
Dispatcher -->|"chains agents when needed"| Agents
subgraph Skills["Specialized Skills (14)"]
direction TB
Onboarding["/onboarding"]
EmailTriage["/email-triage"]
Transcribe["/transcribe"]
InboxTriage["/inbox-triage"]
VaultAudit["/vault-audit"]
MoreSkills["... +9 more"]
end
subgraph Agents["The Crew (8 agents)"]
direction TB
subgraph Core["Core: Knowledge Management"]
Architect["Architect\nVault Setup"]
Scribe["Scribe\nNote Capture"]
Sorter["Sorter\nInbox Triage"]
Seeker["Seeker\nSearch"]
Connector["Connector\nKnowledge Graph"]
Librarian["Librarian\nVault Health"]
end
subgraph External["Integrations"]
Transcriber["Transcriber\nAudio & Meetings"]
Postman["Postman\nEmail & Calendar"]
end
end
Skills <-->|"read & write"| Vault
Agents <-->|"read & write"| Vault
subgraph Vault["Your Obsidian Vault"]
direction LR
Inbox["00-Inbox"]
Projects["01-Projects"]
Areas["02-Areas"]
Resources["03-Resources"]
Archive["04-Archive"]
Daily["07-Daily"]
end
style User fill:#7c3aed,stroke:#5b21b6,color:#fff
style Dispatcher fill:#3b82f6,stroke:#2563eb,color:#fff
style Skills fill:#fef3c7,stroke:#f59e0b
style Core fill:#e0e7ff,stroke:#818cf8
style External fill:#dbeafe,stroke:#60a5fa
Agent & Skill Coordination Flow
sequenceDiagram
participant U as You
participant D as Dispatcher
participant TS as /transcribe skill
participant A as Architect agent
participant ES as /email-triage skill
participant S as Sorter a