공공 에이전트 구성, 기술, BB 확장 및 Git 저장소 자주 묻는 질문 Claude Code, Codex 및 Pi 구성은 config/]에서 배포합니다. Skills sync to the BB server; _AGENTS.md는 공유 지침을 제공합니다.

설치

mise, Python 3.12+, 에이전트 CLI가 필요합니다. Skills sync는 gh skill, rsync], 원격 대상 SSH 액세스가 필요합니다.

각 기계에, 체크 아웃을 업데이트하고 동기화 :

Sync는 체크 아웃 파일을 사용합니다. 그것은 당겨지지 않습니다, 커밋, 푸시, 또는 실행 일정. 로컬 소스 편집은 그 기계에 영향을 준다; 커밋하고 밀어 다른 기계의 앞에 변화를 당길 수 있습니다.

에이전트 구성

config/claude/], config/codex/], 그리고 config/pi/], 다음 실행 mise run sync:config. Claude 설정, 세 가지 역할 정의, 하나의 라우팅 규칙, Codex 설정 및 Pi 설정은 개별 파일로 배포합니다. 관련 대리인, 규칙, 기술, 자격 및 세션 파일은 장소에 남아. CODEX_HOME, CLAUDE_CONFIG_DIR, PI_CODING_AGENT_DIR] 설정할 때 다른 목적지를 선택합니다. Pi 기본적으로 ~/.pi/agent.

Pi’s 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.