setup-guide

claude-brain セットアップガイド

claude-brain のインストールを対話形式で順番に進めるスキル。 各ステップで「何をするのか」「なぜ必要なのか」を説明し、ユーザーの入力を待ってから次に進む。

進め方

• ユーザーの環境（OS、Node バージョン管理ツール、既存の Vault の有無）を最初にヒアリングする
• 各ステップはユーザーの「できた」「次へ」等の確認を待ってから進む
• エラーが出た場合はトラブルシューティングを行う
• スキップ可能なステップは明示する

ステップ一覧

Step 0: 環境確認

以下をユーザーにヒアリングまたは自動検出する:

1. OS: macOS / Linux / WSL のどれか
2. Node.js: node --version を実行して 18+ か確認。未インストールならインストール案内
3. Git: git --version を確認
4. jq: jq --version を確認。なければ brew install jq 等を案内
5. Claude Code: claude --version を確認。Max プランかどうかはユーザーに聞く
6. Obsidian: インストール済みかユーザーに聞く（コマンドでは確認できない）
7. Node バージョン管理ツール: Volta / mise / nvm / fnm / asdf / なし のどれか

結果をまとめて表示し、問題があれば解決してから次に進む。

✅ macOS 15.2
✅ Node.js v22.0.0 (Volta)
✅ Git 2.44.0
✅ jq 1.7.1
✅ Claude Code 1.x (Max プラン)
⚠️ Obsidian 未確認 → https://obsidian.md/ からインストールしてください

Step 1: Vault の作成と Git 接続 (ユーザー作業)

何をするか: Obsidian で新しい Vault を作り、GitHub Private リポジトリと接続する。

なぜ必要か: claude-brain は Obsidian Vault の中にセッションログと Wiki を保存する。Git で管理することで、複数マシン間の同期とバックアップが自動化される。

手順:

1. Obsidian を開き「Create new vault」を選択
   • 名前: main-claude-brain（任意）
   • 場所: ~/claude-brain/（推奨。~/Documents/ は macOS の TCC でバックグラウンドアクセスがブロックされるため避ける）
2. GitHub で Private リポジトリを作成
3. Vault ディレクトリで Git を初期化

ユーザーの GitHub CLI の有無に応じてコマンドを出し分ける:

# gh CLI がある場合（簡単）
cd ~/claude-brain/main-claude-brain
gh repo create claude-brain --private --source=. --push

# gh CLI がない場合（手動）
cd ~/claude-brain/main-claude-brain
git init
git remote add origin [email protected]:<USERNAME>/claude-brain.git
git add -A && git commit -m "initial" && git push -u origin main

確認: git remote -v で origin が設定されていることを確認する。

Step 2: 環境変数の設定

何をするか: OBSIDIAN_VAULT 環境変数に Vault のパスを設定する。

なぜ必要か: claude-brain の全スクリプトがこの変数を参照して Vault の場所を知る。Hook スクリプトも Claude Code から実行される際にこの変数を使う。

手順: ユーザーのシェル（zsh / bash）を検出して適切なファイルに追記する。

# ~/.zshrc（macOS のデフォルト）または ~/.bashrc に追記
echo 'export OBSIDIAN_VAULT="$HOME/claude-brain/main-claude-brain"' >> ~/.zshrc
source ~/.zshrc