Skip to main content
Docker sandbox mode runs your agent in a local container so you can catch runtime issues before publishing.

​
Prerequisites

  • Docker Desktop or Docker Engine.
  • charmos[runner] installed.

​
Run in Docker

charm run . --input "Hello" --docker
With JSON: 
charm run . --json '{"message": "Hello"}' --docker

​
Mock OAuth and Skills

charm run . --json '{"message": "Check my calendar"}' --docker --mock-oauth
charm run . --json '{"message": "Use a tool"}' --docker --mock-skills

​
Why Use It

Docker mode helps catch:
  • missing dependencies,
  • Linux/runtime differences,
  • hardcoded local paths,
  • missing environment variables,
  • base image and adapter incompatibilities.

​
Limits

Local Docker is close to the cloud runtime, but not identical. Always run a staging or Store smoke test before relying on production behavior.