> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cirron.com/llms.txt
> Use this file to discover all available pages before exploring further.

# auth

> Log in and manage CLI credentials.

# cirron auth

Authenticate with Cirron, manage your API token, and check authentication status.

## Usage

```bash theme={null}
cirron auth <subcommand> [options]
```

## Subcommands

### login

Authenticate with your Cirron API token. Provide the token as an option or interactively.

```bash theme={null}
cirron auth login [--token <token>] [--url <api-url>]

# Interactive login
cirron auth login

# Login with token
cirron auth login --token sk-1234...

# Login with custom API URL
cirron auth login --url https://app.cirron.com
```

| Option      | Description                  | Default                  |
| ----------- | ---------------------------- | ------------------------ |
| `--token`   | API token for authentication | Prompted                 |
| `--url, -u` | API URL                      | `https://app.cirron.com` |

### logout

Log out and remove your API token from the local configuration.

```bash theme={null}
cirron auth logout
```

### status

Check current authentication status, user info, and token expiry. Warns if your token is expiring soon.

```bash theme={null}
cirron auth status
```

### refresh

Refresh your authentication token without re-entering credentials.

```bash theme={null}
cirron auth refresh
```

## Troubleshooting

* **Invalid Token**: If your token is invalid or expired, you'll be prompted to re-authenticate.
* **Not Authenticated**: Most project commands will fail until you authenticate. Run `cirron auth login`.
* **Switching accounts**: Use `cirron auth logout` then `cirron auth login` with the new token.

## Related

* [Config Command](/cli/commands/config)
* [Project Commands](/cli/commands/init)