Quickstart

1. Install

Homebrew

brew install contextbridge/tap/aether

Shell

curl --proto '=https' --tlsv1.2 -LsSf https://github.com/contextbridge/aether/releases/latest/download/aether-agent-cli-installer.sh | sh

Cargo

cargo install aether-agent-cli

Requires Rust 1.85+. Install via rustup.

Source

git clone https://github.com/contextbridge/aether.git
cd aether
cargo build --release

2. Init

aether settings init --user # bootstrap user-level settings

3. Run

TUI

aether

IDE / editor

aether acp

Exposes agents over ACP for editor integration.

Headless

aether headless "Explain the main function in this project"

See Headless CLI for all flags and output formats.

Next steps

SettingsDefine agents, models, prompts, and tool filters

MCP ServersConfigure built-in and external tools

LLM ProvidersModel specs, credentials, and availability

System PromptsCompose prompt sources from files, globs, and text