✓ Verified 📁 File Management ✓ Enhanced Data

Brainrepo

Your personal knowledge repository — capture, organize, and retrieve.

Rating
4.4 (441 reviews)
Downloads
14,344 downloads
Version
1.0.0

Overview

Your personal knowledge repository — capture, organize, and retrieve.

Complete Documentation

View Source →

BrainRepo

Your personal knowledge repository. Capture fast, organize automatically, retrieve instantly.

Brain Location

Fixed path: ~/Documents/brainrepo/

This is not configurable. All brain data lives here.

First Run Check

Before any action, check if brainrepo is initialized:

  • Check if ~/Documents/brainrepo/ exists with expected structure (Inbox/, Projects/, Areas/)
  • If NOT found → Run onboarding automatically
  • If found → Proceed with user request

Onboarding

Triggers automatically on first interaction, or when user says "set up brainrepo":

  • Create brain at ~/Documents/brainrepo/
  • Create the folder structure:
bash
mkdir -p <path>/{Inbox,Projects,Areas/personal-growth,Areas/family,Notes,Resources,Journal,People,Tasks,Archive}
  • Create initial files from templates in assets/templates/:
  • Tasks/index.md — task hub
  • Areas/personal-growth/index.md — personal growth area
  • Areas/family/index.md — family area
  • Initialize git (optional):
bash
cd <path> && git init && git add -A && git commit -m "init: brainrepo"
  • Confirm setup and show quick start commands

Core Concept

DUMP → PROCESS → RETRIEVE

  • Dump — Capture everything to Inbox/ (don't organize yet)
  • Process — Evening review: Inbox → permanent home
  • Retrieve — Ask AI to find anything

Repository Structure

text
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 projects

See references/structure.md for detailed breakdown.

Capture Rules

What to Capture (Immediately)

TypeDestinationExample
Quick thoughtInbox/"Maybe we should..."
Decision madeInbox/ or Notes/"Decided to use Next.js"
Person infoPeople/New contact or update
Project updateProjects//Meeting notes, progress
Task/TodoTasks/index.md"Need to finish X"
Link/ArticleResources/ or Inbox/URL with context
Personal growthAreas/personal-growth/Health, habits, learning
Family infoAreas/family/Important dates, notes

What NOT to Capture

  • Casual chat without information value
  • Temporary queries ("what time is it")
  • Information easily searchable online

Note Format

Every note uses minimal frontmatter:

markdown
---
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.

Daily Workflow

During Day

  • Dump everything to Inbox/
  • Don't organize — just capture

Evening (5-10 min)

Process Inbox/:
  • Each item → permanent home or delete
  • Update Journal/YYYY-MM-DD.md with summary
  • git commit -am "daily processing"

Weekly Review (Sunday, 15 min)

  • Review all Projects/ — still active?
  • Check Areas/ — anything neglected?
  • Move completed projects to Archive/
  • Update Tasks/index.md
See references/workflows.md for detailed workflows.

Commands

User saysAction
"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

Linking

Use [[wiki-links]] to connect notes:

markdown
Met with [[People/john]] about [[Projects/acme/index|ACME Project]].
Relevant insight: [[Notes/negotiation-tactics]]

Projects vs Areas

ProjectsAreas
Have deadlinesNo end date
Can be "done"Maintained forever
Specific outcomeStandard to uphold

File Naming

  • Folders: kebab-case/
  • Files: kebab-case.md
  • Dates: YYYY-MM-DD.md
  • People: firstname-lastname.md

References

Installation

Terminal bash

openclaw install brainrepo
    
Copied!

💻Code Examples

mkdir -p <path>/{Inbox,Projects,Areas/personal-growth,Areas/family,Notes,Resources,Journal,People,Tasks,Archive}

mkdir--p-pathinboxprojectsareaspersonal-growthareasfamilynotesresourcesjournalpeopletasksarchive.txt
3. Create initial files from templates in `assets/templates/`:
   - `Tasks/index.md` — task hub
   - `Areas/personal-growth/index.md` — personal growth area
   - `Areas/family/index.md` — family area

4. Initialize git (optional):

cd <path> && git init && git add -A && git commit -m "init: brainrepo"

cd-path--git-init--git-add--a--git-commit--m-init-brainrepo.txt
5. Confirm setup and show quick start commands

## Core Concept

**DUMP → PROCESS → RETRIEVE**

1. **Dump** — Capture everything to Inbox/ (don't organize yet)
2. **Process** — Evening review: Inbox → permanent home
3. **Retrieve** — Ask AI to find anything

## Repository Structure

└── Archive/ # Completed projects

-archive--completed-projects.txt
See [references/structure.md](references/structure.md) for detailed breakdown.

## Capture Rules

### What to Capture (Immediately)

| 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/<name>/` | 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 |

### What NOT to Capture

- Casual chat without information value
- Temporary queries ("what time is it")
- Information easily searchable online

## Note Format

Every note uses minimal frontmatter:

Content here. Link to [[Related Notes]] freely.

content-here-link-to-related-notes-freely.txt
Use templates from `assets/templates/` when creating new notes.

## Daily Workflow

### During Day
- Dump everything to `Inbox/`
- Don't organize — just capture

### Evening (5-10 min)
Process Inbox/:
1. Each item → permanent home or delete
2. Update `Journal/YYYY-MM-DD.md` with summary
3. `git commit -am "daily processing"`

## Weekly Review (Sunday, 15 min)

1. Review all Projects/ — still active?
2. Check Areas/ — anything neglected?
3. Move completed projects to Archive/
4. Update `Tasks/index.md`

See [references/workflows.md](references/workflows.md) for detailed workflows.

## Commands

| 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 |

## Linking

Use `[[wiki-links]]` to connect notes:
example.txt
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 projects
example.md
---
created: YYYY-MM-DD
tags: [tag1, tag2]
related: ["[[Other Note]]"]
---

# Title

Content here. Link to [[Related Notes]] freely.

Tags

#notes_and-pkm

Quick Info

Category File Management
Model Claude 3.5
Complexity One-Click
Author codezz
Last Updated 3/10/2026
🚀
Optimized for
Claude 3.5
🧠

Ready to Install?

Get started with this skill in seconds

openclaw install brainrepo