claudecode-bootstrap

Toolkit — Portable AI-Agent Skills & Configs

One canonical source. Many AI tools. Write a skill once, install it into Claude Code, Codex, Copilot, Gemini, Hermes, nanoclaw, Amazon Q, Cursor, Cline, Roo, or Clawdhub.

← Back to main README

Migration notice — ainb is the new deploy surface (May 2026).

bootstrap.js, update-externals.sh, and external-dependencies.yaml have been retired in favour of ainb, the Rust-based unit manager. The new install / update / sync / migrate flow lives in the spec at ainb-tui/plans/skill-manager/spec.md.

Day-1 path for existing users:

cargo install --path ainb-tui                       # one-time
ainb migrate --from-bootstrap --toolkit-root .      # seed manifest
ainb migrate --check                                # preview wipe
ainb migrate --clean --backup --yes                 # apply
ainb skill list                                     # verify

Sections below describe the legacy bootstrap.js workflow and remain for historical reference; the engine itself no longer ships in this repo. New users should skip directly to ainb.

Quick start (legacy — retired, see migration notice above)

cd toolkit
npm install

# Interactive (picks tool from menu)
node bootstrap.js

# Non-interactive (one tool)
node bootstrap.js --tool=claude-code-4.5
node bootstrap.js --tool=codex
node bootstrap.js --tool=copilot
node bootstrap.js --tool=gemini
node bootstrap.js --tool=hermes-agent
node bootstrap.js --tool=nanoclaw

# Verify everything landed (read-only)
node bootstrap.js --tool=claude-code-4.5 --verify

# Install external deps (git-cloned skills, npx-skills, claude plugins)
bash ~/.claude/setup-external.sh

Repeat for each target tool. Each tool gets its own home directory population (~/.claude/, ~/.codex/, …). Hermes is special — it reads from ~/.claude/skills/ via skills.external_dirs, so installing for Claude transitively covers Hermes.

What's in packages/

The canonical source tree. Everything under packages/ gets distributed to tool home dirs on bootstrap.

packages/
├── skills/              91 skills — agent-invokable SKILL.md bundles
├── agents/              37 agents across 6 categories
│   ├── design/          UI/UX designers
│   ├── engineering/     backend, frontend, security, perf, code-review
│   ├── meta/            agentmaker (create new agents)
│   ├── orchestrators/   tech-lead, project-analyst, team-configurator
│   ├── swarm/           worker/leader primitives for multi-agent work
│   └── universal/       backend-developer, frontend-developer, superstar-engineer
├── utilities/
│   ├── config/          Shared tool config templates
│   ├── hooks/           Event hooks (session-start, pre-commit, etc.)
│   ├── output-styles/   Custom output formatters
│   ├── reflections/     Session reflection templates
│   └── utils/           Shell utility libraries
├── workflows/
│   └── single-agent/    Guided plan → implement → validate flows
└── knowledge/
    └── docs-solutions-template/

The reflect Claude Code plugin lives at root-level plugins/reflect/ (moved out of toolkit/packages/plugins/ to sit beside its companion library). The reflect/recall knowledge base CLI lives at root-level reflect-kb/ in this same monorepo and is installed via uv tool install by bootstrap.js (from the git+https://github.com/stevengonsalvez/agents-in-a-box.git#subdirectory=reflect-kb URL). See the bootstrap's installReflectKb() function for details.

Skills at a glance (91 total, grouped by purpose)