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.
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 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 status
Show the current authentication state, token expiry, and default project.
Authenticated: yes
Email: user@example.com
Token expires: 2025-02-15T10:30:00Z
Default project: my-app (proj_a1b2c3d4)
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.
# 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 user@example.com
Account created. Check your email to verify.
