Configuration

Configure Brain OS settings, installation modes, and manage your installation.

Vault path

The only required configuration is your vault path. After installing Brain OS, open ~/.brain-os/brain-os.config.md and set vault_path to your Obsidian vault location:

vault_path: /path/to/your/obsidian/vault

Every skill reads this file to locate your vault. Without it, no skills will work.

Installation modes

One-line installer (recommended)

The default install clones Brain OS to ~/.brain-os and symlinks all 25 skills into ~/.claude/skills/:

curl -sSL https://raw.githubusercontent.com/sonthanh/brain-os-plugin/main/skills.sh | bash

After install, set your vault path in ~/.brain-os/brain-os.config.md.

Selective install

Install only the skills you need by passing skill names to the installer:

curl -sSL https://raw.githubusercontent.com/sonthanh/brain-os-plugin/main/skills.sh | bash -s self-learn audit today

You can install any combination of the 25 available skills.

Plugin mode (local development)

If you have cloned the repository locally, you can run Brain OS as a Claude Code plugin directly:

cc --plugin-dir ~/brain-os-plugin

This loads skills from your local clone without symlinking them.

Marketplace

Install through the Claude Code marketplace:

/plugin marketplace add sonthanh/brain-os-marketplace
/plugin install brain-os@brain-os-marketplace

Updating Brain OS

Via Claude Code

/plugin update brain-os

Manual git pull

cd ~/.brain-os && git pull

Uninstalling

To remove all Brain OS skill symlinks from ~/.claude/skills/:

curl -sSL https://raw.githubusercontent.com/sonthanh/brain-os-plugin/main/skills.sh | bash -s -- --uninstall

If you installed locally, you can also run:

./install.sh --uninstall

Uninstalling removes the symlinks only. Your vault and its contents are never modified.

Available skills

To see all 25 skills and which ones are currently installed, run:

Remote

curl -sSL https://raw.githubusercontent.com/sonthanh/brain-os-plugin/main/skills.sh | bash -s -- --list

Local install

./install.sh --list

Installed skills are marked with * in the output.

Expected vault structure

Brain OS expects your Obsidian vault to follow this layout:

your-vault/
├── context/          # Who you are, business, goals, ICP, brand
├── business/         # Projects, tasks, intelligence, departments
├── personal/         # Research, people, resources, inbox
├── thinking/         # Ideas, patterns, reflections, connections
├── knowledge/        # Books, articles, raw input
│   ├── raw/          # Unprocessed book extractions
│   └── books/        # Structured book notes
├── daily/            # Daily notes, handovers
└── private/          # Git-ignored confidential data

If your vault uses a different structure, daily operations and thinking skills will still work. The structure matters most for the knowledge pipeline skills (/self-learn, /ingest, /absorb).