setup

Your task

Install claudefiles by reading the manifest and deploying everything to the target directory.

Step 1: Read the manifest

Read claudefiles.yaml in this repo root. It declares what gets installed and how.

Step 2: Ask install target

Ask the user:

• Global (recommended): Install to ~/.claude/ — available in all Claude Code sessions
• Local: Install to ./.claude/ in the current project only

Step 3: Detect platform

Determine if running on macOS or Linux to resolve the {{sound_player}} template variable:

• macOS → afplay
• Linux → aplay

uname -s

Step 4: Create target directories

mkdir -p <target>/skills
mkdir -p <target>/commands
mkdir -p <target>/sounds
mkdir -p <target>/hooks

Step 5: Copy files

Copy the contents declared in install.targets:

# Skills — copy each skill directory
cp -R skills/* <target>/skills/

# Commands — copy all .md files
cp commands/*.md <target>/commands/

# Sounds — copy all files
cp sounds/* <target>/sounds/

# Hooks — copy all hook scripts and make executable
cp hooks/* <target>/hooks/
chmod +x <target>/hooks/*

Step 6: Deploy nvim plugin overlays (skip per-file if exists)

Overlay dotfiles/nvim/lua/plugins/ onto ~/.config/nvim/lua/plugins/. The nvim_plugins target in the manifest has skip_if_exists: true at the file level — never overwrite an existing plugin file the user already customized.

mkdir -p ~/.config/nvim/lua/plugins
for src in dotfiles/nvim/lua/plugins/*; do
  name=$(basename "$src")
  dest="$HOME/.config/nvim/lua/plugins/$name"
  if [ -e "$dest" ]; then
    echo "nvim plugin $name already exists — skipping"
  else
    cp "$src" "$dest"
    echo "nvim plugin $name installed"
  fi
done

Record per-file outcomes for the summary.

Step 7: Smart-merge global CLAUDE.md

Deploy the global agent directives to <target>/CLAUDE.md using a smart-merge strategy:

1. Read dotfiles/CLAUDE.md from this repo (the source directives)
2. If <target>/CLAUDE.md already exists and is non-empty: a. Back it up: cp <target>/CLAUDE.md <target>/CLAUDE.md.backup b. Read the existing CLAUDE.md c. Smart-merge: Compare by section header (## headings). For each section in the source:
   • If the section doesn't exist in the target → append it
   • If the section exists in the target → keep the target's version (user customizations win) d. Preserve any sections in the target that don't exist in the source (user's custom sections)
3. If <target>/CLAUDE.md doesn't exist or is empty, copy the source as-is