create-segundo-cerebro

Bootstrap a new segundo cerebro vault with all dependencies in one command.

Overview

create-segundo-cerebro is an npm package that installs a complete segundo cerebro vault skeleton. It handles:

• Cloning the vault template from GitHub
• Running pi install -l for local Pi setup
• Initializing git with first commit
• Installing Obsidian plugins (if Obsidian CLI is available)

⚠️ Prerequisites (MUST be installed FIRST)

This script does NOT auto-install system tools. Install these before running:

| Tool | Required | Install | |------|----------|---------| | Git | Yes | git-scm.com | | Node.js 18+ | Yes | nodejs.org | | npm | Yes | Comes with Node.js | | Pi agent | Recommended | npm install -g @mariozechner/pi-coding-agent | | Obsidian | Optional | obsidian.md |

Why no auto-install? Auto-installing system tools can break existing installations and cause timeouts. It's safer and more reliable to let users install their own tools.

Usage

Quick start

# 1. Install prerequisites (see above)
# 2. Then run:
npx create-segundo-cerebro my-vault
cd my-vault

What it does

1. Clones the vault template to ./my-vault
2. Checks that prerequisites are installed
3. Runs pi install -l for local Pi setup (if Pi is installed)
4. Installs Obsidian plugins via CLI (if Obsidian is installed)
5. Initializes git with first commit
6. Shows next steps

Options

npx create-segundo-cerebro <project-name> [options]

Options:
  -y, --yes     Skip confirmation prompts
  -V, --version Show version number
  -h, --help    Show help

Output Example

🚀 create-segundo-cerebro v1.0.1
Starting vault bootstrap...

📦 Step 1/4: Cloning vault template...
  ✓ Template cloned

🔍 Step 2/4: Checking prerequisites...
  ✓ Git found
  ✓ Node.js found
  ✓ Pi agent found
  ✓ Obsidian CLI found

🔧 Step 3/4: Running pi install -l...
  ✓ pi install -l completed

🔌 Step 4/4: Installing Obsidian plugins...
    ✓ obsidian-calendar-plugin
    ✓ obsidian-templater-plugin
    ⚠ obsidian-dataview — could not install via CLI

📝 Step 5/4: Initializing git repository...
  ✓ Git initialized with first commit

✅ Vault created successfully!

📋 Next steps:
  1. cd my-vault
  2. Open in Obsidian: obsidian my-vault
  3. Start your second brain journey!

Troubleshooting

"Git not found" / "Node.js not found"

Install the missing prerequisite. See the prerequisites table above.

"Directory already exists"

Choose a different project name or remove the existing directory.

"Could not connect to GitHub"

Check your internet connection and try again.

"pi install -l" warning

This is usually safe to ignore. The vault structure is still valid.

"Obsidian plugins could not install via CLI"

You can install plugins manually in Obsidian's settings. The vault works fine without them.

License

MIT