agent-dotfiles

Claude Code、OpenAI Codex CLI、GitHub Copilot CLI、Gemini CLI の設定ファイルと AI Agent 向け skill を Git リポジトリで管理するための個人運用ツール。 秘匿情報とホームディレクトリ依存を取り除いた repo view を作り、別マシンへ必要な設定だけを戻せるようにする。

関連ページ

扱う設定

基本のデータフロー

flowchart LR
        home["Home directories
~/.claude / ~/.codex / ~/.copilot / ~/.gemini"]
        export["agent-dotfiles export"]
        repo["agent-dotfiles repo
sanitized repo view"]
        review["review-orchestrator
issue / PR review gates"]
        import["agent-dotfiles import"]
        target["Target machine
restored local settings"]

        home --> export --> repo
        repo --> review
        repo --> import --> target
        target --> home
      

サニタイズと復元

export では設定ファイルを service ごとの構造に合わせて読み、秘匿値とホームディレクトリ依存を repo に置ける形へ正規化する。 import では既存のローカル設定を preseed し、管理対象だけを上書きする。これにより認証情報、履歴、cache、runtime state は保持される。

変換ルール

• 環境変数名に TOKEN、SECRET、PASSWORD、CREDENTIAL、_KEY を含む値はプレースホルダ化する。
• コマンド、引数、環境変数内のホームディレクトリパスは {{HOME}} に置き換える。
• Claude の mcpServers、Codex の TOML、Copilot / Gemini の JSON は構造を保ったまま処理する。
• 履歴、セッション、cache、認証 token、runtime DB は管理対象から外す。

主要コマンド

git clone https://github.com/TomoakiMizuno/agent-dotfiles.git
cd agent-dotfiles
make install

agent-dotfiles status
agent-dotfiles diff
agent-dotfiles export --target codex/config.toml
agent-dotfiles import --target claude/skills/multi-review

新規環境では、先に dotfiles 側で secret substrate と PATH を整える。agent-dotfiles は AI Agent 固有の構造化設定と 同期ロジックを扱い、shell や OS の基本セットアップは dotfiles 側の責務として分ける。

通常 docs

CLI の使い方、同期仕様、review 運用の詳細は docs-site 内の通常 docs index から読む。 skill reference は別 scope で移植するため、このページでは通常 Markdown docs への導線だけを扱う。

target 指定

export、import、status、diff は repo display path を基準に --target で対象を絞れる。service root、管理対象ファイル、管理対象ディレクトリだけを許可し、 対象外のファイルや runtime state を巻き込まない。

• claude、codex、copilot、gemini の service target。
• codex/config.toml、gemini/settings.json のような file target。
• claude/skills/<skill>、claude/agents、codex/hooks のような directory target。
• codex/memories は PC 移行や明示 backup 用の opt-in target として扱う。

review-orchestrator の役割

review-orchestrator は review 系 skill の実行本体で、Issue 作業開始前の claim gate、 implementation readiness、multi-review、Copilot bot review 待機、inline thread close、adversarial review prompt の生成を担う。 外側の AI Agent は自然言語の判断だけで完了扱いにせず、stdout JSON、evidence manifest、report を根拠に次の action を決める。

非管理データ

agent-dotfiles は CLI 設定の同期ツールであり、各 Agent が実行時に作る履歴や cache を repo に集めない。 Claude の projects、Codex の sessions、Copilot の trusted folders、Gemini の認証・履歴などは環境固有の状態として保持される。

運用境界

参照元

• README.md
• docs-site 通常 docs index
• CLI 利用方法
• 同期仕様
• review 運用