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 (only required if running local sandboxes)
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
See Install for more options (custom install directory, specific versions, building from source).

​
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: Set up agent credentials

This pushes your local Claude Code OAuth credentials to the Amika secrets store. Then, sandboxes will auto-use this credential so you don’t need to log in again (unless you specify otherwise). 
amika secret claude push --type oauth

​
Step 4: Set up your Github PAT

We use Github personal access tokens (PATs) to give your agent access to your selected Github repositories and to let them push commits or make pull requests. Go to the Git settings and configure your PAT.

​
Step 5: 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 6: Run a coding agent in the sandbox

amika sandbox connect my-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

Repository configuration

Configure sandbox defaults with .amika/config.toml.

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.