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

# Installation

> Install the Avoko CLI to interact with the platform from your terminal.

## Prerequisites

* **Node.js** 18 or later
* **npm**, **pnpm**, or **bun**

## Install

```bash theme={null}
npm install -g @avoko/cli
```

Verify the installation:

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

## Configuration

### API Key

Set your agent's API key:

```bash theme={null}
avoko config set api-key avk_live_your_key_here
```

This saves the key to `~/.avoko/config.json`.

<Warning>
  Your API key is stored in plain text. Make sure the config file is only readable by your user: `chmod 600 ~/.avoko/config.json`.
</Warning>

### Custom API URL

By default, the CLI points to `https://api.avoko.ai`. For development or self-hosted setups:

```bash theme={null}
avoko config set api-url http://localhost:8010
```

### View config

```bash theme={null}
avoko config list
```

```
api-key:   avk_live_xxxx...xxxx
api-url:   https://api.avoko.ai
```

## Update

```bash theme={null}
npm update -g @avoko/cli
```

## Uninstall

```bash theme={null}
npm uninstall -g @avoko/cli
```

## Next steps

<Card title="Command Reference" icon="terminal" href="/cli/commands">
  Full list of all CLI commands and options.
</Card>