Installation

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

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:

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)

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:

brew upgrade --cask Aether-Runtime/aether/aether

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.

Windows

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:

$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.

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.

Verify Installation

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 reference for full setup instructions.

Bash
Zsh
Fish
PowerShell

source <(aether completion bash)

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

echo 'source <(aether completion bash)' >> ~/.bashrc

aether completion zsh > "${fpath[1]}/_aether"

Then restart your shell or run compinit.

aether completion fish | source

To persist across sessions:

aether completion fish > ~/.config/fish/completions/aether.fish

aether completion powershell | Out-String | Invoke-Expression

To persist, add the above line to your PowerShell profile.

Next Steps

After installing, run the interactive setup:

aether setup

See the quickstart for each step in the setup flow.

CLI Reference

Core Commands

Account Commands

Workspace Commands

Integration Commands

Provider Auth

Configuration

macOS and Linux

Homebrew (macOS)

Windows

Verify Installation

Shell Completion

Next Steps

​macOS and Linux

​Homebrew (macOS)

​Windows

​Verify Installation

​Shell Completion

​Next Steps

macOS and Linux

Homebrew (macOS)

Windows

Verify Installation

Shell Completion

Next Steps