@bunny-agent/runner-cli (英语)
Bunny探员跑步者CLI - A 轻型, 当地 用于在您的终端运行AI代理的命令行界面.
和Gemini-cli, Claude-code, 或codex-cli一样,这个工具运行 直接在本地文件系统中它有两个子命令,每个输出协议一个: run 串流 AI SDK UI 消息用于单项任务的 stdout,以及 acp 长生不老 代理客户协议 zed和JetBrains等编辑的特工.
关键特性
- 🔌 选择不同的运行者: Claude、Codex、双子座、副驾驶之间切换
--runner旗帜 - 🚀 本地执行: 直接运行在您的文件系统中,不需要沙盒
- 💨 轻巧: 没有管理人员的依赖性,间接费用最低
- 📡 流线: 实时 AI SDK UI 流线(
run或非加太JSON-RPC 超过 stdio(acp(中文(简体) )
建筑
runner-cli
├─ run → @bunny-agent/runner-harness → runner-claude / runner-codex / ...
└─ acp → @bunny-agent/server-acp → runner-harness → same runners
Dependencies:
✅ @bunny-agent/runner-harness (dispatches to every runner)
✅ @bunny-agent/server-acp (the `acp` subcommand's ACP agent + stdio transport)
❌ NO @bunny-agent/manager
❌ NO @bunny-agent/sandbox-*
与管理者- cli 的区别 :
runner-cli: 本地文件系统, 不隔离, 轻量级, 直接跑道使用manager-cli: 沙箱执行,使用管理器+沙箱适配器+跑取器
安装
# Global install (recommended if you want the `bunny-agent` command)
npm install -g @bunny-agent/runner-cli@latest
# Or add to a project
npm install @bunny-agent/runner-cli@latest
使用量
bunny-agent run [options] -- "<user input>"
不在全球安装,您也可以通过 npx数字 :
npx -y @bunny-agent/runner-cli@latest run -- "Create a hello world script"
基本实例
# Using Claude (default)
bunny-agent run -- "Create a hello world script"
# Explicitly choose Claude
bunny-agent run --runner claude -- "Create a hello world script"
# Using Codex
bunny-agent run --runner codex -- "Build a REST API with Express"
# Using Gemini
bunny-agent run --runner gemini -- "Build a REST API with Express"
# Using GitHub Copilot
bunny-agent run --runner copilot -- "Refactor this code"
# With custom system prompt
bunny-agent run --runner claude --system-prompt "You are a coding assistant" -- "Build a REST API with Express"
选项
| 选项 | 短数 | 说明 | 默认 |
|---|---|---|---|
--runner <runner> | -r | 要使用的运行器 : claude, (中文(简体) ), codex, (中文(简体) ), gemini, (中文(简体) ), opencode, (中文(简体) ), copilot, (中文(简体) ), pi | claude |
--model <model> | -m | 要使用的模型 | claude-sonnet-4-20250514 |
--cwd <path> | -c | 工作目录 | 当前目录 |
--system-prompt <prompt> | -s | 自定义系统提示 | - 说吧 |
--max-turns <n> | -t | 最大对话回合 | - 说吧 |
--allowed-tools <tools> | -a | 以逗号分隔的允许工具列表 | - 说吧 |
--yolo | - 说吧 | 自动批准工具权限请求 | false |
--effort <level> | - 说吧 | 合理努力或思维水平,取决于跑者 | - 说吧 |
--resume <session-id> | - 说吧 | 恢复上届会议 | - 说吧 |
--help | -h | 显示帮助消息 | - 说吧 |
--allowed-tools 限制内置跑道工具。 提供自定义工具
通过SDK streamText({ tools }) API,不是直接通过跑道-cli.
输出格式
bunny-agent run 总是输出AI SDK数据流(SSE)格式,一发-
它运行的任务和出口.
bunny-agent run -- "Calculate 2+2"
输出 :
data: {"type":"start","messageId":"msg_123"}
data: {"type":"text-delta","id":"text_1","delta":"The answer is 4."}
data: [DONE]
对于非加太议定书,使用 bunny-agent acp - 见下文。 两个是
单独的子命令, 而不是旗子 run:非加太是长时期的会话
(单位:千美元)initialize → session/new 可能有许多人 session/prompt 来自
连接编辑器),而不是一个请求/答复.
bunny-agent acp
担任兔子代理 代理客户协议
代理人 运输编辑器在生产毒剂时使用
二进制直接,例如Zed的"客户代理"设置或JetBrains的AI助手
代理整合。 处理JSON -RPC的程序依然有效
stdin/ stdout 直到连接客户端断开; 它不需要一个
任务参数如 run 已经.
bunny-agent acp --runner claude
bunny-agent acp --runner pi --model gemini-2.0-flash --cwd ./my-project
| 选项 | 短数 | 说明 | 默认 |
|---|---|---|---|
--runner <runner> | -r | 要使用的运行器 : claude, (中文(简体) ), codex, (中文(简体) ), gemini, (中文(简体) ), opencode, (中文(简体) ), copilot, (中文(简体) ), pi | claude |
--model <model> | -m | 要使用的模型 | claude-sonnet-4-20250514 |
--cwd <path> | -c | 工作目录 | 当前目录 |
--yolo | - 说吧 | 自动批准工具权限请求 | false |
--help | -h | 显示帮助消息 | - 说吧 |
这些旗帜设置了 默认会话. 非加太国家 session/new 没有本地人
运行/ 模型字段, 这样连接客户端仍然可以覆盖每个会话
通过协议 _meta 扩展名, 名称空格 "bunny-agent"数字 :
{ "cwd": "/workspace", "mcpServers": [],
"_meta": { "bunny-agent": { "runner": "pi", "model": "gemini-2.0-flash" } } }
将非CAP客户端指向 CLI 本身作为代理命令( 精确 ) 配置是针对客户的 — 见每个编辑的 ACP Docs :
{ "command": "bunny-agent", "args": ["acp", "--runner", "claude"] }
相当于HTTP的POST /api/coding/acp,由守护进程代替使用
产入子进程,见
apps/daemon/README.md两者都是
由 @bunny-agent/server-acp 并且支持这个CLI的每一个跑者.
环境变量
| 变量 | 说明 | 需求 |
|---|---|---|
ANTHROPIC_API_KEY | Anthropic API 密钥( 克劳德跑车) | 没有 |
OPENAI_API_KEY 或者说 CODEX_API_KEY | OpenAI API 密钥( Codex 运行器) | 没有 |
GEMINI_API_KEY | 双子座 API 键( Gemini 跑者) | 没有 |
GITHUB_TOKEN 或者说 GH_TOKEN | GitHub 令牌( 副驾驶长); 返回登录的副驾驶用户 | 没有 |
BUNNY_AGENT_WORKSPACE | 默认工作空间路径 | 没有 |
BUNNY_AGENT_LOG_LEVEL | 日志级别( 调试、 信息、 警告、 错误) | 没有 |
高级示例
指定工作目录
bunny-agent run --cwd ./my-project -- "Fix the bug in main.ts"
组合选项
bunny-agent run \
-m claude-sonnet-4-20250514 \
--system-prompt "You are a helpful coding assistant" \
--max-turns 10 \
-- "Build a REST API"
建筑
国家倡议旨在:
- 在特定工作目录中执行
- 装入设置从
.claude/settings.json财务报告和审定财务报表CLAUDE.md在项目中 - 将 AI SDK UI 信件直接流到 stdout
- 输出 AI SDK 数据流格式
+++ Docker 图像构建
用代理模板在 :
# Build image
bunny-agent image build --name vikadata/bunny-agent-seo --tag 0.1.0 --template ./templates/seo-agent
# Build and push
bunny-agent image build --name vikadata/bunny-agent-seo --tag 0.1.0 --template ./templates/seo-agent --push
# Without template
bunny-agent image build --name vikadata/bunny-agent --tag 0.1.0
图像构建选项
| 选项 | 说明 | 默认 |
|---|---|---|
--name <name> | 全图像名( 如. vikadata/bunny-agent-seo(中文(简体) ) | bunny-agent |
--tag <tag> | 图像标签 | latest |
--image <full> | 完整图像名称覆盖( 例如 ). myorg/myimage:v1(中文(简体) ) | - 说吧 |
--platform <plat> | 构建平台 | linux/amd64 |
--template <path> | 代理模板目录路径 | - 说吧 |
--push | 构建后将图像推向注册 | false |
相关文档
- 技能 - 技能所在和装载方式(当地和多克)
- 克劳德探员SDK
- AI SDK UI流协议
- 代理客户协议 - 议定书
bunny-agent acp说话 - 运行器成熟度/ 输出协议 - 怎么样
run财务报告和审定财务报表acp比较