Skip to content

Claude Code plugins

These are host-agent plugins — bundles of skills, hooks, and commands that Claude Code, Codex, or Copilot load. They are a different system from ainb v2 plugins, which are subprocess plugins for the ainb TUI. If you’re unsure which you want, read the plugins disambiguation first.

The repo publishes the in-tree Claude Code plugins through .claude-plugin/marketplace.json at the repo root; the source lives under plugins/<name>/. Add the marketplace, then install:

Terminal window
claude plugin marketplace add https://github.com/stevengonsalvez/agents-in-a-box.git
claude plugin install ainb-fleet@agents-in-a-box
# (or `stevengonsalvez/agents-in-a-box` shorthand if you have GitHub SSH keys set up —
# the shorthand resolves to SSH and fails with "Host key verification failed" otherwise)

reflect is no longer in this marketplace — it was extracted to stevengonsalvez/ainb-reflect-memory and ships from that repo’s plugin/ dir (or run ainb reflect bootstrap).

The plugins

PluginWhat it doesInstall
reflectAgent self-improvement + retrieval — captures learnings and auto-injects relevant prior ones at session start. (extracted → ainb-reflect-memory)ainb reflect bootstrap
ainb-fleetLLM-facing skill bundle teaching agents to drive ainb fleet … multi-session orchestration (broadcast, sequence, needs, daemon).claude plugin install ainb-fleet@agents-in-a-box
ainb-hooksEmits Claude Code / Codex / Copilot lifecycle events to the ainb notification inbox (consumed by the Inbox & notifications daemon — host code, not a plugin).ainb-notifyd install --claude --codex --copilot
caveman-statsLifecycle hooks for caveman mode: statusline token-savings suffix and compaction survival. Claude-only — the hook events exist in all three harnesses (see matrix), but the code reads Claude session JSONL (CLAUDE_CONFIG_DIR) and writes the Claude statusline suffix, and no Codex/Copilot statusline consumes it.claude plugin install caveman-stats@agents-in-a-box
illustrationMascot-driven illustration skill bundle; no lifecycle hooks.claude plugin install illustration@agents-in-a-box

Hook parity target

Hook names are shown as PascalCase / camelCase where Copilot uses a different spelling. YES means the harness has a native event shape for the target behavior; N/A means no matching hook exists in that harness. Codex column reflects the current Codex CLI hook enum, including PermissionRequest, PreToolUse, PostCompact, and Subagent*.

Plugin / ownerHookClaudeCodexCopilotTarget behavior
reflectSessionStart / sessionStartYESYESYESRecall inject + detached drain
reflectUserPromptSubmit / userPromptSubmittedYESYESYESPrompt recall + mini-learning completion
ainb-hooksNotification / notificationYESN/AYESAwaiting-input watcher
reflect / policyPreToolUse / preToolUseYESYESYESTool policy/context before risky calls
ainb-hooksPermissionRequest / permissionRequestYESYESYESPermission-pattern lookup + watcher
reflect / caveman-statsPostToolUse / postToolUseYESYESYESTool-result signal watcher
reflectPostToolUseFailure / postToolUseFailureYESN/AYESExplicit failure mini-learning watcher
reflect / caveman-statsPreCompact / preCompactYESYESYESSilent queue producer
reflectPostCompact / postCompactYESYESN/ABreadcrumb/cleanup only, no drain
reflectSubagentStart / subagentStartYESYESYESSubagent-scoped recall inject
reflectSubagentStop / subagentStopYESYESYESQueue subagent transcript
ainb-hooks / reflectStop / agentStopYESYESYESSlot update + queue fallback
reflectSessionEnd / sessionEndYESN/AYESFinal cleanup + final queue producer
reflecterrorOccurredN/AN/AYESError breadcrumb + optional watcher
ainb-fleet(none)N/AN/AN/APure skill/workflow bundle; no lifecycle hooks
illustration(none)N/AN/AN/APure illustration skill bundle; no lifecycle hooks

Key: only the SessionStart drain runs /reflect. PreCompact, Stop, SubagentStop, and SessionEnd only queue. PostCompact stays bookkeeping only.

Each page below has a /fireworks-tech-graph diagram of how the plugin works, the exact hooks/skills it registers, and how to use it.