8000 GitHub - winky/dotfiles: dotfiles · GitHub
[go: up one dir, main page]

Skip to content
winkyPublic

About

dotfiles

Resources

Stars

6 stars

Watchers

0 watching

Forks

Repository files navigation

Private dotfiles

Dotfiles Doctor

個人用の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

セットアップ手順

  1. 基本設定のデプロイ

    make deploy
  2. 設定ディレクトリのシンボリックリンク作成

    make homeConfig
  3. CLI ツールと言語ランタイムのインストール

    make runtimes   # make tools も先に走る
    ターゲット 入れるもの 指定の場所
    make tools 固定バージョンの CLI ツール(今は asdf)を ~/.local/bin に Makefile の TOOLS と <name>_version / <name>_url
    make runtimes asdf のプラグインとバージョン(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)

🛠️ 主要な機能

Shell (zsh)

  • プラグインマネージャー: zinit
  • プロンプト: カスタムテーマ winky.zsh-theme
  • ディレクトリナビゲーション: zoxide(利用可能な場合)
  • モダンなCLIツール (インストール時のみ alias 適用):
    • eza - lsの代替(アイコン、Git統合)
    • bat - catの代替(シンタックスハイライト)
    • ripgrep (rg) - grepの代替(高速検索)
    • lazygit - Git TUI

Neovim

  • プラグインマネージャー: 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(インデントガイド)

Vim

  • 位置付け: Neovim が無い環境向けの最小フォールバック構成
  • プラグインマネージャー: dein.vim
  • カラースキーム: sainnhe/edge (Neovim と共通)
  • 主要プラグイン:
    • lightline.vim(ステータスライン)
    • vim-fugitive(Git統合)
    • vim-gitgutter(Git差分表示)
    • vim-surround / vim-commentary(編集系)

tmux

  • プラグインマネージャー: TPM (Tmux Plugin Manager)
  • 設定: カスタムキーバインド、ペイン分割、セッション管理

claude-grid

複数の 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 と連携し、ペイン枠にセッション状態が表示される: 青 ▶ = 実行中 / 赤 ● + 赤背景 = 入力・許可待ち / 緑 ✔ + 緑背景 = 応答完了

Git

  • 設定: 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コマンドとその説明が表示されます。

🎨 カスタマイズ

新しいプラグインの追加

Neovim

config/nvim/lua/plugins/ ディレクトリに新しい .lua ファイルを作成します。

例: config/nvim/lua/plugins/my-plugin.lua

return {
  "username/plugin-name",
  config = function()
    -- 設定
  end,
}

Vim

.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

🩺 dotfiles-doctor (健全性チェック)

このリポジトリには 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 実体確認

CI 実行

.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

About

dotfiles

Resources

Stars

6 stars

Watchers

0 watching

Forks

Releases

Packages

Used by

Contributors

Languages

0