# Agent Bus Plugins > Codex and Claude Code plugins for agent-bus: local message bus for AI agent-to-agent communication. Bundles the MCP server, slash commands, and the universal Agent Skill. - **Type:** MCP server - **Install:** `agentstack add mcp-mustaphasteph-agent-bus-plugins` - **Verified:** Pending review - **Seller:** [MustaphaSteph](https://agentstack.voostack.com/s/mustaphasteph) - **Installs:** 0 - **Category:** [Databases](https://agentstack.voostack.com/c/databases) - **Latest version:** 0.1.0 - **License:** MIT - **Upstream author:** [MustaphaSteph](https://github.com/MustaphaSteph) - **Source:** https://github.com/MustaphaSteph/agent-bus-plugins ## Install ```sh agentstack add mcp-mustaphasteph-agent-bus-plugins ``` Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent. ## About # agent-bus plugins Plugins and Agent Skills for Claude Code, Codex, Kimi Code, Cursor, and other MCP-capable coding agents. They bundle: - The **agent-bus MCP server** ([`@agent-bus-connect/cli`](https://www.npmjs.com/package/@agent-bus-connect/cli)) — 65 tools plus CLI/UI views for agent-to-agent messaging, the local `agent-bus ui` web cockpit, async asks, truncation-safe inbox previews, exact message fetches, team-scoped send/ask/delegation/boards, roster cleanup, team chat, activity timelines, cockpit dashboards, visible current-work updates, workflow Kanban, tasks, task progress events, result bundles, cancellation, channels, capability routing, status boards, acknowledgements, review gates, handoffs, scope checks, decisions, memories, session briefs, and final reports. - The **universal `agent-bus` Agent Skill** plus small router skills — natural-language coordinator playbooks ("ask the reviewer", "delegate this", "get a second opinion", "put worker-2 to sleep", "final merge report") that translate intent into tool calls without users naming tools or parameters. - Optional **Stop hook** for listener resilience (Claude Code: on by default; Codex: opt-in). Source code for the bus itself lives at . ## Install Order Install the npm CLI first, then install the plugin. The plugin declares the MCP server command, but the `@agent-bus-connect/cli` package provides the actual `agent-bus-mcp` binary. Installing the plugin before the CLI can produce an `ENOENT` MCP startup error because Claude Code or Codex cannot find `agent-bus-mcp`. ### 1. Install the bus binary once per machine ```bash npm i -g @agent-bus-connect/cli@latest which agent-bus-mcp agent-bus --version ``` That puts `agent-bus` (CLI) and `agent-bus-mcp` (MCP stdio server) on your PATH. Plugins below verify both are available through the bundled setup checker. They do not silently install npm packages; run the checker or installer with `--install-cli` when you want it to fix a missing or old CLI. ### 2. Choose your host plugin/skill install #### Kimi Code Kimi Code can install directly from the GitHub repo because this repo ships Kimi manifests at the root. Current Kimi builds look for `plugin.json`; newer docs also describe `kimi.plugin.json` and `.kimi-plugin/plugin.json`, so this repo includes all three. Kimi plugin installs do not run shell/npm scripts, so keep step 1 above. In Kimi Code: ```text /plugins install https://github.com/MustaphaSteph/agent-bus-plugins /plugins mcp enable agent-bus agent-bus /reload ``` If your Kimi build installs the plugin but does not enable the MCP server automatically, add it once from a terminal: ```bash kimi mcp add agent-bus -- agent-bus-mcp kimi mcp test agent-bus ``` Or open the interactive manager: ```text /plugins ``` The Kimi plugin loads `agent-bus-read-first` at session start, exposes the root `skills/` tree, and declares the `agent-bus-mcp` stdio server. #### Codex (CLI + Desktop) Step 1 — add the marketplace: ```bash codex plugin marketplace add MustaphaSteph/agent-bus-plugins ``` The Codex marketplace lives at the repo root (`.agents/plugins/marketplace.json`), so no `--sparse` flag needed. Step 2 — install the `agent-bus` plugin from Codex's plugin UI (in Codex CLI's interactive mode or Codex Desktop's plugin panel). Current Codex CLI builds expose only `codex plugin marketplace add/upgrade/remove` from the shell — the actual `install` action happens inside the agent UI. Once a future Codex CLI build ships a `codex plugin install ` subcommand, this step will also be runnable from a script. **Hooks note:** the listener-resume Stop hook ships **disabled by default**. To opt in, edit `~/.codex/config.toml`: ```toml [features] plugin_hooks = true ``` Then re-install or reload the plugin. Without the hook, listener mode still works via the long-blocking `inbox(wait_s=110)` call alone — the hook is purely a recovery path for sessions that fall out of the loop. #### Cursor / Gemini CLI / Goose / OpenCode / Junie / Amp / Kiro / others This repo also ships a root `.cursor-plugin/plugin.json` in the same style as HyperFrames. For tools that support the open [Agent Skills](https://agentskills.io) format but do not have a plugin marketplace, use the universal installer: ```bash curl -fsSL https://raw.githubusercontent.com/MustaphaSteph/agent-bus-plugins/main/install.sh | sh ``` It auto-detects every supported tool's config directory under `$HOME` and drops the full agent-bus skill pack into each one's `skills/` folder. Then prints the per-tool MCP-server registration hints so you can finish wiring up the bus. Options: ```bash ./install.sh --dry-run # show plan, change nothing ./install.sh --target ~/.cursor/skills # force a specific destination ./install.sh --install-cli # also install/upgrade the npm CLI ``` The skill needs the bus binary too. Install once with `npm i -g @agent-bus-connect/cli@latest`, or pass `--install-cli` to this installer. #### Claude Code ``` /plugin > Marketplaces > Add MustaphaSteph/agent-bus-plugins > Install agent-bus ``` The marketplace manifest lives at `.claude-plugin/marketplace.json` at the repo root, so the bare `owner/repo` form works without flags. The plugin includes: - The agent-bus MCP server config (the actual `agent-bus-mcp` binary comes from the CLI package installed in step 1) - The `agent-bus` skill (cross-tool coordinator playbook) - `/main ` slash command — primes a coordinator session to talk to the bus in natural language - `/listen ` slash command — turns a session into a passive helper that responds when called - Always-on Stop hook for listener resilience (Claude Code doesn't gate plugin hooks the way Codex does) ## Verify After install, in any new session: ``` List the agent-bus MCP tools and call whois. ``` You should see all 65 tools and (if no agents are registered yet) an empty agent list. If something's off, run the skill's setup checker: ```bash ~/.claude/skills/agent-bus/scripts/check-setup.sh # Claude Code ~/.codex/skills/agent-bus/scripts/check-setup.sh # Codex ``` That validates Node ≥ 20, `agent-bus-mcp` on PATH, and that the installed CLI version satisfies the skill's `requires` field. To install/upgrade the CLI from the checker explicitly: ```bash ~/.claude/skills/agent-bus/scripts/check-setup.sh --install-cli ~/.codex/skills/agent-bus/scripts/check-setup.sh --install-cli ``` ## How this repo supports many agents The package follows a skills-first layout: - **Root manifests** for broad plugin clients: `.codex-plugin/plugin.json`, `.claude-plugin/plugin.json`, `.cursor-plugin/plugin.json`, and `kimi.plugin.json`. - **Root `skills/` tree** for universal Agent Skills installs: `agent-bus-read-first`, `agent-bus-cli`, `agent-bus-coordinator`, `agent-bus-listener`, `agent-bus-workflows`, plus the full canonical `agent-bus` skill. - **Legacy plugin bodies** for the current Claude/Codex marketplace flows under `claude-code/plugins/agent-bus/` and `plugins/agent-bus/`. - **One npm CLI/MCP package** (`@agent-bus-connect/cli`) used by every host. The plugin teaches the agent; the CLI/MCP server does the work. ## Repo layout ``` . ├── .codex-plugin/plugin.json ← root Codex-compatible manifest ├── .claude-plugin/plugin.json ← root Claude-compatible manifest ├── .agents/plugins/marketplace.json ← Codex marketplace at root ├── .cursor-plugin/plugin.json ← root Cursor-compatible manifest ├── kimi.plugin.json ← Kimi Code plugin manifest ├── .kimi-plugin/plugin.json ← Kimi compatibility manifest ├── plugin.json ← Kimi 1.47 compatibility manifest ├── .mcp.json ← root MCP declaration ├── skills/ ← root skills-first install surface │ ├── agent-bus/ (vendored from main repo) │ ├── agent-bus-read-first/ │ ├── agent-bus-cli/ │ ├── agent-bus-coordinator/ │ ├── agent-bus-listener/ │ └── agent-bus-workflows/ ├── plugins/agent-bus/ ← Codex plugin body │ ├── .codex-plugin/plugin.json │ ├── .mcp.json (command: agent-bus-mcp) │ ├── hooks/hooks.json (disabled by default) │ └── skills/agent-bus/ (vendored from main repo) ├── .claude-plugin/marketplace.json ← Claude Code marketplace at root ├── claude-code/plugins/agent-bus/ ← Claude Code plugin body │ ├── .claude-plugin/plugin.json │ ├── commands/{main,listen}.md │ ├── hooks/hooks.json │ ├── hooks-handlers/stop-hook.sh │ └── skills/agent-bus/ (vendored, same content as Codex copy) ├── install.sh ← universal fallback for skills-aware tools ├── scripts/sync-skill.sh ← vendors canonical skill into root + plugin paths ├── .sync-version ← what tag/commit the vendored skill came from └── package.json ``` ## Versioning The skill is **vendored**, not git-submoduled. Single canonical copy lives in the [main `agent-bus` repo](https://github.com/MustaphaSteph/agent-bus/tree/main/skills/agent-bus) at the ref listed in `.sync-version`. CI fails any PR that ships a vendored copy that drifts from the pinned ref. Bumping the canonical skill means: 1. Update + commit the skill in the main repo. 2. In this repo, bump the pinned ref in `scripts/sync-skill.sh` when needed. 3. Run `npm run sync-skill`. 4. Commit the regenerated `skills/agent-bus/`, `plugins/agent-bus/skills/agent-bus/`, `claude-code/plugins/agent-bus/skills/agent-bus/`, and `.sync-version`. 5. Push. For local dev iteration without tagging, use `npm run sync-skill:dev` (reads from `../agent-bus/`). ## Troubleshooting | Symptom | Fix | |---|---| | `ENOENT` or `agent-bus-mcp: command not found` after plugin install | Run `npm i -g @agent-bus-connect/cli@latest`, verify `which agent-bus-mcp`, then reconnect `/mcp` or restart the host app. The plugin declares the MCP command, but the npm package provides the actual binary. | | Setup checker says CLI is missing or old | Run `/agent-bus/scripts/check-setup.sh --install-cli` to install/upgrade via npm. | | Setup checker still says `agent-bus X is older than required Y` after installing latest | The plugin/skill is ahead of the published npm CLI. Check `npm view @agent-bus-connect/cli version`; publish the required CLI version first, or lower `MIN_AGENT_BUS` to the latest published version before releasing the plugin. | | Skill installed but tools not visible | Open a NEW session — Claude Code / Codex read MCP config at session start. | | Kimi plugin installed but `kimi mcp list` is empty | Run `kimi mcp add agent-bus -- agent-bus-mcp`, then `kimi mcp test agent-bus`. Some Kimi builds install skills from the plugin manifest but still require manual MCP registration. | | Codex Stop hook doesn't trigger | Check `[features].plugin_hooks = true` in `~/.codex/config.toml` and reload the plugin. Without that flag, plugin-bundled hooks are inert in Codex. | | Setup check exit non-zero | Read the printed install hint; the script's exit message tells you exactly what's missing. | ## License MIT. ## Source & license This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code. - **Author:** [MustaphaSteph](https://github.com/MustaphaSteph) - **Source:** [MustaphaSteph/agent-bus-plugins](https://github.com/MustaphaSteph/agent-bus-plugins) - **License:** MIT Install and usage instructions live in the source repository linked above. ## Pricing - **Free** — Free ## Security capabilities Automated source analysis of v0.1.0 — what this tool can access: - **Network access:** yes - **Filesystem access:** no - **Shell / process execution:** no - **Environment & secrets:** no - **Dynamic code execution:** no *"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.* ## Versions - **0.1.0** — security scan: flagged — Imported from the upstream source. ## Links - Listing page: https://agentstack.voostack.com/l/mcp-mustaphasteph-agent-bus-plugins - Seller: https://agentstack.voostack.com/s/mustaphasteph - Browse the marketplace: https://agentstack.voostack.com/browse --- Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.