Skip to main content
This quickstart walks you through a minimal Amika flow:
  1. Build Amika.
  2. Create your first sandbox from a git repo.
  3. Run an agent inside the sandbox.

​
Prerequisites

  • macOS or Linux
  • Go 1.21 or later
  • Docker
Amika is in beta. CLI flags and APIs may change.

​
Step 1: Build Amika

git clone https://github.com/gofixpoint/amika.git
cd amika
make build

​
Step 2: Create your first sandbox

Run this inside a git repository. --git mounts the repo root into the sandbox. 
./dist/amika sandbox create --name my-sandbox --git --connect
Inside the sandbox, your shell starts in /home/amika/workspace/{repo}.

​
Step 3: Run a coding agent in the sandbox

# Run from inside the sandbox shell
claude "Add unit tests for the auth module"

​
Optional: run agents in parallel

./dist/amika sandbox create --name task-1 --git
./dist/amika sandbox create --name task-2 --git
./dist/amika sandbox list

​
Next steps

Sandbox configuration

Configure setup scripts and credential auto-mounting.

Presets

Pick preset images like coder and claude.

Development testing

Run make test-* and coverage checks locally.

Auth extract

Export discovered keys for Claude, Codex, and OpenCode.

CLI reference

See full command and flag documentation.
Use amika sandbox list and amika volume list to inspect active sandboxes and tracked volumes.