Agentbox

Agentbox is an open-source agent harness and isolation orchestrator created by Marco Madarco. It provides structured runtime sandboxes and host-agent bridging mechanisms designed to run AI coding assistants, such as Claude Code and OpenAI Codex, with controlled access to host resources. In standard workflows, Agentbox operates through a CLI utility and installable skills for host-side agents. It configures execution sandboxes for coding agents, provides host relays for operations such as Git interactions, and supports queuing agent tasks in the background. Developers prepare environments using provider-specific commands and dispatch coding agents into designated target sandboxes. Agentbox differentiates itself by focusing on the harness and isolation layer rather than building a proprietary model agent. It treats agents as modular workers, enabling host-side tools, background processing queues, and native plugin integration for major agent interfaces while keeping the development host safeguarded. Agentbox is open-source software distributed on GitHub, actively maintained with plugin integrations for both Claude Code and Codex ecosystems.

Tags: agent harness, ai agent, cli, coding agent, developer tools, OpenSource

Visit Agentbox

Key features

  • Agent Sandbox Orchestration — Spawns and manages isolated environments tailored for running coding agents without polluting host environments. - Host Relay Architecture — Safely mediates host capabilities such as Git credentials and version control access into the isolated box. - Provider Environment Preparation — Configures dependencies and runtimes for agent engines using the agentbox prepare workflow. - Codex and Claude Skill Integrations — Distributes plug-and-play skills and plugins for both OpenAI Codex and Claude Code host orchestrators. - Background Queue Execution — Handles asynchronous task execution and prompt pipelines using the -i background queue. - Desktop Tray Management — Includes an optional companion menu-bar application to monitor and manage running agent boxes.

Use cases

Use Case: Sandboxed Coding Agent Runs Developers running autonomous coding tools can isolate file edits, package installations, and execution risks inside an Agentbox container while maintaining Git commit abilities via the host relay.

Use Case: Asynchronous Task Queuing Engineers can queue long-running agent tasks, such as repo-wide migrations or multi-file test generation, into the background queue using -i without blocking their active terminal session.

Use Case: Host-Agent Tool Integration Teams using Claude Code or Codex can install the Agentbox skill plugin directly, allowing the primary agent to programmatically spin up, drive, and inspect secondary sandboxed instances.

Who it is for

Agentbox is intended for software engineers and DevOps practitioners who run autonomous terminal agents (such as Claude Code) and require containment, background job execution, and credential-safe host relays. It is not designed for non-technical users or developers seeking a simple chat-based IDE extension.

Install guide

Installation Install Agentbox via your agent plugin manager or direct skill install: bash # Install as a Claude Code skill npx skills add https://github.com/madarco/agentbox --skill agentbox # Or add to Codex codex plugin marketplace add madarco/agentbox codex plugin add agentbox@agentbox

First Run Prepare your desired provider environment: bash agentbox prepare --provider claude

Example Session Create a new sandbox box and run an isolated coding agent task: bash agentbox create agentbox claude "Refactor the authentication middleware to use JWT tokens"

Part of CLI Coding Agents

Categories: AI Coding Agents, Code Assistants, Developer Tools

Related CLI agents

  • SWE-agent — SWE-agent is an open-source autonomous software engineering agent harness built and maintained by researchers from Princeton University and Stanford University.…
  • Agent Runbook — Agent Runbook is an open-source contract-based multi-agent skill framework developed by KnoxOps. It acts as an orchestrator and compiler that…
  • Weaver — Weaver is an open-source agent harness and orchestration framework maintained by sean35mm on GitHub. Built on top of the Bun…
  • Context Bridge — Context Bridge is an open-source CLI agent harness and context orchestration utility developed by serdardb. It is built to facilitate…
  • Hivelore — Hivelore is an open-source agent harness and contextual memory orchestrator created by Doucs91. It provides persistent project memory, decision tracking,…
  • Agentic Engineering Framework — Agentic Engineering Framework is an open-source orchestration harness and governance layer developed by Dimitri Geelen. It is designed to constrain,…
  • AI Tools
  • Categories
  • Industries
  • CLI Coding Agents
  • MCP Servers
  • MCP Categories