Skip to main content
Amika is an open-source CLI and HTTP API for running coding agents in sandboxes.

​
Core concepts

  • Docker-backed sandboxes: Isolated, persistent containers for agent execution.
  • Mount modes: ro, rw, and rwcopy define how agents can access data.
  • Credential discovery: Amika discovers local coding-agent credentials and mounts snapshots into containers.
  • Preset images: Bundled images (coder, claude) with common tooling.
  • Services: Named network-facing components with port mappings and URL schemes, declared in .amika/config.toml.
  • Materialization: Ephemeral containers run scripts or commands and copy outputs to host paths.

​
Command surface

CommandPurpose
amika sandbox create/list/connect/deleteManage persistent sandboxes
amika volume list/deleteManage tracked volumes created by rwcopy mounts
amika auth extractDiscover and print credentials
amika service listList services declared in sandbox configs
amika materializeRun command/script and copy output files
amika-serverExpose API over HTTP

​
Package layout

cmd/amika            # CLI entrypoints
cmd/amika-server     # HTTP server entrypoint
internal/sandbox     # Sandbox + Docker operations
internal/auth        # Credential discovery
internal/agentconfig # Agent config auto-mounting
internal/httpapi     # REST handlers
pkg/amika            # Shared service API

​
Dependencies

ToolRequired by
Gitwhen making sandboxes from your repos in hosted or local mode
Dockermaterialize, sandbox, volume (only required in local mode)
rsyncmaterialize output copy

​
State storage

State files are stored in XDG paths by default. See Storage paths for exact locations.