New: 98,000+ skills indexed from GitHub repos with 100+ stars · every skill safety-checkedBrowse top skillsTop skills
Esc to closeBrowse all skills
Submit a skillBrowse skills
Submit a skillBrowse skills

Agent skill

Agentbox

by madarco in madarco/agentbox

Fork the current agent session into a new VM or local Docker container with all the project files, agent settings and session teleported into.

MITAuto-check: warningsDevOps & Cloud

Install Agentbox

The automated check flagged lines worth reading first. See the safety section below.

skills CLI
$ npx skills add madarco/agentbox --skill agentbox -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install madarco/agentbox agentbox --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/madarco/agentbox.git skills-src && mkdir -p .claude/skills && cp -r skills-src/apps/cli/share/host-skills/agentbox .claude/skills/agentbox && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
agentbox
GitHub stars
523
Token cost
~811 tokens
SKILL.md length
440 words
Files
1
Skills in repo
4
Repo updated
First seen
Licence
MIT

At a glance

Fork the current agent session into a new VM or local Docker container with all the project files, agent settings and session teleported into.

  • Works in 4 steps: Resolve the provider flag from $ARGUMENTS → Detect an active plan (optional --plan).… → Fork. If you are in plan mode, exit it,… → …
  • Tasks that involve Containers
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Agentbox is an agent skill from madarco/agentbox. Fork the current agent session into a new VM or local Docker container with all the project files, agent settings and session teleported into.

Its SKILL.md is about 810 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in DevOps & Cloud, covering Containers. It works with Docker. The repository describes itself as: Run multiple agents in parallel sandboxed VMs, with a single command, on your PC or in the cloud. The licence is MIT.

When your agent uses it

  • Tasks that involve Containers

Example prompts

  • “/agentbox”

Requirements

  • Docker
  • Pre-approved tools (allowed-tools): Bash

Workflow steps

4 steps, taken from the first numbered list in SKILL.md.

  1. Resolve the provider flag from $ARGUMENTS
  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…
  3. Fork. If you are in plan mode, exit it, then run, via the Bash tool, exactly one command (add --plan "" only if step 2 found a plan). Do…
  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…

What it can do on your machine

Read from SKILL.md and the folder at commit 605ee75. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves these tools, so the agent can use them without asking each time:

    • Bash

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Agentbox loads about 811 tokens when it runs. Until then it costs about 38 tokens; SKILL.md has 440 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~38
When it runs · the whole SKILL.md, loaded when a task matches
~811

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check: warnings

The automated check found patterns that need a careful read before installing.

  • WarningMentions a credentials file (SSH keys, cloud or package-manager tokens)SKILL.md:40
    ll <box> --ssh-config          # writes ~/.ssh/config + prints details
  • NotePre-approves every shell command (allowed-tools: Bash)SKILL.md
    allowed-tools: Bash

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from madarco/agentbox at commit 605ee75, republished under its MIT licence (© madarco). 440 words, ~811 tokens.

Download SKILL.mdSave it as .claude/skills/agentbox/SKILL.md (or your agent's skills folder).
name
agentbox
description
Fork the current agent session into a new VM or local Docker container with all the project files, agent settings and session teleported into.
allowed-tools
Bash
disable-model-invocation
true
context
fork
agent
general-purpose
<!-- agentbox-managed:v1 -->

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.

Show full SKILL.md (135 more words)Show less

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.

© madarco, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in apps/cli/share/host-skills/agentbox of madarco/agentbox.

Open the folder on GitHubat commit 605ee75

Compare with similar skills

Agentbox next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Agentbox compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Agentbox this skillmadarco/agentbox523—~811Automated safety check: WarnMIT
Iron Proxy Gateway for NanoClawnanocoai/nanoclaw31k—~4.6kAutomated safety check: NotesMIT
GreptimeDB Dev Docker ImageGreptimeTeam/greptimedb6.7k—~4kAutomated safety check: NotesApache-2.0
Senior DevOps Toolkitmaslennikov-ig/claude-code-orchestrator-kit2606 repos~1.1kAutomated safety check: NotesCustom licence
LangBot Deployment Guidelangbot-app/LangBot18k—~1.2kAutomated safety check: NotesApache-2.0
Build Openshell Mxc WindowsNVIDIA/OpenShell15k—~4.9kAutomated safety check: PassApache-2.0

Similar skills

  • Iron Proxy Gateway for NanoClaw

    nanocoai/nanoclaw

    Installs or refreshes Iron Proxy and its Iron Control web console for NanoClaw, with a local Docker setup, database, credentials and a human approval bridge.

    31k GitHub stars~4.6k tokensUpdated 2 days ago
    DevOps & CloudAuto-check: notes

  • GreptimeDB Dev Docker Image

    GreptimeTeam/greptimedb

    Packages a locally built GreptimeDB debug binary into a development-only Docker image for local-cluster testing, with an optional push to a dev registry.

    6.7k GitHub stars~4k tokensUpdated today
    DevOps & CloudAuto-check: notes

  • Senior DevOps Toolkit

    maslennikov-ig/claude-code-orchestrator-kit

    Comprehensive DevOps skill for CI/CD, infrastructure automation, containerization, and cloud platforms (AWS, GCP, Azure). Includes pipeline setup…

    260 GitHub starsUsed in 6 repos~1.1k tokens
    DevOps & CloudAuto-check: notes

  • LangBot Deployment Guide

    langbot-app/LangBot

    Deploys and configures a LangBot instance with Docker Compose or Kubernetes, covering config.yaml, the Box sandbox runtime, the plugin runtime and the global API key.

    18k GitHub stars~1.2k tokensUpdated yesterday
    DevOps & CloudAuto-check: notes

  • Build Openshell Mxc Windows

    NVIDIA/OpenShell

    Official

    Maintain and validate OpenShell's build-only Windows MSVC lane for x64 and ARM64.

    15k GitHub stars~4.9k tokensUpdated today
    DevOps & CloudAuto-check passed

  • Omnigent Docker Compose Deploy

    omnigent-ai/omnigent

    Brings up the Omnigent server and Postgres as a Docker compose stack on any Docker host, and covers the Dockerfile's runtime and host build targets for extending it to a new platform.

    11k GitHub stars~1.3k tokensUpdated today
    DevOps & CloudAuto-check: notes

More from madarco/agentbox

  • Agentbox Info

    madarco/agentbox

    Spin up isolated sandboxes ("boxes") for coding agents, run them in parallel, queue background runs with -i, and push commits safely through the host relay.

    523 GitHub starsUsed in 1 repo~6.6k tokens
    Auto-check: warnings

  • Agentbox Setup

    madarco/agentbox

    Generate an agentbox.yaml for the current AgentBox workspace.

    523 GitHub stars~5.9k tokensUpdated yesterday
    Auto-check: notes

  • Agentbox Identity

    madarco/agentbox

    Write this bot's identity replacement rules into agentbox.yaml, so a copy of it spawned with agentbox clone gets its own name instead of yours.

    523 GitHub stars~1k tokensUpdated yesterday
    Auto-check passed

Works with

Categories

Questions about Agentbox

What does Agentbox do?

Fork the current agent session into a new VM or local Docker container with all the project files, agent settings and session teleported into. Agentbox is an agent skill from madarco/agentbox. Fork the current agent session into a new VM or local Docker container with all the project files, agent settings and session teleported into.

When should I use Agentbox?

Agentbox fits situations like: tasks that involve Containers.

How do I install Agentbox in Claude Code?

Run `npx skills add madarco/agentbox --skill agentbox -a claude-code`. Or copy the skill folder (apps/cli/share/host-skills/agentbox in madarco/agentbox) into .claude/skills/agentbox in your project. Claude Code loads it when a task matches its description.

How do I install Agentbox in Codex?

Run `npx skills add madarco/agentbox --skill agentbox -a codex`. Or copy the skill folder (apps/cli/share/host-skills/agentbox in madarco/agentbox) into .agents/skills/agentbox in your project. Codex loads it when a task matches its description.

Can I use Agentbox in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add madarco/agentbox --skill agentbox -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/agentbox, .gemini/skills/agentbox, .github/skills/agentbox and .opencode/skills/agentbox in your project.

What does Agentbox need to run?

SKILL.md names no scripts, command-line tools or credentials: Agentbox is instructions for the agent only. Our summary lists: Docker. Its frontmatter pre-approves these tools: Bash.

Does Agentbox access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Agentbox safe to install?

Our automated static check of SKILL.md flagged 1 warning(s): mentions a credentials file (ssh keys, cloud or package-manager tokens). Read the flagged lines before installing; the check is not a guarantee either way.

What licence does Agentbox use?

Agentbox is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Agentbox use?

About 811 tokens (SKILL.md is roughly 3.2k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Agentbox?

Skills that share tags, products or a category with Agentbox: Iron Proxy Gateway for NanoClaw (nanocoai/nanoclaw, 31k stars), GreptimeDB Dev Docker Image (GreptimeTeam/greptimedb, 6.7k stars), Senior DevOps Toolkit (maslennikov-ig/claude-code-orchestrator-kit, 260 stars) and LangBot Deployment Guide (langbot-app/LangBot, 18k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Agentbox?

madarco (a GitHub user) maintains it in madarco/agentbox, which has 523 GitHub stars. The repository holds 4 skills in this directory. The repository was last updated on October 7, 2026.

Source: madarco/agentbox on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.