brainrepoYour personal knowledge repository ā capture, organize, and retrieve everything using PARA + Zettelkasten. Triggers on: "save this", "remember", "note", "capture", "brain dump", daily/weekly reviews, searching stored knowledge, managing projects/areas/people. Works with any AI agent that reads markdown. Stores everything as .md files in a Git repo for Obsidian, VS Code, or any editor.
Install via ClawdBot CLI:
clawdbot install codezz/brainrepoYour personal knowledge repository. Capture fast, organize automatically, retrieve instantly.
Fixed path: ~/Documents/brainrepo/
This is not configurable. All brain data lives here.
Before any action, check if brainrepo is initialized:
~/Documents/brainrepo/ exists with expected structure (Inbox/, Projects/, Areas/)Triggers automatically on first interaction, or when user says "set up brainrepo":
~/Documents/brainrepo/mkdir -p <path>/{Inbox,Projects,Areas/personal-growth,Areas/family,Notes,Resources,Journal,People,Tasks,Archive}assets/templates/:Tasks/index.md ā task hubAreas/personal-growth/index.md ā personal growth areaAreas/family/index.md ā family areacd <path> && git init && git add -A && git commit -m "init: brainrepo"DUMP ā PROCESS ā RETRIEVE
brainrepo/
āāā Inbox/ # Quick capture (clear daily)
āāā Projects/ # Active work with deadlines
āāā Areas/ # Ongoing responsibilities (no deadline)
āāā Notes/ # Permanent atomic knowledge
āāā Resources/ # External links, articles, references
āāā Journal/ # Daily notes (YYYY-MM-DD.md)
āāā People/ # One note per person
āāā Tasks/ # Centralized task tracking
āāā Archive/ # Completed projectsSee references/structure.md for detailed breakdown.
| Type | Destination | Example |
|------|-------------|---------|
| Quick thought | Inbox/ | "Maybe we should..." |
| Decision made | Inbox/ or Notes/ | "Decided to use Next.js" |
| Person info | People/ | New contact or update |
| Project update | Projects/ | Meeting notes, progress |
| Task/Todo | Tasks/index.md | "Need to finish X" |
| Link/Article | Resources/ or Inbox/ | URL with context |
| Personal growth | Areas/personal-growth/ | Health, habits, learning |
| Family info | Areas/family/ | Important dates, notes |
Every note uses minimal frontmatter:
---
created: YYYY-MM-DD
tags: [tag1, tag2]
related: ["[[Other Note]]"]
---
# Title
Content here. Link to [[Related Notes]] freely.Use templates from assets/templates/ when creating new notes.
Inbox/Process Inbox/:
Journal/YYYY-MM-DD.md with summarygit commit -am "daily processing"Tasks/index.mdSee references/workflows.md for detailed workflows.
| User says | Action |
|-----------|--------|
| "Set up brainrepo" | Run onboarding, create structure |
| "Save this: [text]" | Capture to Inbox/ |
| "New project: [name]" | Create Projects/name/ with template |
| "Add person: [name]" | Create People/name.md with template |
| "What do I know about X?" | Search & retrieve |
| "Daily review" | Process Inbox/, update Journal/ |
| "Weekly review" | Full system review |
Use [[wiki-links]] to connect notes:
Met with [[People/john]] about [[Projects/acme/index|ACME Project]].
Relevant insight: [[Notes/negotiation-tactics]]| Projects | Areas |
|----------|-------|
| Have deadlines | No end date |
| Can be "done" | Maintained forever |
| Specific outcome | Standard to uphold |
kebab-case/kebab-case.mdYYYY-MM-DD.mdfirstname-lastname.mdGenerated Mar 1, 2026
A freelance designer uses BrainRepo to capture client meeting notes, project updates, and resource links in the Inbox folder. During evening reviews, they organize these into specific project folders and update task lists, ensuring deadlines are tracked and knowledge is retrievable for future projects.
A graduate student employs BrainRepo to store research notes, article summaries, and experimental data in the Notes and Resources folders. They use daily reviews to process Inbox items and weekly reviews to maintain project timelines, facilitating efficient thesis writing and literature retrieval.
An individual uses BrainRepo to log health metrics, diet notes, and exercise routines in the Areas/personal-growth folder. They capture daily thoughts in the Journal and process them during reviews, creating a structured personal knowledge base for long-term wellness management.
A startup founder captures business decisions, customer feedback, and operational tasks in BrainRepo's Inbox. They organize these into Projects for active initiatives and Areas for ongoing responsibilities like marketing, using weekly reviews to archive completed projects and update task lists.
Offer a free basic version of BrainRepo with core features like capture and organization, while charging for advanced integrations, cloud sync, and AI-powered search. Revenue comes from monthly subscriptions, targeting individual users and small teams seeking enhanced productivity tools.
Sell customized versions of BrainRepo to large organizations, including features like team collaboration, security compliance, and integration with existing systems like CRM or project management software. Revenue is generated through annual licenses and support contracts.
Provide services to help businesses implement BrainRepo, including setup, workflow customization, and employee training. Revenue comes from one-time consulting fees and ongoing support packages, leveraging the tool's structure to improve organizational knowledge management.
š¬ Integration Tip
Integrate BrainRepo with AI agents by ensuring they can read and write markdown files, and use the fixed path for seamless data access across tools like Obsidian or VS Code.
Work with Obsidian vaults (plain Markdown notes) and automate via obsidian-cli.
Create, search, and manage Bear notes via grizzly CLI.
Track water and sleep with JSON file storage
Notion API for creating and managing pages, databases, and blocks.
Smart ClawdBot documentation access with local search index, cached snippets, and on-demand fetch. Token-efficient and freshness-aware.
Work with Obsidian vaults as a knowledge base. Features: fuzzy/phonetic search across all notes, auto-folder detection for new notes, create/read/edit notes with frontmatter, manage tags and wikilinks. Use when: querying knowledge base, saving notes/documents, editing existing notes by user instructions.