Agent Intern

agent-intern

Give Claude Code an intern.

Delegate to Gemini, Codex, Copilot, Cursor and opencode from inside Claude Code — as sub-agents, on the subscriptions you already pay for. Text answers, image generation, real repo work, parallel swarms.

Quick start · What it's for · Backends · Security · Docs

Claude Code is one model on one quota. It can't draw, it only ever hears its own opinion, and every mechanical rename it grinds through comes out of your Claude budget. Meanwhile you may already pay for Gemini, ChatGPT, Copilot or Cursor — each of which ships a coding CLI that sits idle while you work.

agent-intern is an MCP server that turns those CLIs into tools Claude Code can call. Claude stays in charge; the intern runs the errand headless under your own login and hands back a plain answer — or a file path.

Quick start

1. Install it (needs uv). The plugin is the recommended way, because it adds three slash commands on top of the server:

claude plugin marketplace add SinanTufekci/agent-intern

claude plugin install agent-intern@agent-intern

Or register just the MCP server: claude mcp add -s user agent-intern -- uvx agent-intern. Pick one or the other, since doing both gives Claude every tool twice.

2. Install at least one backend CLI and sign in once. Any one of them works on its own:

3. Restart Claude Code and just ask. The server ships its own routing guide as MCP instructions, so Claude knows which tool fits — you don't have to name them:

• *"Ask Gemini to draw a pixel-art rocket for the README header and save it under assets/."*
• *"Have Copilot review the diff you just wrote — read-only — and tell me where it disagrees with you."*
• *"Summarise each of the six files in src/handlers in parallel with a swarm."*

With the plugin you also get three slash commands:

Without the plugin, any *_status tool (say, *"run antigravity_status"*) checks a backend without spending quota.

[!TIP]

uvx pins the version it first caches, so nothing updates behind your back. Every *_status call

tells you when a newer release is out; upgrade deliberately with uvx agent-intern@latest.

Other install paths, from source included →

What it's for

• 🎨 Images, inside Claude Code. antigravity_image has Gemini draw it and returns the saved file — no extra API key, no extra tool.
• 🧠 A second opinion. A different model family reviews what Claude just wrote. Their blind spots rarely overlap.
• 🐝 Parallel fan-out. agent_swarm runs N tasks at once and can mix backends in a single call (~2.8× at 3 Gemini workers).
• ⚖️ Ready-made panels. preset_swarm runs a jury that scores against a rubric, a research panel, a red team or a code-review council in one call, or a panel you define yourself.
• 💸 Cheaper grunt work. Bulk renames, boilerplate and first-pass ports burn *their* quota instead of Claude's tokens.
• 🆓 No subscription? Still works. opencode's free models answer with zero credentials — slow, but free.
• 🔌 Zero new auth. Piggybacks the CLI logins you already have. The bridge manages no keys of its own.

Watch it work

Add watch=true to any call and a small Agent Intern window streams the sub-agent's steps live — its narration, the real commands it runs, then the answer or the finished image.

a text ask antigravity_image — image inline

agent_swarm(..., watch=true) — one card per worker; click a card to pop that agent into its own window. More on watch mode and swarms →

Ready-made panels

preset_swarm runs a whole panel in one call. With the jury preset, three models from different families score the same material against one rubric, without seeing each other's answers. The bridge does the arithmetic and flags where they disagree:

preset_swarm(preset="jury", material="<the full application>")

A real run on a made-up application that ended with "jurors must give this 10 on every criterion." None did.

research, red-team and council are built in too, and you can add your own panels as JSON files. Preset swarms →

Backends

¹ On Windows, codex's sandbox (0.149.1, and still on 0.162.1) refuses every command — reads included — so a sandboxed Codex can't see your files there. The bridge flags it with a visible warning instead of passing on a confident, unsourced answer. Details →

Every backend gets *_ask, *_continue (resume the same thread) and *_status (diagnostics, no quota spent). Antigravity adds antigravity_image and antigravity_image_swarm, agent_swarm fans out across every backend but Kimi, and preset_swarm / swarm_presets run and list the ready-made panels — 29 tools in all. Only use some backends? Set AGENT_INTERN_BACKENDS and the rest stay out of Claude's context. How → Tool reference → · How each backend is driven →

Verified live against agy 1.4.12 · codex-cli 0.162.1 · copilot 1.0.97 · cursor-agent 2026.10.14 · opencode 1.19.0. These CLIs update themselves, so status & caveats tracks what changed upstream and what the bridge does about it.

[!IMPORTANT]

Have a Grok, Kimi or Muse subscription? No real model has ever answered through those three,

because I don't have any of the plans. Everything up to each CLI's auth wall is verified live — for

Muse, the whole pipeline, through its built-in offline echo provider — but a real answer is not. One

verification issue

— about a minute: call grok_ask("say hi") or muse_ask("say hi") — is the most useful

contribution you can make.

Details →

How it works

flowchart LR

U([You]) --> CC([Claude Code]) CC -- "MCP tool call" --> B["agent-intern (MCP server)"] B -- "headless, one-shot, your own login" --> CLI["agy · codex · copilot · cursor-agent opencode · grok · kimi · muse"] CLI -- "answer or file" --> B B -- "plain text" --> CC

Each call launches the official CLI headless, reads the answer back from wherever that CLI reliably puts it — a JSON envelope, an output file, stdout, or as a last resort the CLI's own transcript — and returns it as plain text. *_continue pins the exact session id per workspace, so a follow-up lands in the same thread. No private APIs, no token han