mcpField
A
agentbox

agentbox

github.com/madarcoAgent workflows560203 installsUpdated 5w ago
Repository

About agentbox

A skill that forks the current Claude Code session into a fresh AgentBox environment. It can select a provider and carry an active plan into the new box.

Key features

  1. 01Forks the current Claude Code session
  2. 02Selects among supported box providers
  3. 03Carries an active plan into the box
  4. 04Can prepare SSH access for Hetzner boxes

Use cases

  1. 01Continue a session in a separate box
  2. 02Resume an active plan in a new box
  3. 03Set up SSH access to a Hetzner box

Install

Copy the command and run it in a terminal.

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

After installing, type/agentboxin Claude Code to confirm it loaded.

Details

From the project README

Fork the current Claude Code session into a fresh AgentBox box.

  1. 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

  2. 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.

  3. 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>"]

  4. 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.

Comments

Markdown supported