個人用のdotfilesリポジトリです。開発環境を効率的にセットアップするための設定ファイルを管理しています。
このリポジトリには、以下の開発ツールの設定が含まれています:
- Shell: zsh, bash
- Editor: Neovim (lazy.nvim), Vim (dein.vim)
- Terminal: tmux
- その他: Git, Karabiner
git clone https://github.com/winky/dotfiles.git ~/.dotfiles
cd ~/.dotfiles
make install-
基本設定のデプロイ
make deploy
-
設定ディレクトリのシンボリックリンク作成
make homeConfig
-
CLI ツールと言語ランタイムのインストール
make runtimes # make tools も先に走るターゲット 入れるもの 指定の場所 make tools固定バージョンの CLI ツール(今は asdf)を ~/.local/binにMakefileのTOOLSと<name>_version/<name>_urlmake runtimesasdf のプラグインとバージョン(Node.js など) .tool-versions(make deployで~/.tool-versionsにリンク)どちらも何度実行してもよく、入っているものは飛ばす。macOS でも Linux でも同じ。シェルの起動時には実行しない(ダウンロードに時間がかかるため)。
- asdf を
~/.local/binに置く理由:shims はnodeやnpxを呼ぶたびに PATH のasdfを実行する。Claude Code が起動する MCP サーバーや make のように zsh を通らない場面でも見つかるよう、固定のパスに先に置く。Homebrew と違ってバージョンも固定できる - ツールを足すとき:
TOOLSに名前を足し、<name>_versionと<name>_urlを書く。tar.gz の直下にバイナリがある配布物に対応する。<url>.md5があれば照合する - asdf が PATH に無い呼び出し元からは
make runtimes ASDF=/path/to/asdfで絶対パスを渡せる(既定は~/.local/bin/asdf)
- asdf を
- プラグインマネージャー: zinit
- プロンプト: カスタムテーマ
winky.zsh-theme - ディレクトリナビゲーション: zoxide(利用可能な場合)
- モダンなCLIツール (インストール時のみ alias 適用):
eza-lsの代替(アイコン、Git統合)bat-catの代替(シンタックスハイライト)ripgrep(rg) -grepの代替(高速検索)lazygit- Git TUI
- プラグインマネージャー: lazy.nvim
- カラースキーム: sainnhe/edge (Vim と共通)
- LSP: Neovim 0.11+ ネイティブLSP API
- 対応言語: Lua, Python, TypeScript/JavaScript, Go, PHP
- 補完: nvim-cmp + LuaSnip
- ファイル管理: nvim-tree.lua
- 検索: telescope.nvim
- ステータスライン: lualine.nvim
- Lint: nvim-lint
- その他:
- nvim-autopairs(自動ペア)
- Comment.nvim(コメント機能)
- indent-blankline.nvim(インデントガイド)
- 位置付け: Neovim が無い環境向けの最小フォールバック構成
- プラグインマネージャー: dein.vim
- カラースキーム: sainnhe/edge (Neovim と共通)
- 主要プラグイン:
- lightline.vim(ステータスライン)
- vim-fugitive(Git統合)
- vim-gitgutter(Git差分表示)
- vim-surround / vim-commentary(編集系)
- プラグインマネージャー: TPM (Tmux Plugin Manager)
- 設定: カスタムキーバインド、ペイン分割、セッション管理
複数の Claude Code セッションを tmux の 1 ウィンドウにタイル配置して監視するスクリプト (bin/claude-grid)。
claude-grid # セッション作成 & attach
claude-grid add [-h|-v] [dir] # dir (省略時カレント) で claude ペインを追加
# -h: 右に分割 / -v: 下に分割 / 省略時: tiled 自動配置
claude-grid pick [-h|-v] # ghq list -p | fzf でリポジトリを選んでペイン追加
claude-grid ls # グリッド内ペイン一覧方向 (-h / -v) を指定すると tiled 再配置をスキップし、アクティブペインを分割して手動レイアウトを維持する。以降に方向なしの add を実行すると tiled 自動配置に戻る点に注意。
エイリアス: cg (claude-grid) / cga (add) / cgah・cgav (add -h / -v) / cgp (pick) / cgph・cgpv (pick -h / -v) / cgl (ls)
- 全体を眺めて監視し、作業するペインは
prefix z(zoom) で全画面化、unzoom で監視に戻る - claude-config 側の hooks と連携し、ペイン枠にセッション状態が表示される: 青
▶= 実行中 / 赤●+ 赤背景 = 入力・許可待ち / 緑✔+ 緑背景 = 応答完了
- 設定:
config/git/config - 無視ファイル:
config/git/ignore - 便利なエイリアス: zsh/bashに多数のGitエイリアスを定義
.dotfiles/
├── .zsh/ # zsh設定ファイル
│ ├── _aliases.zsh # エイリアス定義
│ ├── _env.zsh # 環境変数
│ ├── _functions.zsh # カスタム関数
│ ├── _keybinds.zsh # キーバインド
│ ├── _completion.zsh # 補完設定
│ ├── themes/ # カスタムプロンプトテーマ
│ └── zinit.zsh # zinit設定
├── .vim/ # Vim設定
│ └── rc/ # dein.vimプラグイン設定
├── .tmux/ # tmux設定
│ └── plugins/ # TPMプラグイン
├── config/ # XDG Base Directory準拠の設定
│ ├── nvim/ # Neovim設定(lazy.nvim)
│ ├── git/ # Git設定
│ └── karabiner/ # Karabiner設定(macOS)
├── .zshrc # zshメイン設定
├── .vimrc # Vim/Neovim基本設定
├── .tmux.conf # tmux設定
└── Makefile # 管理用Makefile
💡 ヒント:
make helpを実行すると、利用可能なすべてのMakefileコマンドとその説明が表示されます。
config/nvim/lua/plugins/ ディレクトリに新しい .lua ファイルを作成します。
例: config/nvim/lua/plugins/my-plugin.lua
return {
"username/plugin-name",
config = function()
-- 設定
end,
}.vim/rc/dein.toml に追加します。
- zsh:
.zsh/_aliases.zshを編集 - bash:
.bashrcを編集
.zsh/themes/winky.zsh-theme を編集
cd ~/.dotfiles
make updateまたは手動で:
git pull origin master
git submodule update --init --recursiveこのリポジトリには bin/dotfiles-doctor が同梱されています。シンボリックリンク
の整合性、シェル/設定の構文、プラグインの活性、起動時間などを点検し、Markdown
レポートを生成します。任意で Claude API による近代化レビューも追加できます。
./bin/dotfiles-doctor # tmp/doctor-report.md を生成
./bin/dotfiles-doctor --no-ai # AI レビューをスキップ
./bin/dotfiles-doctor --json # JSON のみ stdout に出力
./bin/dotfiles-doctor --output PATH # 出力先を指定| ID | 内容 |
|---|---|
| 01-symlinks | このリポジトリ向け dead symlink の検出 |
| 02-shell-syntax | .zshrc / .zsh/*.zsh の zsh -n 構文チェック |
| 03-shell-startup | zsh -i -c exit の起動時間ベンチ (3回中央値) |
| 04-tmux-syntax | .tmux.conf の起動テスト |
| 05-plugins-status | zinit / lazy.nvim / dein / TPM のプラグインを gh api で点検 (archived / 2年放置) |
| 06-referenced-bins | 必須/任意コマンドの存在確認 |
| 07-git-config | config/git/config の credential helper 実体確認 |
.github/workflows/doctor.yml が毎月 1 日 (UTC 0:00 / JST 9:00) に自動実行され、
dotfiles-health ラベルを持つ単一の Issue を upsert します。Issue が増殖しない
設計です。
必要な Secret / Variable:
ANTHROPIC_API_KEY(Secret, 任意): AI レビューを有効にする場合のみANTHROPIC_MODEL(Variable, 任意): デフォルトはclaude-haiku-4-5-20251001
- このリポジトリは個人用の設定です
- 環境によっては一部のツールが利用できない場合があります(条件付きロードで対応)
- Neovim 0.11以上を推奨
- macOSとLinuxの両方で動作しますが、一部の設定はmacOS専用です(Karabinerなど)
Private repository