# CLI Installation

Source: https://docs.generalaugment.com/cli/installation/
Description: Install and authenticate the standalone developer CLI.

The CLI is packaged separately from the server. It is a thin HTTP client for GA
developer and operator workflows.

## Install

Source-checkout path:

```bash
uv run --project packages/cli genaug --version
uv run --project packages/cli genaug --help
```

PyPI currently exposes `0.1.0` for `general-augment-cli` while this source checkout
targets `0.1.1`.

Published package path after registry readiness confirms the expected version:

```bash
pip install general-augment-cli
genaug --version
genaug --help
```

Until PyPI `0.1.1` is published, keep using `uv run --project packages/cli genaug ...`
from the General Augment repository and record package-index access as the environment
issue.

## Authenticate

```bash
genaug auth login --api-key gaadmlive_your_key_here
genaug doctor --json
genaug auth whoami
```

Use the same repo-local prefix for these commands when you are working from a source
checkout.

The CLI stores config in:

```text
~/.genaug/config.yaml
```

Next: [commands](/cli/commands/) and [configuration](/cli/configuration/).