Keyboard shortcuts

Press ← or → to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

Installation

This guide covers installing AetherShell on your system.

Requirements

  • Rust 1.88+ (for building from source)
  • OS: Windows, macOS, or Linux
  • Optional: API keys for AI providers (OpenAI, Anthropic, etc.)

Install with Cargo

The recommended way to install AetherShell:

cargo install aethershell

This installs two binaries:

  • ae - The main AetherShell executable
  • aimodel - AI model management CLI

Install from Source

For the latest development version:

git clone https://github.com/nervosys/AetherShell.git
cd AetherShell
cargo build --release

# Add to PATH
cp target/release/ae ~/.local/bin/
cp target/release/aimodel ~/.local/bin/

Pre-built Binaries

Download pre-built binaries from the releases page:

macOS

# Intel Mac
curl -LO https://github.com/nervosys/AetherShell/releases/latest/download/aethershell-x86_64-apple-darwin.tar.gz
tar xzf aethershell-x86_64-apple-darwin.tar.gz

# Apple Silicon
curl -LO https://github.com/nervosys/AetherShell/releases/latest/download/aethershell-aarch64-apple-darwin.tar.gz
tar xzf aethershell-aarch64-apple-darwin.tar.gz

Linux

curl -LO https://github.com/nervosys/AetherShell/releases/latest/download/aethershell-x86_64-unknown-linux-gnu.tar.gz
tar xzf aethershell-x86_64-unknown-linux-gnu.tar.gz

Windows

Download aethershell-x86_64-pc-windows-msvc.zip from releases and extract to a directory in your PATH.

Verify Installation

ae --version
# AetherShell 0.2.0

ae --help

VS Code Extension

Install the AetherShell extension for syntax highlighting and IDE features:

code --install-extension nervosys.aethershell

Or search for “AetherShell” in the VS Code marketplace.

Next Steps