Fork the current Claude Code session into a fresh AgentBox box.
Resolve the provider flag from $ARGUMENTS:
- empty → no flag (uses the default docker provider)
docker | daytona | hetzner | vercel | e2b → pass --provider $ARGUMENTS- anything else → stop and tell the user the valid values are
docker, daytona, hetzner, vercel, e2b
Detect an active plan (optional --plan). If this session was just working on a Claude Code plan, carry it into the box so the fork resumes in plan mode.
If you know the plan file path for this session (plan mode writes it to ~/.claude/plans/<slug>.md, and you have it from the plan you just produced in this conversation), use that path.
Otherwise, find the most recent plan only if it was touched in the last 15 minutes (a stale plan from another task should not be resurrected). Run via the Bash tool:
find "$HOME/.claude/plans" -name '*.md' -mmin -15 -type f 2>/dev/null \
| xargs -r ls -t 2>/dev/null | head -1
If it prints a path, that's the current plan; if it prints nothing, there is no active plan — skip --plan.
Fork. If you are in plan mode, exit it, then run, via the Bash tool, exactly one command (add --plan "<path>" only if step 2 found a plan). Do NOT pass --session: agentbox fork autodetects the current Claude session itself (and safely falls back to the newest session for this workspace), which is correct even when this skill runs in a subagent where $CLAUDE_CODE_SESSION_ID would be the subagent's id, not the conversation you want to fork:
agentbox fork [--provider $ARGUMENTS] [--plan "<plan path>"]
Report. In one line, give the user the new box name (parse it from the command output) and confirm their host session is unaffected. If you passed --plan, mention the box opens in plan mode ready to resume. Do not summarize the conversation — the fork already carries it.
For Hetzner cloud boxes only, when in Codex App or Claude Desktop, use can add a ssh connection to the box. To do this first add an alias to their ssh config, then instruct them how to add the connection:
agentbox shell <box> --ssh-config # writes ~/.ssh/config + prints details
to add a ssh alias that the user can use to connect to the box
When in Codex App return a clickable link in the response for an easy way:
[Add <ssh-alias> to Codex SSH](codex://settings/connections/ssh/add?name=<ssh-alias>)
Troubleshooting
- If agentbox command fails, tell the user to install AgentBox by writing
! npm -g install @madarco/agentbox in the chat.
- If
AGENTBOX_RELAY_URL is set in the environment, you are running inside a box. This command is host-only in v1; tell the user box→box fork is not supported yet.
- If you need to know more about Agentbox, check the /agentbox-info skill that containes the full documentation.
1---2name: agentbox3description: Fork the current agent session into a new VM or local Docker container with all the project files, agent settings and session teleported into.4---5<!-- agentbox-managed:v1 -->67Fork the current Claude Code session into a fresh AgentBox box.891. **Resolve the provider flag from `$ARGUMENTS`:**10 - empty → no flag (uses the default docker provider)11 - `docker` | `daytona` | `hetzner` | `vercel` | `e2b` → pass `--provider $ARGUMENTS`12 - anything else → stop and tell the user the valid values are `docker`, `daytona`, `hetzner`, `vercel`, `e2b`13142. **Detect an active plan (optional `--plan`).** If this session was just working on a Claude Code plan, carry it into the box so the fork resumes in plan mode.15 - **If you know the plan file path** for this session (plan mode writes it to `~/.claude/plans/<slug>.md`, and you have it from the plan you just produced in this conversation), use that path.16 - **Otherwise**, find the most recent plan only if it was touched in the last 15 minutes (a stale plan from another task should not be resurrected). Run via the Bash tool:1718 ```19 find "$HOME/.claude/plans" -name '*.md' -mmin -15 -type f 2>/dev/null \20 | xargs -r ls -t 2>/dev/null | head -121 ```2223 If it prints a path, that's the current plan; if it prints nothing, there is no active plan — skip `--plan`.24253. **Fork.** If you are in plan mode, exit it, then run, via the Bash tool, exactly one command (add `--plan "<path>"` only if step 2 found a plan). Do NOT pass `--session`: `agentbox fork` autodetects the current Claude session itself (and safely falls back to the newest session for this workspace), which is correct even when this skill runs in a subagent where `$CLAUDE_CODE_SESSION_ID` would be the subagent's id, not the conversation you want to fork:2627 ```28 agentbox fork [--provider $ARGUMENTS] [--plan "<plan path>"]29 ```30314. **Report.** In one line, give the user the new box name (parse it from the command output) and confirm their host session is unaffected. If you passed `--plan`, mention the box opens in plan mode ready to resume. Do not summarize the conversation — the fork already carries it.3233For Hetzner cloud boxes only, when in Codex App or Claude Desktop, use can add a ssh connection to the box. To do this first add an alias to their ssh config, then instruct them how to add the connection:3435```36agentbox shell <box> --ssh-config # writes ~/.ssh/config + prints details37```3839to add a ssh alias that the user can use to connect to the box4041When in Codex App return a clickable link in the response for an easy way:42```43[Add <ssh-alias> to Codex SSH](codex://settings/connections/ssh/add?name=<ssh-alias>)44```4546## Troubleshooting4748- If agentbox command fails, tell the user to install AgentBox by writing `! npm -g install @madarco/agentbox` in the chat.49- If `AGENTBOX_RELAY_URL` is set in the environment, you are running *inside* a box. This command is host-only in v1; tell the user box→box fork is not supported yet.50- If you need to know more about Agentbox, check the /agentbox-info skill that containes the full documentation.
madarco