CLI Overview
The Aether CLI lets you manage projects, workspaces, and tasks 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_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 |
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 |
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 |