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

# Authentication

> Sign in through the browser and manage credentials for one or more workspaces.

The CLI uses your browser to sign you in and saves the session locally, so you never need to enter an API key.

## Sign in

```bash theme={"system"}
neetoplaydash login --subdomain your-workspace
```

Your browser opens to complete sign-in. Once you approve it, the CLI saves credentials for that subdomain and prints the account it signed in as:

```
Authenticated as oliver.smith@example.com on acme.neetoplaydash.com.
```

If you omit `--subdomain`, the CLI prompts for it.

<Tip>
  Your subdomain is the first part of your workspace URL - for
  `https://spinkart.neetoplaydash.com`, the subdomain is `spinkart`. See
  [Workspace subdomain](/getting-started/workspace-subdomain).
</Tip>

## Where credentials are stored

Credentials for every signed-in workspace live in a single file:

```
~/.config/neetoplaydash/auth.json
```

Removing this file signs you out of every workspace, the same as `neetoplaydash logout --all`.

## Check who you are

```bash theme={"system"}
neetoplaydash whoami
```

Lists every signed-in account. When exactly one is signed in, it is marked `(default)`. Pass `--subdomain <name>` to show just one.

## Sign out

```bash theme={"system"}
neetoplaydash logout --subdomain your-workspace    # remove one workspace
neetoplaydash logout --all                         # remove every workspace
neetoplaydash logout                               # remove the only one, if a single workspace is signed in
```

## Working with multiple workspaces

You can sign in to several subdomains at once. To add another workspace, name its subdomain:

```bash theme={"system"}
neetoplaydash login --subdomain globex
```

When more than one workspace is signed in, every command that talks to the API requires `--subdomain`, including `doctor`. If you omit it, the CLI errors and lists the signed-in workspaces.

```bash theme={"system"}
neetoplaydash projects list --subdomain acme
neetoplaydash projects list --subdomain globex
```

With one signed-in workspace, it is the default and `--subdomain` stays optional.

## Troubleshooting

If sign-in or connection problems come up, run `neetoplaydash doctor` first. See [Troubleshooting](/cli/troubleshooting) for common issues and fixes.