Your personal knowledge base, maintained by AI. Just say what you want to save — AI handles the rest.

🇨🇳 中文说明 · Twitter: @zhiwehu

In OpenClaw or Claude Code, just say:

Please install Second Brain from https://github.com/zhiwehu/second-brain

AI will automatically: clone → setup → inject → done.

7 content types: Tweets · Articles · Images · Voice · Files · Chats · Tasks

You say "save this" → AI processes → Stored in your knowledge base
         ↓
    Raw file saved (images, audio, documents)
         ↓
    AI extracts key information
         ↓
    Classified into PARA (Projects/Areas/Resources/Archives)
         ↓
    Written to wiki + cross-linked + logged

PARA Classification: AI automatically decides where content belongs:

• Projects — Active goals with deadlines
• Areas — Ongoing responsibilities
• Resources — Topics you're interested in
• Archives — Completed or abandoned items

Layer 1: raw/          → Original files (images, audio, tweets)
Layer 2: wiki/         → Processed knowledge (summaries, links)
Layer 3: wiki/schema/  → Concepts & relationships (weekly compile)

After installation, just talk to AI:

Save this to my second brain: [content]
Save this link to second brain: [URL]
Search my second brain for AI related content
Save that screenshot to second brain
Save today's meeting notes to second brain

Please upgrade my second brain

Run the second brain health check

Or manually:

./tools/doctor.sh
./tools/doctor.sh --fix  # auto-fix issues

Set up automatic reminders using OpenClaw cron:

# Daily todo reminder (9 AM)
openclaw cron add \
  --name "Second Brain - Daily Review" \
  --cron "0 9 * * *" \
  --tz "Asia/Shanghai" \
  --session isolated \
  --message "Read wiki/log.md and list all pending tasks for today" \
  --announce --channel <your-channel> --to "<target>"

# Weekly health check (Sunday 8 PM)
openclaw cron add \
  --name "Second Brain - Weekly Check" \
  --cron "0 20 * * 0" \
  --tz "Asia/Shanghai" \
  --session isolated \
  --message "Run ./tools/doctor.sh and report the results" \
  --announce --channel <your-channel> --to "<target>"

Layer 3 of the architecture — extract concepts and relationships from your wiki:

Compile my second brain schema

This extracts:

• Concepts (people, products, methods, technologies)
• Relations (influences, supports, uses, part_of)
• Properties (domain, type, first_seen)

Run manually when your wiki accumulates content:

./tools/compile_schema.sh --status  # check status
./tools/compile_schema.sh --incremental  # compile new content only
./tools/compile_schema.sh --full  # full recompile

Second Brain uses a dual-directory architecture:

second-brain-source/    # Source code directory (cloned from GitHub)
├── tools/             # Utility scripts
├── process/           # AI processing templates
├── setup.sh          # Installation script
├── upgrade.sh        # Upgrade script
└── CLAUDE.md         # AI config

~/second-brain/        # Data directory (your second brain)
├── .git/              # Independent git repo (manage with git)
├── wiki/              # Your knowledge base
│   ├── projects/      #   Active projects
│   ├── areas/         #   Ongoing responsibilities
│   ├── resources/     #   Interesting topics
│   ├── archives/      #   Completed/archived
│   └── schema/        #   Concepts & relationships
├── raw/               # Raw materials (images/audio/files)
└── ...                # Copied code files

Key Points:

• second-brain-source/ is clean source code, manage with git for your fork
• ~/second-brain/ is your data, with independent git for your knowledge base
• Run setup.sh and it automatically creates your data directory

Git Management:

# Manage your data
cd ~/second-brain
git status
git add .
git commit -m 'Added new content'
git push            # Push to your private GitHub/Gitee

# Upgrade source code
cd second-brain-source
git fetch upstream
./upgrade.sh

Use Obsidian to visually browse your wiki:

1. Open Obsidian
2. Click "Open Vault" → select ~/second-brain/ (your data directory)
3. Obsidian will display all .md files in wiki/
4. Non-markdown files (.sh, images in raw/, etc.) are automatically hidden

Recommended Obsidian plugins:

• Dataview — Query wiki data with dynamic tables
• Templater — Automated templates
• Obsidian Git — Auto-backup to Git (push to your private repo)

Tip: Both OpenClaw/Claude Code and Obsidian work in your data directory (~/second-brain/). OpenClaw manages AI processing, Obsidian provides the visual graph view.

Install these for full functionality:

agent-reach install:

Please install agent-reach: https://raw.githubusercontent.com/Panniantong/agent-reach/main/docs/install.md

qmd setup:

npm install -g @tobilu/qmd
qmd collection add $(pwd)/wiki --name second-brain
qmd embed

Convert web articles to markdown with one click:

1. Install Obsidian Web Clipper extension
2. Configure to save to second-brain/raw/articles/
3. Clip articles while browsing → they go directly to raw/

This makes ingestion much faster — clip first, process later.

After clipping an article with images:

1. In Obsidian Settings → Files and links → set "Attachment folder path" to raw/assets/
2. Bind hotkey: Search "Download" → "Download attachments for current file"
3. After clipping, press the hotkey → all images download locally

This ensures LLMs can view images directly from local files.

Use Marp to create presentations from wiki content:

1. Install Marp plugin in Obsidian
2. Write markdown with Marp syntax
3. Export to PPT/PDF

Example:

---
marp: true
theme: default
---

# My Presentation

- Point 1
- Point 2

This lets you generate slide decks directly from your accumulated knowledge.

Q: Where is my data stored? A: In ~/second-brain/wiki/ and ~/second-brain/raw/. Your data is managed with an independent git repository, pushable to your private GitHub/Gitee.

Q: Why separate source code and data? A: This way you can upgrade code without affecting your data. Source code in second-brain-source/, your data in ~/second-brain/.

Q: Do I need to maintain it manually? A: No. AI automatically updates index and log. Just regularly git push to backup your data.

Q: How is this different from regular notes? A: Second Brain automatically classifies using PARA, remembers relationships between content, and runs regular health checks.

Q: How do I upgrade? A: Download the latest source to second-brain-source/, then run ./upgrade.sh. Your wiki/ and raw/ data will not be lost.

Q: What is Schema and when should I compile it? A: Schema is Layer 3 — it extracts concepts and relationships from your wiki content. Compile when your wiki has accumulated significant content (weekly recommended). Use @compile command or run ./tools/compile_schema.sh --incremental.

Want to stay updated with the latest changes?

If you fork this repo, you can receive updates from the original:

Click the "Fork" button on github.com/zhiwehu/second-brain

git clone https://github.com/YOUR_USERNAME/second-brain.git second-brain-source
cd second-brain-source

./setup.sh

This will:

1. Create your data directory (~/second-brain/)
2. Initialize git repo to manage your data
3. Optional: push to your private GitHub

git remote add upstream https://github.com/zhiwehu/second-brain.git

When updates are available, run:

cd second-brain-source
./upgrade.sh

This fetches latest code from original repo and overlays to your data directory. Your wiki/ and raw/ data stays safe.

If you fix a bug or add a feature, submit a Pull Request on GitHub!

• Karpathy's LLM Wiki
• PARA Method — Forte Labs

For manual installation or contributing, see README_DEV.md.

For Chinese version, see README_ZH.md / README_DEV_ZH.md.