Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.charmos.io/llms.txt

Use this file to discover all available pages before exploring further.

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,
  • mode mismatches between standard and full.

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.