dotfiles

個人用 dotfiles リポジトリ。macOS / Linux (Ubuntu) / WSL 対応。GitHub Codespaces での利用を主軸に設計。

クイックスタート

# 新規マシン
curl -fsSL https://raw.githubusercontent.com/coil398/dotfiles/master/etc/init.sh | sh

# Codespaces（install.sh が自動実行される）
bash install.sh

# シンボリックリンクの再展開のみ
sh etc/link.sh

特徴

• モダンツール置き換え — eza(ls), bat(cat), procs(ps), rg(grep), zoxide(cd), fzf
• Neovim — lazy.nvim + LSP (Mason) + Telescope + Treesitter + Copilot
• tmux — セッション自動保存/復元 (continuum + resurrect), fzf 連携, VS Code Dark テーマ
• ターミナル — WezTerm / Alacritty 対応、Cica + Nerd Font
• 冪等セットアップ — has() チェックで何度実行しても安全
• マルチアーキテクチャ — amd64 / arm64 両対応の Docker イメージ
• Claude Code 統合 — PIR² ワークフロー、カスタムエージェント・スキル

リポジトリ構造

dotfiles/
├── .zshrc                  # メイン zsh 設定（PATH, 補完, プロンプト, tmux 自動起動）
├── .zsh_alias              # エイリアス（モダンツール置き換え）
├── .zplugrc                # zplug プラグイン定義
├── .wezterm.lua            # WezTerm ターミナル設定
├── .vimrc                  # Vim 互換レイヤー
├── .tigrc                  # tig キーバインド
├── install.sh              # Codespaces 用セットアップ
├── mcp-servers.json        # MCP サーバー設定（Claude Code 用）
│
├── .config/
│   ├── nvim/               # Neovim 設定
│   │   ├── init.lua        # エントリ（OS 分岐, VSCode 検出）
│   │   └── lua/            # プラグイン, LSP, キーマップ, カラー, 自動コマンド
│   ├── alacritty/          # Alacritty 設定
│   ├── wezterm/            # WezTerm 追加設定
│   └── ...                 # efm-langserver, procs, gitui, pyright 等
│
├── .tmux/
│   └── .tmux.conf          # tmux 設定（Prefix: C-q, ステータスバー, プラグイン）
│
├── .claude/                # Claude Code カスタマイズ
│   ├── agents/             # PIR² エージェント定義
│   ├── skills/             # カスタムスキル（/pir2, /ir, /debug 等）
│   └── settings.json       # 権限設定
│
├── .devcontainer/
│   ├── Dockerfile          # Ubuntu 24.04 ベース, nvim・eza・procs 同梱
│   └── devcontainer.json   # Codespaces 設定
│
├── .github/workflows/
│   └── docker-publish.yml  # Docker イメージ自動ビルド & ghcr.io push
│
├── etc/
│   ├── init.sh             # 新規マシン初期セットアップ
│   ├── link.sh             # シンボリックリンク展開
│   ├── set.sh              # OS 別初期設定
│   ├── load.sh             # シェルユーティリティ関数ライブラリ
│   └── install/            # Homebrew, apt インストールスクリプト
│
├── bin/                    # tmux ステータスバー用ユーティリティ
├── .zsh/                   # Docker 補完, dircolors-solarized
└── options/                # clangd 用コンパイルフラグ

セットアップスクリプトの役割

スクリプト	用途
install.sh	Codespaces 専用。apt パッケージ・prebuilt バイナリ・zplug のインストール、symlink 展開、zsh デフォルト化、Neovim プラグインインストール
etc/init.sh	新規マシン向け。dotfiles を clone → set.sh → link.sh を実行
etc/link.sh	$HOME/dotfiles/.??* を $HOME/ に symlink。.claude/ は個別にリンク
etc/set.sh	OS 判定、GNOME Terminal カラー設定、ディレクトリ構成の整理
etc/load.sh	OS 判定 (is_osx, is_linux)、テキスト操作、出力ヘルパー等のシェル関数

シェルエイリアス（抜粋）

ls    → eza          # モダンな ls
cat   → bat          # シンタックスハイライト付き cat
ps    → procs        # モダンな ps
grep  → rg           # ripgrep
vim   → nvim
k     → kubectl
dc    → docker-compose
tf    → terraform

Neovim プラグイン構成

lazy.nvim で管理。主要プラグイン：

• LSP: Mason + nvim-lspconfig + nvim-cmp（補完）
• 検索: Telescope（files, grep, symbols, git）
• ファイル: Neo-tree
• Git: Neogit, Gitsigns
• UI: Lualine, Navic, WhichKey, Noice
• AI: Copilot.lua
• 構文: Treesitter
• 言語: Rust, Python, Go, Haskell 等

Docker / Codespaces

prebuilt イメージ ghcr.io/coil398/dotfiles:latest が利用可能。

他プロジェクトで使う場合：

{
  "image": "ghcr.io/coil398/dotfiles:latest",
  "remoteUser": "vscode"
}

イメージは master push 時と毎週月曜に自動ビルド（linux/amd64 + linux/arm64）。

Claude Code 統合

PIR² ワークフロー（Plan → Implement → Review → Retrospect）やカスタムスキルを .claude/ で管理。etc/link.sh で $HOME/.claude/ にリンクされるため、全プロジェクトで共有される。

主なスキル: /pir2, /ir, /review-pr, /debug, /tester, /brainstorm, /writing-plan

前提条件

• GitHub CLI (gh): Neovim の telescope-github.nvim で使用
  • macOS: brew install gh
  • Ubuntu: sudo apt install gh

Notes

• 絶対パスを含むシンボリックリンクをリポジトリにコミットしない
• Neovim 設定のリンク: sh etc/link.sh または ln -snfv "$PWD/.config/nvim" "$HOME/.config/nvim"
• Linux は Ubuntu をターゲット、apt ベースのツールを優先