dotfiles

macOS の開発環境設定を管理するリポジトリ

目次

• クイックスタート
• Homebrew
• シェル
  • zsh
  • powerline-shell
• エディタ
  • Cursor
  • VSCode
  • Neovim
• rbenv
• Ruby Tools
• Utility
  • Raycast
• AIエージェント
  • セットアップ
  • 管理方針
    • rulesync で共通化
    • 個別管理
  • 管理構成
  • ディレクトリ構造

クイックスタート

• リポジトリをクローン

  git clone https://${GIT_USER_PRIVATE}:${GIT_TOKEN_PRIVATE}@github.com/${GIT_USER_PRIVATE}/dotfiles ~/dotfiles

• Homebrew をインストール（未インストール時）

  /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

• パッケージをインストール

  cd ~/dotfiles/homebrew
  brew bundle

• zsh を設定

  bash ~/dotfiles/zsh/install.sh
  source ~/.zshrc

• 👉詳細なセットアップは以下のセクションを参照すること

Homebrew

• インストール

  /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

• パッケージをまとめてインストール

  cd ~/dotfiles/homebrew
  brew bundle

• パッケージの確認と削除

  # 未インストールのパッケージをリスト表示
  brew bundle cleanup
  
  # 未インストールのパッケージを削除（確認ダイアログ付き）
  brew bundle cleanup --force

• アップデート

  brew update
  brew upgrade --cask --greedy
  brew bundle

シェル

zsh

• シェル設定をセットアップする

  bash ~/dotfiles/zsh/install.sh
  source ~/.zshrc

powerline-shell

• ターミナルのプロンプトをカスタマイズする

前提条件:

• Homebrew で font-hackgen がインストール済みであること
• git config user.name が設定済みであること（.config/zsh/env.zsh で定義可能）

セットアップ:

• フォントをセット (iTerm2 の場合)

  Preferences -> Profiles -> Text -> Font
  → 「HackGen35」を選択、font size は 16
  

• powerline-shell をインストール

  git clone https://github.com/b-ryan/powerline-shell
  cd powerline-shell
  python3 setup.py install

• 設定ファイルをリンク

  mkdir -p ~/.config/powerline-shell
  ln -sf ~/dotfiles/powerline-shell/config.json ~/.config/powerline-shell/config.json

エディタ

Cursor

• セットアップスクリプトを実行する

  bash ~/dotfiles/cursor/install.sh

VSCode

• セットアップスクリプトを実行する

  bash ~/dotfiles/vscode/install.sh

Neovim

• セットアップスクリプトを実行する

  bash ~/dotfiles/nvim/install.sh

rbenv

• Ruby 3.2.2 をインストール

  rbenv install 3.2.2
  rbenv global 3.2.2

• インストールされているバージョンを確認

  rbenv versions

Ruby Tools

• Ruby 関連のツール設定を目的ごとにディレクトリ分けして管理している

  ツール	説明
  ruby-lsp	Language Server Protocol
  rubocop	コード品質チェック
  solargraph	静的解析とコード補完

Utility

Raycast

• Raycast アプリの import 機能から設定ファイルを読み込む

AIエージェント

Cursor と Claude Code 向けのルール定義・スキル・スクリプトを統一管理する。

セットアップ

bash ~/dotfiles/agents/install.sh

管理方針

rulesync で共通化

以下は Cursor と Claude Code で共通の内容として管理：

対象	理由
rules/	コーディング規約・設計原則は両ツール共通
skills/	再利用可能なワークフローやパターンは両ツール共通
agents/	サブエージェント定義は両ツール共通

個別管理

上記以外（settings.json, scripts/ など）はツール固有の設定・実行環境として個別管理する。

管理構成

項目	説明
ソースコード	agents/.claude/ と agents/.cursor/
ビルドツール	Rulesync
設定ファイル	agents/rulesync.jsonc

ディレクトリ構造

Claude Code (~/.claude/)

パス	説明
rules/	プロジェクト固有のルール定義 (rulesync管理)
skills/	カスタムスキル定義 (rulesync管理)
agents/	サブエージェント定義 (rulesync管理)
settings.json	statusline、モデル設定など
settings.local.json	ローカル環境固有の設定
scripts/	statusline.sh などのカスタムスクリプト

Cursor (~/.cursor/)

パス	説明
rules/	プロジェクト固有のルール定義 (rulesync管理)
skills/	カスタムスキル定義 (rulesync管理)
agents/	サブエージェント定義 (rulesync管理)
scripts/	カスタムスクリプト