> ## 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.

# Install

> Install the Amika CLI and SDKs.

## CLI

The Amika CLI is a single binary that runs on macOS and Linux.

### Quick install

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

This downloads the latest release, verifies its SHA-256 checksum, and installs it to `/usr/local/bin`.

### Verify the installation

```bash theme={null}
amika --version
```

### Options

#### Install a specific version

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

#### Custom install directory

Set `AMIKA_INSTALL_DIR` to install somewhere other than `/usr/local/bin`:

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

Make sure the directory is on your `PATH`.

#### Install another component

The installer also installs Amika's separately versioned binaries. Pass
`--component` with `amika` (the default), `amikad` (the daemon that runs inside
a rig), or `amikalog` (the agent session capture CLI, see
[Capture agent sessions](https://docs.amika.dev/guides/capture-agent-sessions.md)):

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

`--install-version` applies to the component you pick.

#### Dry run

Preview what the installer would do without downloading or installing anything:

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

### Shell completion

`amika completion <shell>` prints a completion script for `bash`, `zsh`,
`fish`, or `powershell`. For example, to load zsh completion in the current
shell:

```bash theme={null}
source <(amika completion zsh)
```

Run `amika completion <shell> --help` for how to install it permanently.

### Supported platforms

| OS | Architecture |
| - | - |
| Linux | x86\_64, arm64 |
| macOS | x86\_64 (Intel), arm64 (Apple Silicon) |

### Build from source

```bash theme={null}
git clone https://github.com/gofixpoint/amika.git && cd amika
make build-cli
# Binary is at dist/amika
```

## SDKs

Install the Typescript SDK with:

```bash theme={null}
npm install @amika/sdk
```

See the [TypeScript quickstart](https://docs.amika.dev/sdks/typescript/quickstart.md) to get started.
SDKs for more languages are on the way — in the meantime you can use the
[CLI](https://docs.amika.dev/reference/cli.md) or the [HTTP API](https://docs.amika.dev/reference/api-reference.md) directly.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.