# Brain Install

You are reading this because a user wants to set up a **brain** — a personal knowledge base that persists across sessions.

Follow these steps exactly. Do not skip steps. Do not improvise.

Source: https://github.com/giobi/brain-template

## Step 0: Preflight

```bash
which git || echo "NO_GIT"
touch .write-test && rm .write-test && echo "WRITE_OK" || echo "NO_WRITE"
ls boot/brain.md 2>/dev/null && echo "BRAIN_EXISTS" || echo "FRESH"
```

If `NO_GIT`: tell the user git is required and stop.
If `NO_WRITE`: tell the user the directory is not writable and stop.
If `BRAIN_EXISTS`: tell the user a brain already exists here. Ask if they want to update skills only (`/brain update`) or start fresh. Do NOT overwrite an existing brain without explicit confirmation.

## Step 1: Clone the template

If the directory is empty (or the user confirmed fresh install):

```bash
git clone https://github.com/giobi/brain-template.git .brain-tmp
cp -r .brain-tmp/boot ./boot
cp -r .brain-tmp/wiki ./wiki
cp -r .brain-tmp/diary ./diary
cp -r .brain-tmp/todo ./todo
cp -r .brain-tmp/inbox ./inbox
cp -r .brain-tmp/public ./public
cp -r .brain-tmp/storage ./storage
cp .brain-tmp/.gitignore ./.gitignore 2>/dev/null
rm -rf .brain-tmp
```

If git clone fails (no internet, firewall, etc.), try the fallback:

```bash
curl -sL https://abchat.it/latest.zip -o .brain-tmp.zip
unzip -q .brain-tmp.zip -d .brain-tmp
cp -r .brain-tmp/boot ./boot
cp -r .brain-tmp/wiki ./wiki
cp -r .brain-tmp/diary ./diary
cp -r .brain-tmp/todo ./todo
cp -r .brain-tmp/inbox ./inbox
cp -r .brain-tmp/public ./public
cp -r .brain-tmp/storage ./storage
cp .brain-tmp/.gitignore ./.gitignore 2>/dev/null
rm -rf .brain-tmp .brain-tmp.zip
```

## Step 2: Git init

```bash
git init 2>/dev/null
git add -A
git commit -m "Brain initialized from template"
```

## Step 3: Auto-detect environment

Create `boot/local.yaml` with detected capabilities:

```bash
cat > boot/local.yaml << YAMLEOF
platform: $([ -f /.dockerenv ] && echo "container" || echo "local")
hostname: $(hostname)
os: $(uname -s | tr '[:upper:]' '[:lower:]')
arch: $(uname -m)

services:
  git: $(which git >/dev/null 2>&1 && echo true || echo false)
  python3: $(which python3 >/dev/null 2>&1 && echo true || echo false)
  node: $(which node >/dev/null 2>&1 && echo true || echo false)
  docker: $(which docker >/dev/null 2>&1 && echo true || echo false)
  tmux: $(which tmux >/dev/null 2>&1 && echo true || echo false)
  curl: $(which curl >/dev/null 2>&1 && echo true || echo false)
YAMLEOF
```

## Step 4: Install base skills

```bash
mkdir -p .claude/skills wiki/skills
```

Install the brain package manager, then use it to install the starter skills:

```bash
curl -sL https://raw.githubusercontent.com/giobi/claude-skills/main/plugins/brain/skills/brain/SKILL.md \
  -o .claude/skills/brain/SKILL.md
mkdir -p .claude/skills/brain
```

Create the skill registry:

```bash
cat > wiki/skills/.index.yaml << 'EOF'
registry: giobi/claude-skills
installed:
  brain: true
EOF
```

Now install the starter pack:

```bash
# The /brain skill is now available — use it to install the rest
```

Tell the agent to run: `/brain install brainstorm`, `/brain install devil`, `/brain install save`, `/brain install bye`

## Step 5: Commit and hand off

```bash
git add -A
git commit -m "Brain setup complete — skills installed, ready for onboarding"
```

## Step 6: Wake up

This is the most important step.

**Read `boot/brain.md` now.** Read it completely. Then read `boot/soul.md` and `boot/user.md`.

You will notice that `soul.md` and `user.md` are templates — they have placeholder fields, not real data. This means the brain has just been born and **onboarding has not happened yet**.

Your job now:
1. Introduce yourself to the user — you are their new AI assistant
2. Explain briefly what just happened (a brain was set up, it's their personal knowledge base)
3. Start the onboarding: ask who they are, what they do, what they'd like to use this for
4. Fill in `soul.md` and `user.md` based on the conversation
5. After onboarding, suggest a first concrete exercise based on what you learned about them

**Do not wait for instructions. Read brain.md and start.**