claude-bridge (Claude Code plugin)
Makes a project bridge-ready: mounts the bridged MCP gateway and applies standard Claude Code
settings, so the session can orchestrate a fleet of delegated workers.
This plugin ships no credentials. Every secret is referenced by environment-variable name; the values stay with the user. Nothing the plugin writes is unsafe to commit.
What it is not
The plugin is the client-side setup, not the bridge. bridged is a separate daemon and herdr
is a separate PTY multiplexer, each with its own lifecycle and install. The plugin mounts an
already-running daemon and tells you what is missing when one isn't there — it deliberately does
not try to install system services on your behalf.
Install
/plugin marketplace add ltms/claude-bridge
/plugin install claude-bridge@claude-bridge
Then, in the project you want to onboard:
/claude-bridge:setup
What you get
| Component | Effect |
|---|---|
.mcp.json |
mounts bridged at http://127.0.0.1:8765/mcp for any session with the plugin enabled |
skills/setup |
/claude-bridge:setup — preflight, project settings, credential guidance, and verification |
Because the plugin carries its own .mcp.json, an installed plugin needs no project-level MCP
file at all. The setup skill writes one only when you want the mount to work without the plugin —
for teammates who haven't installed it, or for CI.
Verifying a setup
The setup skill ends by requiring a real spawn, not a health check. /healthz only reports
that the daemon can reach herdr; a protocol mismatch between the daemon's adapter and the herdr
binary leaves health green while every spawn fails. Only a spawn that reaches ready proves the
fleet.
Local development
claude --plugin-dir ./plugin
claude plugin validate ./plugin
/reload-plugins picks up edits without restarting the session.