# Installation

The Altoviz CLI is a single self-contained binary with no runtime dependency. Pick your platform below.

## macOS

```sh
brew trust altoviz/tap && brew install altoviz/tap/altoviz
```

## Linux

```sh
# Homebrew
brew trust altoviz/tap && brew install altoviz/tap/altoviz

# One-liner installer
curl -fsSL https://raw.githubusercontent.com/altoviz/cli/main/install.sh | sh

# Debian / Ubuntu
sudo apt install ./altoviz_<version>_amd64.deb

# Fedora / RHEL
sudo rpm -i altoviz-<version>-1.x86_64.rpm
```

## Windows

```powershell
winget install Altoviz.CLI
```

For manual installation, download the zip from [Releases](https://github.com/altoviz/cli/releases), extract it, and add the folder to your `PATH`.

## Shell completions

After installing, enable tab-completion for your shell:

```sh
# bash
altoviz completion bash >> ~/.bashrc

# zsh
altoviz completion zsh >> ~/.zshrc

# fish
altoviz completion fish > ~/.config/fish/completions/altoviz.fish

# PowerShell
altoviz completion pwsh >> $PROFILE
```