Agent
Command to run coding agents in a sandbox and manage the Docker sandbox backend
The agent command runs coding agents through the Stashbase Agent Proxy, either in the native OS sandbox or in an isolated Docker sandbox.
stashbase agent <COMMAND> [OPTIONS]This page covers Docker sandbox options and commands. For profiles, sessions, MCP, and logs, see the Agents guide.
Run
Run an agent with a profile. Pass the agent's command after --.
stashbase agent run --profile <PROFILE> [OPTIONS] -- <COMMAND>Docker sandbox options
These options override the profile's [sandbox] settings for a single run.
Prop
Type
stashbase agent run --profile coding --docker-sandbox true -- claude
stashbase agent run --profile coding --docker-image node:22-alpine --docker-memory 2g -- codexDocker
Manage Docker sandbox backend resources.
stashbase agent docker <COMMAND> [OPTIONS]Doctor
Check whether the Docker sandbox backend can run on this machine: the docker CLI, the daemon, and the default image. Exits non-zero if anything isn't ready.
stashbase agent docker doctor [--json]Build
Build or rebuild the default Docker sandbox image from the default Dockerfile.
stashbase agent docker build [OPTIONS]Prop
Type
Status
List Docker sandbox networks and containers on this machine, with session ID, creation time, and whether each belongs to a live local session.
stashbase agent docker status [--json]Cleanup
Find and remove networks and containers left behind by a run that didn't tear down cleanly, for example after stashbase was killed with SIGKILL. Resources that belong to live local sessions are skipped.
stashbase agent docker cleanup [OPTIONS]Prop
Type