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

# Installation

> Install the Aether CLI on macOS, Linux, or Windows

Prebuilt `aether` binaries are published for macOS, Linux, and Windows on `amd64` and `arm64`. Every download is verified against the release's `checksums.txt` before it is installed.

## macOS and Linux

```bash theme={"dark"}
curl -fsSL https://app.runaether.dev/install.sh | sh
```

The script detects your OS and architecture, verifies the checksum, and installs `aether` to `/usr/local/bin` (using `sudo` only if that directory isn't writable). To install somewhere else, set `AETHER_INSTALL_DIR`:

```bash theme={"dark"}
curl -fsSL https://app.runaether.dev/install.sh | AETHER_INSTALL_DIR="$HOME/.local/bin" sh
```

To upgrade, run the script again — it always installs the latest release.

## Homebrew (macOS)

```bash theme={"dark"}
brew install --cask Aether-Runtime/aether/aether
```

This taps `Aether-Runtime/aether` and installs the `aether` cask in one step. The cask is macOS-only; on Linux, use the install script above. To upgrade later:

```bash theme={"dark"}
brew upgrade --cask Aether-Runtime/aether/aether
```

<Note>
  Use the fully qualified name in both commands. Since Homebrew 6.0, content from non-official taps must be trusted before it loads, and naming the cask in full grants that trust for this cask alone. The short form `brew upgrade aether` fails with `Refusing to load cask ... from untrusted tap`.
</Note>

## Windows

```powershell theme={"dark"}
irm https://app.runaether.dev/install.ps1 | iex
```

The script detects your architecture, verifies the checksum, installs `aether.exe` to `%LOCALAPPDATA%\Aether\bin`, and adds that directory to your user `PATH`. To install somewhere else (skipping the `PATH` update), set `AETHER_INSTALL_DIR` first:

```powershell theme={"dark"}
$env:AETHER_INSTALL_DIR = "C:\tools\aether"
irm https://app.runaether.dev/install.ps1 | iex
```

To upgrade, run the script again — it always installs the latest release.

<Note>
  Windows binaries ship starting with the first CLI release after v0.1.8. Until that release is published, this command fails with a download error.
</Note>

## Verify Installation

```bash theme={"dark"}
aether version
```

```
aether version 0.1.0 (a1b2c3d)
  go: go1.26.4
  os/arch: darwin/arm64
```

The version string reflects the release tag you installed.

## Shell Completion

Set up tab completion for your shell. See the [completion](/cli/completion) reference for full setup instructions.

<Tabs>
  <Tab title="Bash">
    ```bash theme={"dark"}
    source <(aether completion bash)
    ```

    To persist across sessions, add to your `~/.bashrc`:

    ```bash theme={"dark"}
    echo 'source <(aether completion bash)' >> ~/.bashrc
    ```
  </Tab>

  <Tab title="Zsh">
    ```bash theme={"dark"}
    aether completion zsh > "${fpath[1]}/_aether"
    ```

    Then restart your shell or run `compinit`.
  </Tab>

  <Tab title="Fish">
    ```bash theme={"dark"}
    aether completion fish | source
    ```

    To persist across sessions:

    ```bash theme={"dark"}
    aether completion fish > ~/.config/fish/completions/aether.fish
    ```
  </Tab>

  <Tab title="PowerShell">
    ```powershell theme={"dark"}
    aether completion powershell | Out-String | Invoke-Expression
    ```

    To persist, add the above line to your PowerShell profile.
  </Tab>
</Tabs>

## Next Steps

After installing, run the interactive setup:

```bash theme={"dark"}
aether setup
```

See the [quickstart](/quickstart#step-2-run-aether-setup) for each step in the setup flow.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.