パブリックエージェントの構成、スキル、BBエクステンション、および 共有指示。 [config/] から Claude コード、Codex、および Pi の設定を展開します。 BBサーバへのスキルの同期; _AGENTS.md]]は共有指示を提供します。

セットアップ

ご使用の mise、Python 3.12+ およびエージェント CLI が必要です。 スキルの同期には、gh skill、[rsync]、およびリモートターゲットのSSHアクセスが必要です。

各マシンで、チェックアウトを更新し、それを同期します。

Sync は、チェックアウトファイルを使用します。 プル、コミット、プッシュ、または実行しません。 スケジュール ローカルソースの編集は、そのマシンに効果をもたらします。コミットし、それらをプッシュ 他の機械の前に変更を引っ張ることができます。

エージェントの設定

[config/claude/, [config/codex/]], [config/pi/]]のパブリック設定を編集し、実行します [mise run sync:config]. ロード設定、3つのロール定義、1つのルーティング ルール、Codex設定、Piの設定は個々のファイルとして展開します。 無関係の代理店, ルール、スキル、資格情報、セッションファイルが保存されます。 [CODEX_HOME] [CLAUDE_CONFIG_DIR, [PI_CODING_AGENT_DIR]] は、設定時に異なる宛先を選択します。 Pi のデフォルトは ~/.pi/agent です。

Pi の [settings.json 内で、同期は defaultProjectTrust と [packages のみを管理します.

Agent Kit

A Git repository for public agent configuration, skills, BB extensions, and shared instructions. Claude Code, Codex, and Pi configuration deploys from config/. Skills sync to the BB server; _AGENTS.md provides shared instructions.

Setup

Requires mise, Python 3.12+, and the agent CLIs you use. Skills sync also needs gh skill, rsync, and SSH access for a remote target.

git clone https://github.com/vaayne/agent-kit.git
cd agent-kit

mise install             # install the tools declared by this repository

# Set the BB destination once per checkout. This local file is ignored by Git.
cat > .mise.local.toml <<'EOF'
[env]
BB_SKILLS_TARGET = "MacMini:/Users/vaayne/.bb-machines/vaayne-mbp.getbb.app/skills/"
EOF

mise run sync             # configuration, then instructions and skills
mise run sync:config      # Claude Code, Codex, and Pi configuration
mise run sync:config -- --check  # check configuration without writing files
mise run sync:skills      # copy local and remote skills to BB
mise run sync:agents      # _AGENTS.md → CLAUDE.md / AGENTS.md symlinks for every framework

On each machine, update the checkout and sync it:

git pull --ff-only
mise run sync

Sync uses the checked-out files. It does not pull, commit, push, or run on a schedule. Local source edits take effect on that machine; commit and push them before other machines can pull the changes.

Agent configuration

Edit public settings in config/claude/, config/codex/, and config/pi/, then run mise run sync:config. Claude settings, three role definitions, one routing rule, Codex settings, and Pi settings deploy as individual files. Unrelated agents, rules, skills, credentials, and session files remain in place. CODEX_HOME, CLAUDE_CONFIG_DIR, and PI_CODING_AGENT_DIR select different destinations when set. Pi defaults to ~/.pi/agent.

Within Pi’s settings.json, sync manages only defaultProjectTrust and packages. The package list replaces the corresponding local list. All other settings in that file, including model selection, extension settings, and version state, stay local. Pi’s mcp.json and pi-vcc-config.json sync as complete files, with backups and local-edit protection. Keep MCP credentials outside the repository; use environment variable references when a server needs authentication. Pi authentication, provider definitions, and installed package files are not copied. Pi loads package declarations on startup; sync does not run pi install or remove installed files.

Copies keep application writes separate from the Git source. Sync checks all files before writing, backs up changed targets under ~/.local/state/agent-kit/backups/, and records a deployment baseline. It refuses local edits or a differing file on a machine’s first sync. Review and reconcile the file with the repository, or run mise run sync:config -- --replace to save a backup and apply the repository version.