> ## Documentation Index
> Fetch the complete documentation index at: https://apidocs.neetokb.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 securely saves your session, so you never need to enter an API key.

## Sign in

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

Your browser opens to complete sign-in. Once you approve it, the CLI saves credentials for that subdomain. If you omit `--subdomain`, the CLI prompts for it.

<Tip>
  Your subdomain is the first part of your workspace URL - for
  `https://spinkart.neetokb.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/neetokb/auth.json
```

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

## Check who you are

```bash theme={"system"}
neetokb 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"}
neetokb logout --subdomain your-workspace    # remove one workspace
neetokb logout --all                         # remove every workspace
neetokb 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"}
neetokb login --subdomain globex
```

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

```bash theme={"system"}
neetokb articles list --subdomain acme
neetokb articles 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 `neetokb doctor` first. See [Troubleshooting](/cli/troubleshooting) for common issues and fixes.