> ## Documentation Index
> Fetch the complete documentation index at: https://docs.amika.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Quickstart

> Install the CLI and create your first sandbox.

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)

<Info>
  Amika is in beta. CLI flags and APIs may change.
</Info>

## Step 1: Install the CLI

```bash theme={null}
curl -fsSL https://raw.githubusercontent.com/gofixpoint/amika/main/install.sh | sh
```

See [Install](/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.

```bash theme={null}
amika auth login
```

Verify your session:

```bash theme={null}
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).

```bash theme={null}
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](https://app.amika.dev/settings#git) and configure your PAT.

## Step 5: Create your first sandbox

Run this inside a git repository. `--git` mounts the repo root into the sandbox.

```bash theme={null}
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

```bash theme={null}
amika sandbox connect my-sandbox

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

## Optional: run agents in parallel

```bash theme={null}
amika sandbox create --name task-1 --git
amika sandbox create --name task-2 --git
amika sandbox list
```

<Tip>
  Use `amika sandbox list` and `amika volume list` to inspect active sandboxes and tracked volumes.
</Tip>

## Next steps

<CardGroup cols={2}>
  <Card title="Repository configuration" icon="sliders-horizontal" href="/reference/repository-configuration">
    Configure sandbox defaults with .amika/config.toml — precedence rules plus
    multi-repo and repo-less sandboxes.
  </Card>

  <Card title="Presets" icon="package" href="/reference/presets">
    Pick preset images like `coder` and `coder-dind`.
  </Card>

  <Card title="Authentication" icon="key-round" href="/reference/auth">
    Export discovered keys for Claude, Codex, and OpenCode.
  </Card>

  <Card title="CLI reference" icon="square-terminal" href="/reference/cli">
    See full command and flag documentation.
  </Card>
</CardGroup>