# CLI

The `aigon` command-line tool translates the [REST API](/docs/api/) into shell commands. It's designed for two audiences:

- **LLMs and AI assistants** — Claude Code, Claude Desktop, and other agents can call `aigon` directly to read, search, and add notes
- **Humans** — use it in scripts, on the command line, or anywhere you want terminal access to your Aigon data

## Install

```bash
curl -LsSf https://astral.sh/uv/install.sh | sh
uv tool install aigon-cli
```

Or download the standalone script from [GitHub](https://github.com/aigonai/aigonone-firmware/tree/main/aigon_cli).

## Configure

Set your API token (see [Authentication](/docs/auth/) for how to get one):

```bash
aigon config set api.token YOUR_TOKEN
```

Verify:

```bash
aigon config show
```

## Commands

### Notes

```bash
aigon notetaker read --limit 5
aigon notetaker read --all --forever --limit 20
aigon notetaker search "meeting"
```

### LLM Mode

Commands optimised for AI assistant consumption:

```bash
aigon llm help
aigon notetaker read --format llm --limit 10
```

### Configuration

```bash
aigon config show
aigon config set api.token YOUR_TOKEN
aigon config help
```

### MCP Server

Start the MCP server for AI assistant integration:

```bash
aigon mcp
```

See [MCP Server](/docs/mcp/) for Claude Desktop configuration.

## Full Reference

```bash
aigon --help
aigon notetaker --help
aigon llm help
```

See also the [old installation instructions](/help/aigonone-installation/) for a more detailed step-by-step walkthrough.