> ## Documentation Index
> Fetch the complete documentation index at: https://api-tools.memories.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# CLI

> The memories CLI — a JSON-first command-line client for the Memories.ai API.

The **`memories` CLI** is a JSON-first command-line client for the **Video Datalake** — script uploads, search, and reads from your terminal or CI.

<Card title="Memories-ai-labs/memories-cli" icon="github" href="https://github.com/Memories-ai-labs/memories-cli">
  Source, releases, and the full command reference on GitHub.
</Card>

## Install

<CodeGroup>
  ```bash curl (macOS / Linux) theme={null}
  (tmp="$(mktemp)" && curl -fsSL https://raw.githubusercontent.com/Memories-ai-labs/memories-cli/main/install.sh -o "$tmp" && sh "$tmp"; status=$?; rm -f "$tmp"; exit $status)
  ```

  ```bash From source (pip) theme={null}
  python3 -m venv .venv && source .venv/bin/activate
  python3 -m pip install -e ".[dev]"
  ```
</CodeGroup>

The curl installer verifies the release against `sha256sums.txt` and installs `memories` to `~/.local/bin`. **Platforms:** macOS 13+ (Apple Silicon) and x86\_64 Linux (glibc ≥ 2.35); on Intel macOS use the source lane. You can also grab an archive directly from **GitHub Releases**.

## Configure

```bash theme={null}
export MEMORIES_API_KEY="sk-mai-..."      # required (see Authentication)
# export MEMORIES_V1_BASE_URL="https://api.memories.ai"   # optional override
```

## Use

```bash theme={null}
memories --help
```

See the [repo](https://github.com/Memories-ai-labs/memories-cli) for the full command list.

<Note>
  Prefer natural language over flags? Use the [Plugin](/plugin) (Claude Code / Codex) or the [MCP Server](/mcp-server).
</Note>