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

​
Prerequisites

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

​
Step 1: Install the CLI

curl -fsSL https://raw.githubusercontent.com/gofixpoint/amika/main/install.sh | sh

​
Step 2: Log in

Authenticate with Amika using the WorkOS device authorization flow. This opens your browser for approval. 
amika auth login
Verify your session: 
amika auth status

​
Step 3: Create your first sandbox

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

​
Step 4: 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

amika sandbox create --name task-1 --git
amika sandbox create --name task-2 --git
amika sandbox list
Use amika sandbox list and amika volume list to inspect active sandboxes and tracked volumes.

​
Next steps

Sandbox configuration

Configure setup scripts and credential auto-mounting.

Presets

Pick preset images like coder and claude.

Authentication

Export discovered keys for Claude, Codex, and OpenCode.

CLI reference

See full command and flag documentation.