Skip to main content

​
aether auth

Manage CLI authentication. The CLI uses JWT tokens stored in ~/.aether/config.json. You can also authenticate using the AETHER_TOKEN environment variable.

​
Usage

aether auth <subcommand> [flags]

​
Subcommands

SubcommandDescription
loginAuthenticate with Aether
logoutClear stored credentials
statusShow current authentication state
tokenPrint the access token to stdout
signupCreate a new account

​
aether auth login

Authenticate with the Aether API. Opens a browser for OAuth login by default. 
aether auth login [flags]
FlagDescription
--emailLogin with email (sends a magic link)
--tokenAuthenticate with an existing JWT token
# Browser-based login
aether auth login

Opening browser for authentication...
Logged in as user@example.com
Default project: my-app (proj_a1b2c3d4)

# Email magic link
aether auth login --email user@example.com

Magic link sent to user@example.com. Check your inbox.
Waiting for confirmation...
Logged in as user@example.com

# Token-based login (for CI/CD)
aether auth login --token "eyJhbG..."

​
aether auth logout

Clear stored credentials from the config file. 
aether auth logout

Logged out.

​
aether auth status

Show the current authentication state, token expiry, and default project. 
aether auth status

Authenticated:    yes
Email:            user@example.com
Token expires:    2025-02-15T10:30:00Z
Default project:  my-app (proj_a1b2c3d4)
When not authenticated: 
Authenticated:    no
Run 'aether auth login' to authenticate.

​
aether auth token

Print the current access token to stdout. Useful for piping to other commands or scripts. 
aether auth token

# Use with curl
curl -H "Authorization: Bearer $(aether auth token)" https://api.runaether.dev/v1/projects

# Set as environment variable
export AETHER_TOKEN=$(aether auth token)

​
aether auth signup

Create a new Aether account. 
aether auth signup [flags]
FlagDescription
--emailEmail address for the new account
aether auth signup --email user@example.com

Account created. Check your email to verify.