> For the complete documentation index, see [llms.txt](https://docs.acecloud.ai/knowledge-base/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.acecloud.ai/knowledge-base/cli/installation.md).

# Installation

## Quick Install (Recommended)

```bash
curl -fsSL https://raw.githubusercontent.com/AceCloudAI/ace-cli-releases/main/install.sh | bash
```

This automatically detects your OS and architecture, downloads the correct binary, and installs it to `/usr/local/bin/ace`.

## Manual Download

Download the binary for your platform:

| Platform              | Binary             |
| --------------------- | ------------------ |
| Linux (amd64)         | `ace-linux-amd64`  |
| Linux (arm64)         | `ace-linux-arm64`  |
| macOS (Apple Silicon) | `ace-darwin-arm64` |
| macOS (Intel)         | `ace-darwin-amd64` |

```bash
# Example: macOS Apple Silicon
curl -L https://github.com/AceCloudAI/ace-cli-releases/releases/latest/download/ace-darwin-arm64 \
  -o /usr/local/bin/ace
chmod +x /usr/local/bin/ace
```

## Verify Installation

```bash
ace --version
# ace version 1.5.0
```

## Self-Update

Keep the CLI up to date:

```bash
ace update          # Download and install latest version
ace update --check  # Only check, don't install
```

## Shell Completion

Enable tab completion for your shell:

```bash
# Bash
ace completion bash > /etc/bash_completion.d/ace

# Zsh
ace completion zsh > "${fpath[1]}/_ace"

# Fish
ace completion fish > ~/.config/fish/completions/ace.fish

# PowerShell
ace completion powershell > ace.ps1
```