For the complete documentation index, see llms.txt. Markdown versions of all docs pages are available by appending .md to any docs URL.
Sandboxes
Run commands and work with files in isolated scratch environments that people, applications, and agents create on demand.
A kagent SandboxSandboxA kagent runtime that provides an isolated scratch environment for running commands and working with files. Created from a SandboxTemplate, it belongs to its caller, expires on a timer, and has no outbound network access unless an EgressPolicy allows it.Learn more is an isolated scratch environment that you create on demand, run commands in, and then delete or let expire. Each Sandbox runs on Agent Substrate behind the same isolation boundary as an agent, and it has no outbound network access unless you grant it.
Use a Sandbox when something other than an agent’s own harness needs a place to run code. Examples include a model’s generated script, a test that must not change the host, or a tool call that an agent sends from outside the cluster. A person reaches a Sandbox through the kagent CLI, an application through gRPC, and an agent through the kagent Model Context Protocol (MCP) server.
About sandboxes
Learn what a Sandbox is, when to use one instead of an agent, and how its lifecycle, storage, …
Set up sandbox templates
Turn on Sandboxes in your installation, choose a tools image, and create the SandboxTemplate that …
Run commands with the CLI
Create a Sandbox, run commands, move files in and out, and suspend, resume, and delete it with the …
Give an agent a sandbox
Bind the kagent MCP server’s sandbox tools to an agent, so that the agent can run the code that it …
Use sandboxes from an MCP client
Connect Claude Code, Codex, Cursor, or another MCP client to kagent’s MCP server, and run the …
Use sandboxes with the gRPC API
Create a Sandbox, write a file, run a process, and stream its output from your own application by …
Host sandboxes for Claude Managed Agents
Run the code execution sandboxes of Claude Managed Agents on your own cluster, while Anthropic hosts …