The bridge across agents — delegate tasks to another AI agent running headless.
| CLI | Harness key |
|---|---|
| Claude Code | claude |
| Gemini CLI | gemini |
agent-bridge is an agent skill that lets an orchestrator agent delegate tasks to another AI agent running headlessly. It assembles a structured prompt, optionally shows it for review, then spawns the target CLI and returns the result.
Supports two modes:
- Review mode — compile → inspect → execute
- Auto mode — compile + execute in one step, no review
Via npx skills:
npx skills add davipedro/agent-bridgeVia Claude Code plugin marketplace:
/plugin marketplace add davipedro/agent-bridge
/plugin install agent-bridge@agent-bridge
Or copy skills/agent-bridge/ into your project's .claude/skills/ directory.
- Node.js 18+
claudeand/orgeminiCLI in PATH and authenticated
Invoke with /agent-bridge in Claude Code. The skill guides you through:
- Harness (
claudeorgemini), model, execution type, working directory, task prompt - Prompt review (or skip with auto mode)
- Execution and result
{
"action": "run",
"harness": "gemini",
"model": "gemini-2.5-pro",
"executionType": "analysis",
"sessionId": null,
"cwd": "/absolute/path/to/project",
"prompt": "Find why auth.py fails on expired sessions"
}{
"action": "compile",
"harness": "gemini",
"model": "gemini-2.5-pro",
"executionType": "analysis",
"sessionId": null,
"cwd": "/absolute/path/to/project",
"prompt": "Find why auth.py fails on expired sessions",
"entryPoints": ["src/auth.py"]
}Then pass promptCompiled to action: "execute" after reviewing.
| Action | Description |
|---|---|
compile |
Assembles the full prompt. Returns promptCompiled for review. |
execute |
Runs the compiled prompt against the target harness. |
run |
Compile + execute in one step. No review. |
| Type | Permissions |
|---|---|
analysis |
Read-only. No file writes or side-effect commands. |
act |
Read + write. Full tool access. |
Pass sessionId from a previous execute/run output to resume the same agent session. Set to null to start fresh.
The bridge script is at skills/agent-bridge/scripts/bridge.ts. Run directly with:
echo '<input-json>' | npx tsx skills/agent-bridge/scripts/bridge.ts