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

# basset auth

> Sign in to basset, and see who you are signed in as

A device-grant login — a browser opens on any machine, sign in there, and the CLI on this machine gets a signed credential back. No password ever touches this machine.

## login

Opens a browser for sign-in. Creates an account on first use.

```bash theme={"dark"}
basset auth login
```

| Flag | Default | Meaning |
| - | - | - |
| `--auth-url` | `https://auth.basset.dev` | The auth service to sign in against. |
| `--org` | the one login stored | Organization slug. |

## status

Shows who this machine is signed in as. The default when `auth` is run with no subcommand.

```bash theme={"dark"}
basset auth status
```

## logout

Forgets the credential stored on this machine.

```bash theme={"dark"}
basset auth logout
```

<Callout icon="circle-info" color="#3eb0c9">
  `login` and `status` also accept `--org`, `--endpoint`, `--plaintext` (dial without TLS, for an `rpc` running locally), and `--json` (print JSON even at a terminal). `logout` takes no flags.
</Callout>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.