個人用の dotfiles リポジトリ。chezmoi で管理する。macOS と Linux(Omarchy 等)の両対応。
-
dotfiles を canonical path へ clone
git clone <repository-url> ~/src/github.com/wwwyo/dotfiles
-
chezmoi をインストール。macOS は brew(未導入なら先に Homebrew を入れる。以降は
brew bundleが面倒を見る)、Linux/Omarchy は pacman# macOS brew install chezmoi # Omarchy(Arch) sudo pacman -S chezmoi
-
init + apply
chezmoi init --source ~/src/github.com/wwwyo/dotfiles chezmoi apply -vchezmoi initが~/.config/chezmoi/chezmoi.tomlを生成する(home/.chezmoi.toml.tmplから。sourceDirとmode = "symlink"が書き込まれる)。apply は次の処理を行う。home/配下のファイルを~/へ配置(基本は source への symlink。template / executable は実ファイル)run_once_10-installで環境構築(darwin: brew bundle + duti + defaults + mise install / linux: mise install)run_once_after_15-migrate-legacy-linksで旧 link.sh 時代の whole-dir link 先に残った repo 管理外ファイル(~/.config/mise/conf.d/local.toml等)を新しい dir へ移行run_after_20-link-repodirsで repo 内 dir の symlink(.agents,.claude/*,.codex/*等)を張る
apply は main checkout(canonical path)から実行すること。worktree から apply すると link 先が worktree 内を指し、worktree 削除で壊れる。
age 復号鍵、SSH 秘密鍵、ユーザーデータは自動移行しない。Mac を移行する場合は MIGRATION.md の手順に従う。
macshot は起動後、Settings → General → Settings Backup → Import Settings… で scripts/macshot-settings.json を選び、確認して再起動する。
gh-secure はプロジェクトごとではなく、ユーザー単位で一度インストールする。gh は mise 管理のものを使い、拡張は 7 日以上経過した commit(2026-09-14 の版)に固定する。
mise exec -- gh extension install GitHubSecurityLab/gh-secure --pin 42c928f94b61caae03774d2436b897a1d04fff20
mise exec -- gh secure --version.chezmoiroot # "home" — chezmoi の source root を home/ に指定
home/ # chezmoi source state(~/ へ deploy されるもの)
dot_gitconfig # → ~/.gitconfig
dot_config/ # → ~/.config/
dot_claude/ # → ~/.claude/(file entry のみ。dir は link script 側)
Library/ # → ~/Library/(macOS only)
run_once_* # apply 時に1度だけ走る install script
run_after_* # apply 後に走る dir link script
.agents/ .claude/ .codex/ .pi/ # chezmoi 管理外。run_after script が dir 丸ごと symlink
scripts/ docs/ tests/ # repo 内部ファイル(deploy されない)
dot_foo→~/.foo、private_→ 権限 0600、executable_→ +x、symlink_→ symlink、*.tmpl→ template 評価home/dot_local/bin/→~/.local/bin/(PATH 上)。vendored な CLI はexecutable_付きでここに置く。単一 skill からしか呼ばれない script はここではなく<skill_dir>/scripts/に置く- OS 分岐は
{{ if eq .chezmoi.os "darwin" }}(.tmplファイル or.chezmoiignore)で行う .chezmoiignoreで deploy 対象外を指定(macOS 専用 entry の linux 無効化、dir link 対象の除外)
以下は run_after_20-link-repodirs.sh.tmpl が repo 内 dir へ symlink を張る(理由は .chezmoiignore 冒頭):
.agents— 共有 hook・scheduled task・MCP 設定と、Orca が配って自動更新する skill(.agents/skills)。共有 skill の本体は wwwyo/skills が持ち、各 agent へ plugin で配る.claude/{skills,agents}/home/dot_claude/hooks— 同上 + repo 内相対 symlink(skills/*→../../.agents/)+ executable script.agents/scheduled-tasks→~/.claude/scheduled-tasks— Orca automation の手順書置き場。repo 内の.claude/scheduled-tasksは旧パスの互換 symlink.codex/{rules,scripts,hooks,automations,skills}/.pi/agent/extensions— 同上home/dot_config/{git/hooks,mise/tasks}— executable を含むため per-file symlink 不可~/src/github.com/wwwyo/skills/.agents/skills→~/.config/devin/skills— plugin を読まない Devin 向け(repo 外を指す唯一の link。checkout が無ければ skip)
~/に置きたい file:home/配下にdot_命名で追加 →chezmoi apply- 実行ファイル / runtime が書き込む dir: 該当 dir が dir link 対象なら repo 内に置くだけ(
chezmoi apply不要)。新しい dir link 対象を足す場合はrun_after_20-link-repodirs.sh.tmplにlink_dir行を追加 - OS 依存の中身: shell script は
[[ "$OSTYPE" == darwin* ]]で分岐。JSON/TOML は.tmpl化して{{ if eq .chezmoi.os }}で分岐
- 既存のファイルは chezmoi が検出する(
chezmoi applyで上書きされる前にchezmoi diffで確認推奨) .ssh/configのみ管理対象。SSH 鍵や~/.ssh/config.local(マシン固有の Host)などの機密ファイルは対象外- Codex の共通設定は
home/.chezmoitemplates/codex-base.toml.tmpl。~/.codex/config.tomlは実ファイルで、apply は共通設定だけを更新する。repo trust・hook 承認履歴・PC 固有の plugin 配置先などはローカルに保持され、repo には同期されない。~/.codex/hooks.jsonは引き続き template から配置する。 - Pi の sandbox は 2026-10-27 に廃止した(
pi-sandboxpackage とsandbox.jsonを削除)。理由と再導入時の前提は dev-env の pi reference にある。 - Pi の
settings.jsonも同じ方式。home/.chezmoitemplates/pi-settings-base.jsonをprivate_settings.json.tmplが~側と合成する実ファイルで、pi が TUI から書き戻す既定 model・theme などはローカルに残り repo を汚さない。 ~/.claude/settings.jsonは repo への symlink なので書き戻しがgit statusに出る。Devin の~/.config/devin/config.jsonは template から作る実ファイルで、承認や個人設定はローカルに保持する。Devin の Orca hook は PC ごとの home directory から描画する。- mise の age 復号鍵は macOS では Keychain(
service=mise-age-key)、それ以外では gitignore 済みの~/.config/mise/age.txtから読む(home/dot_zsh/01-exports.zsh)。鍵ファイル自体は repo に置かず、password manager 等の別経路で持ってくる
設定の分離・新規セットアップ・再 apply・hook の可搬性は、chezmoi と Python がある環境で python3 tests/agent-config-local-state.py により確認できる。