aether auth

Login, logout, and manage authentication

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

Subcommand	Description
login	Authenticate with Aether
logout	Clear stored credentials
status	Show current authentication state
token	Print the access token to stdout
signup	Create a new account

aether auth login

Authenticate with the Aether API. Opens a browser for OAuth login by default.

aether auth login [flags]

Flag	Description
--email	Login with email (sends a magic link)
--token	Authenticate with an existing JWT token

# Browser-based login
aether auth login

Opening browser for authentication...
Logged in as [e-mail]
Default project: my-app (proj_a1b2c3d4)

# Email magic link
aether auth login --email [e-mail]

Magic link sent to [e-mail]. Check your inbox.
Waiting for confirmation...
Logged in as [e-mail]

# 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:            [e-mail]
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]

Flag	Description
--email	Email address for the new account

aether auth signup --email [e-mail]

Account created. Check your email to verify.