mcpField
A
agentbox

agentbox

github.com/madarcoAgent 工作流560203 次安装5 周前更新
代码仓库

关于 agentbox

这项技能可将当前 Claude Code 会话分叉到新的 AgentBox 环境。它支持选择服务提供方，并可将正在使用的计划带入新环境。

主要功能

  1. 01分叉当前 Claude Code 会话
  2. 02选择支持的 Box 服务提供方
  3. 03将活动计划带入新环境
  4. 04为 Hetzner Box 准备 SSH 连接

适用场景

  1. 01在独立 Box 中继续会话
  2. 02在新 Box 中恢复活动计划
  3. 03设置到 Hetzner Box 的 SSH 连接

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/madarco/agentbox --skill agentbox

安装后在 Claude Code 中输入/agentbox确认已加载。

详细介绍

将当前 Claude Code 会话分叉到一个全新的 AgentBox box 中。

  1. 从 $ARGUMENTS 解析 provider 标志：

    • 为空 → 不添加标志（使用默认的 docker provider）
    • docker | daytona | hetzner | vercel | e2b → 传入 --provider $ARGUMENTS
    • 其他任何值 → 停止并告知用户，有效值为 docker、daytona、hetzner、vercel、e2b

  2. 检测活动计划（可选的 --plan）。 如果此会话刚刚处理过 Claude Code 计划，请将其带入 box，以便分叉后的会话以计划模式继续。

    • 如果你知道此会话的计划文件路径（计划模式会将文件写入 ~/.claude/plans/<slug>.md，你可以从本次对话中刚生成的计划中获取该路径），请使用该路径。

    • 否则，仅当最近的计划在过去 15 分钟内有过修改时才查找它（不要恢复其他任务遗留的过期计划）。通过 Bash 工具运行：

      find "$HOME/.claude/plans" -name '*.md' -mmin -15 -type f 2>/dev/null \
  | xargs -r ls -t 2>/dev/null | head -1

      如果输出路径，该路径就是当前计划；如果没有输出，则没有活动计划，跳过 --plan。

  3. 分叉。 如果你处于计划模式，请先退出，然后通过 Bash 工具运行且仅运行一条命令（仅当步骤 2 找到计划时才添加 --plan "<path>"）。不要传入 --session：agentbox fork 会自动检测当前 Claude 会话本身（并在安全的情况下回退到此工作区中最新的会话）。即使此技能在子 Agent 中运行，这也是正确的做法，因为 $CLAUDE_CODE_SESSION_ID 可能是子 Agent 的 ID，而不是你要分叉的对话的 ID：

    agentbox fork [--provider $ARGUMENTS] [--plan "<plan path>"]

  4. 报告。 用一行告知用户新 box 的名称（从命令输出中解析），并确认其主机会话不受影响。如果传入了 --plan，请说明该 box 将以计划模式打开，可直接继续。不要总结对话——分叉后的会话已包含对话内容。

仅对于 Hetzner 云 box，在 Codex App 或 Claude Desktop 中，用户可以添加到该 box 的 ssh 连接。请先在其 ssh 配置中添加别名，然后指导他们添加连接：

agentbox shell <box> --ssh-config          # writes ~/.ssh/config + prints details

添加用户可用于连接该 box 的 ssh 别名

在 Codex App 中，请在回复中提供一个可点击的链接，方便用户操作：

[Add <ssh-alias> to Codex SSH](codex://settings/connections/ssh/add?name=<ssh-alias>)

故障排除

  • 如果 agentbox 命令失败，请在聊天中提示用户通过 ! npm -g install @madarco/agentbox 安装 AgentBox。
  • 如果环境中设置了 AGENTBOX_RELAY_URL，则表示你正在 box 内运行。此命令在 v1 中仅支持主机端；请告知用户目前尚不支持 box→box 分叉。
  • 如果需要了解更多 Agentbox 信息，请查看包含完整文档的 /agentbox-info 技能。

评论

支持 Markdown