Install

npm install -g @bunny-agent/runner-cli

🏗️ Build Your Own Agent Product

Use the SDK to embed Bunny Agent in any product — a Next.js SaaS, an Electron desktop app, or your own OpenClaw alternative. The architecture is the same either way: your UI talks to an AI SDK stream, Bunny handles the rest.

🚀 Quick Start

Sandbox options

Switch with one import — the rest of your code stays unchanged.

import { createBunnyAgent } from "@bunny-agent/sdk";
import { SandockSandbox } from "@bunny-agent/sandbox-sandock";

const agent = createBunnyAgent({
  sandbox: new SandockSandbox(),
  runner: { kind: "pi", model: "anthropic:claude-sonnet-4" },
});

// Returns LanguageModelV3 — compatible with Vercel AI SDK
const model = await agent.getModel();

---

Environment Variables

---

📡 AI SDK UI Native — Zero Glue

Bunny's stdout is an AI SDK UI stream. Pipe it to your server, pass it to your client, done.

// Next.js API route — this is the entire backend
export async function POST(req: Request) {
  const { messages, sessionId } = await req.json();

  const agent = new BunnyAgent({
    id: sessionId,
    sandbox: new SandockSandbox(),
    runner: { kind: "pi", model: "google:gemini-2.5-pro" },
  });

  return agent.stream({ messages }); // returns a Response with AI SDK UI stream
}

// React client — useChat just works
const { messages, input, handleSubmit } = useChat({ api: "/api/agent" });

No protocol translation. No buffering. Pure passthrough.

---

Set your API key

```bash export ANTHROPIC_API_KEY=sk-ant-...

🔧 CLI Reference

bunny run [options] -- "<task>"

Options:
  -r, --runner <name>    Runner: pi | claude | gemini | codex | opencode  (default: claude)
  -m, --model  <model>   Model override  (e.g. google:gemini-2.5-pro)
  -c, --cwd    <path>    Working directory  (default: current dir)
  -s, --system-prompt    Custom system prompt
  -t, --max-turns <n>    Maximum turns
      --resume <session> Resume a previous session
      --yolo             Skip confirmation prompts
  -h, --help             Show help

📦 Packages

---