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

# CLI Installation

> Install the hexr CLI tool.

## Install

The `hexr` CLI is included in the Python SDK package:

<CodeGroup>
  ```bash uv (recommended) theme={null}
  uv pip install "hexr-sdk[cli]" --extra-index-url https://pypi.hexr.cloud/simple/
  ```

  ```bash pip theme={null}
  pip install "hexr-sdk[cli]" --extra-index-url https://pypi.hexr.cloud/simple/
  ```
</CodeGroup>

## Verify

```bash theme={null}
$ hexr --version
hexr 0.2.1

$ hexr --help
Usage: hexr [OPTIONS] COMMAND [ARGS]...

  Hexr — Identity-first runtime for AI agents.

Options:
  --verbose, -v  Verbose output
  --debug        Debug logging
  --version      Show version

Commands:
  build    Analyze agent and generate deployment artifacts
  push     Build and push container image
  deploy   Deploy agent to Kubernetes
  audit    Security audit and SBOM generation
  login    Authenticate with Hexr Cloud
  logout   Remove saved credentials
  status   Show deployed agents
  cache    Credential cache management
```

## Prerequisites

| Tool         | Required For                 | Install                                              |
| ------------ | ---------------------------- | ---------------------------------------------------- |
| Python 3.10+ | CLI execution                | `brew install python@3.11`                           |
| Docker       | `hexr push` (local builds)   | [docker.com](https://docker.com)                     |
| kubectl      | `hexr deploy`, `hexr status` | `brew install kubectl`                               |
| gcloud       | `hexr push --cloud`          | [cloud.google.com/sdk](https://cloud.google.com/sdk) |