Agent Bus Plugins

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) — 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

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:

/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:

kimi mcp add agent-bus -- agent-bus-mcp
kimi mcp test agent-bus

Or open the interactive manager:

/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:

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:

[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 format but do not have a plugin marketplace, use the universal installer:

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:

./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:

~/.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:

~/.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 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.

1. 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
• Source: MustaphaSteph/agent-bus-plugins
• License: MIT

Install and usage instructions live in the source repository linked above.