AgentBox 在用户主机（笔记本或开发机）上运行，用 agentbox CLI 为编程智能体创建隔离沙箱（box）。默认使用本地 Docker 容器，也可通过 --provider 选择 hetzner、vercel、e2b 或 daytona（部分支持）。每个 box 有独立 /workspace，但共享主机的 .git/，因此 box 内提交会立即落到主机。box 内没有主机凭据，git push、打开主机浏览器 URL、捕获检查点等主机侧操作都经过名为 relay 的主机进程。
主要命令：agentbox create 只创建 box；agentbox claude（以及 codex、opencode）创建后在可分离的 tmux 会话中启动对应智能体。常用参数有 -n 命名、--provider 选择提供方、--attach、-w 指定工作区、--snapshot 从检查点启动。非 Docker 提供方需先执行一次 agentbox prepare --provider <name>。
使用 -i/--initial-prompt 可把任务写入 ~/.agentbox/queue/ 后台队列，立即返回并打印作业 id 与日志路径，由 relay 队列循环按 queue.maxConcurrent（可用 --max-running 覆盖）并发执行，适合并行分派多个智能体任务，之后用 agentbox dashboard 查看或用 attach 重新进入。
还能用 agentbox drive 读取屏幕、发送按键与文本；用 agentbox agent state / wait-for input-needed 获取智能体状态并在其需要输入时唤醒；用 agentbox queue wait-for 等待队列或 box 生命周期事件。所有命令无状态，支持 --json。git push 经过主机 relay 使用主机凭据执行，可能触发约 25 秒的主机确认；PR 操作通过 agentbox-ctl git pr 调用主机 gh。限制：需要主机具备相应凭据与依赖（如 gh 已登录），box 内无凭据，不能绕过审批门。具体收费、价格与更多细节资料暂未提供。