Documentation Index
Fetch the complete documentation index at: https://docs.runaether.dev/llms.txt
Use this file to discover all available pages before exploring further.
CLI Overview
The Aether CLI lets you manage projects, tasks, workspaces, billing, warm slots, notifications, and integrations from your terminal. It connects to the Aether API and provides streaming output for long-running agent tasks.
Global Flags
These flags are available on every command.
| Flag | Short | Description |
|---|
--project | -p | Override the default project for this command |
--json | | Output results as JSON |
--no-color | | Disable colored output |
--api-url | | Override the Aether API URL |
--debug | | Print debug information to stderr |
Configuration
The CLI stores configuration in ~/.aether/config.json. This file is created automatically on first login and stores your default project, API URL, and authentication tokens.
Environment Variables
Environment variables take precedence over the config file.
| Variable | Description |
|---|
AETHER_TOKEN | Authentication token (skips login flow) |
AETHER_PROJECT | Default project ID (overrides config file) |
AETHER_API_URL | API base URL (overrides config file) |
AETHER_PREVIEW_DOMAIN | Domain used when printing workspace preview URLs |
AETHER_DEBUG=1 | Enable debug output to stderr |
NO_COLOR | Disable colored output (any value) |
Command Groups
Core
| Command | Description |
|---|
aether run | Send a prompt and stream the agent response |
aether project | Manage projects |
aether task | Manage tasks and agent runs |
aether usage | Show credit usage |
Account
| Command | Description |
|---|
aether billing | Manage billing, credits, checkout, and portal sessions |
aether warm-slot | Manage project warm slots |
aether notification | Manage notifications and delivery preferences |
aether profile | Show the current user profile |
aether token | Manage personal access tokens |
aether settings | Manage user settings |
aether secret | Manage project secret files |
Workspace
| Command | Description |
|---|
aether workspace | Manage cloud workspaces |
aether file | Read, write, and manage workspace files |
aether env | Manage project environment variables |
aether git | Git operations on workspace repositories |
Integrations
| Command | Description |
|---|
aether github | Connect and sync with GitHub repositories |
aether sentry | Connect to Sentry for error tracking |
aether slack | Configure Slack routes |
aether linear | Configure Linear routes |
aether codex | Manage Codex account authorization |
aether claude-code | Manage Claude Code authorization |
Configuration
| Command | Description |
|---|
aether auth | Login, logout, and manage authentication |
aether apikey | Manage LLM provider API keys |
aether config | View and manage CLI configuration |
aether version | Print the CLI version |
aether completion | Generate shell completion scripts |
Version
Print the current CLI version.
aether version 0.1.0 (abc1234)
