CLI Overview

The Aether CLI manages projects, tasks, and cloud workspaces from your terminal. It connects to the Aether API, follows long-running agent tasks, and exposes every part of the platform that the web app does. Install it with the install script or Homebrew, then run the interactive setup:

aether setup

Global Flags

These persistent flags are available on every command.

Flag	Short	Description
`--project`	`-p`	Override the default project ID or name 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, created on first login. It holds your default project, API URL, and authentication tokens. Set AETHER_CONFIG_DIR to use a different directory. Manage non-sensitive config keys with aether config.

Environment Variables

Environment variables take precedence over the config file.

Variable	Description
`AETHER_TOKEN`	Platform API key used as a bearer token (skips the interactive login flow)
`AETHER_PROJECT`	Default project ID or name (overrides the config file)
`AETHER_API_URL`	API base URL (overrides the 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 non-empty value)

Command Groups

Core

Command	Description
`aether setup`	Interactively prepare a fresh machine for Aether
`aether run`	Create a task and watch the agent work
`aether models`	List agent types and their models
`aether project`	Manage projects
`aether task`	Manage tasks and agent runs
`aether usage`	Show a credits, tokens, and VM-uptime summary
`aether billing`	Manage billing, credits, checkout, and portal sessions
`aether warm-slot`	Manage warm slots
`aether notification`	Manage notifications and delivery preferences
`aether feedback`	Submit product feedback

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 the workspace repository

Integrations

Command	Description
`aether github`	Connect and sync with GitHub repositories
`aether sentry`	Connect to Sentry and manage repo links
`aether slack`	Manage the Slack integration and routes
`aether linear`	Manage the Linear integration and routes

Configuration

Command	Description
`aether auth`	Log in, log out, and manage authentication
`aether apikey`	Manage LLM provider (BYOK) API keys
`aether token`	Manage platform API keys for the REST API
`aether settings`	Manage account-level agent and model preferences
`aether secret`	Manage project secret files
`aether skill`	Push, pull, and sync saved agent skills
`aether codex`	Manage Codex provider authentication
`aether claude-code`	Manage Claude Code provider authentication
`aether cursor`	Manage Cursor (legacy) provider authentication
`aether opencode`	Manage OpenCode provider authentication
`aether profile`	Show the current user profile
`aether config`	View and manage CLI configuration
`aether version`	Print version information
`aether completion`	Generate shell completion scripts

Three commands sound alike but manage three different kinds of credential. Don’t mix them up:

Command	Manages	Format
`aether token`	Platform API keys for programmatic REST access (`AETHER_TOKEN` bearer keys)	`aether_…`
`aether apikey`	Bring-your-own LLM provider keys (OpenRouter by default)	`sk-or-…`
`aether auth token`	Prints the credential the CLI logged in with, for piping to other tools	`aether_…`

Resolving IDs (Short Prefixes)

Most commands that take an <id> argument — project, task, workspace, and token — accept a short prefix instead of the full UUID. For projects, tasks, and workspaces the prefix is matched against the first characters of the ID (the listings print the first 8 characters); for tokens, any unique prefix works.

# These are equivalent when the prefix is unique
aether task get a1b2c3d4-e5f6-7890-abcd-ef1234567890
aether task get a1b2c3d4

Resolution fails loudly: an unknown prefix returns “no … found matching”, and a prefix that matches more than one record returns an “ambiguous prefix” error asking for a longer prefix. Values containing a - or 32+ characters are treated as full IDs and used as-is.

Profile

Print the current user’s profile (email, ID, display name, onboarding status).

aether profile

Version

Print version, commit, Go version, and OS/arch.

aether version

aether version 0.1.0 (a1b2c3d)
  go: go1.26.4
  os/arch: darwin/arm64

The CLI docs are hand-written and verified against the source commands. They are not generated from the binary.

CLI Reference

Core Commands

Account Commands

Workspace Commands

Integration Commands

Provider Auth

Configuration

Global Flags

Configuration

Environment Variables

Command Groups

Core

Workspace

Integrations

Configuration

Resolving IDs (Short Prefixes)

Profile

Version

​Global Flags

​Configuration

​Environment Variables

​Command Groups

​Core

​Workspace

​Integrations

​Configuration

​Resolving IDs (Short Prefixes)

​Profile

​Version

Global Flags

Configuration

Environment Variables

Command Groups

Core

Workspace

Integrations

Configuration

Resolving IDs (Short Prefixes)

Profile

Version