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

# charm auth

Manage the local credentials used by the Charm CLI.

## Sign In

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
charm auth login
```

This opens the browser-based login flow and stores a local token for future commands such as `charm push` and `charm logs`.

## Check Current User

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
charm auth whoami
```

Use this before publishing if you are unsure which account the CLI will use.

## Manual Token

For headless environments or CI-style workflows:

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
charm auth manual --token <TOKEN>
```

Only use manual tokens in trusted environments.

## Sign Out

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
charm auth logout
```

This removes local Charm credentials.

## Credential Storage

The CLI stores local configuration under the user's Charm config directory, commonly `~/.charm/config.toml`.

Do not commit local credential files.