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

# Utility commands

> Authentication, diagnostics, versioning, AI-assistant setup, and shell completion.

These commands manage the CLI itself rather than a NeetoAuth resource.

## Authentication

### login

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

Opens your browser to sign in and saves credentials for the workspace. Omit `--subdomain` to be prompted.

```text Sample output theme={"system"}
Authenticated as oliver@example.com on acme.neetoauth.com.
```

### logout

```bash theme={"system"}
neetoauth logout --subdomain your-workspace
neetoauth logout --all
```

| Flag    | Type   | Required | Default | Description                       |
| ------- | ------ | -------- | ------- | --------------------------------- |
| `--all` | `bool` |          | `false` | Sign out of every saved subdomain |

```text Sample output theme={"system"}
Signed out of acme.neetoauth.com.
```

With `--all`, it prints `Signed out of all subdomains.` instead.

### whoami

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

Lists each signed-in account and marks it `(default)` when only one is signed in. Pass `--subdomain <name>` to show one workspace.

```text Sample output theme={"system"}
Authenticated as oliver@example.com on acme.neetoauth.com (default).
```

## Diagnostics

### doctor

```bash theme={"system"}
neetoauth doctor
```

Checks authentication, API reachability, and the CLI version. See [Troubleshooting](/cli/troubleshooting). When several workspaces are signed in, pass `--subdomain <name>`.

```text Sample output theme={"system"}
✓ Authentication: authenticated as oliver@example.com on acme.neetoauth.com
✓ API connection: https://acme.neetoauth.com (responding in 214ms)
✓ CLI version: 1.0.7
```

A failed check is marked `✗` and carries the underlying error on the next line.

### version

```bash theme={"system"}
neetoauth version
```

Prints the CLI version, commit hash, and build date.

```json Sample output theme={"system"}
{
  "binary": "neetoauth",
  "version": "1.0.7",
  "commit": "a1b2c3d",
  "date": "2026-08-04"
}
```

### commands

```bash theme={"system"}
neetoauth commands
```

Prints the complete command and flag catalog for the installed version as JSON. It is useful in scripts and with AI assistants.

```json Sample output theme={"system"}
[
  {
    "command": "neetoauth users",
    "description": "Manage workspace team members",
    "subcommands": [
      {
        "command": "neetoauth users list",
        "description": "List active team members in the workspace",
        "flags": [
          { "name": "page", "type": "int", "default": "0", "description": "Page number" }
        ]
      }
    ]
  }
]
```

## Updating

### update

```bash theme={"system"}
neetoauth update
```

Detects how the CLI was installed and runs the matching upgrade for you.

```text Sample output theme={"system"}
Detected Homebrew install.
Running: brew update && brew upgrade neetozone/homebrew-tap/neetoauth
```

Outside Homebrew it reports a `shell-script` install on macOS and Linux, or a `Windows` install on Windows, and runs the matching installer.

## AI-assistant setup

Add NeetoAuth instructions to your AI coding assistant. See [AI assistants](/cli/ai-assistants) for details.

```bash theme={"system"}
neetoauth setup claude
neetoauth setup cursor
neetoauth setup windsurf
neetoauth setup copilot
neetoauth setup gemini
neetoauth setup codex
```

```text Sample output theme={"system"}
NeetoAuth plugin extracted to /Users/oliver/.config/neetoauth/claude-plugin

To finish installation, open Claude Code and run these slash commands:
  /plugin marketplace add /Users/oliver/.config/neetoauth/claude-plugin
  /plugin install neetoauth@neetoauth

(Claude Code installs plugins via interactive slash commands — there is no shell equivalent today.)
```

The other assistants write a rules or instructions file directly, reporting `Wrote <path>` or `Updated <path>`.

## Shell completion

Shell completion fills in command names, subcommands, and flags when you press `Tab`. It saves you from having to remember the full command tree or look up `--help`.

`neetoauth completion <shell>` installs completion for your shell. It writes a script under `~/.config/neetoauth/completions` and configures your shell to load it the next time it starts.

<CodeGroup>
  ```bash Zsh theme={"system"}
  neetoauth completion zsh
  ```

  ```bash Bash theme={"system"}
  neetoauth completion bash
  ```

  ```bash Fish theme={"system"}
  neetoauth completion fish
  ```

  ```powershell PowerShell theme={"system"}
  neetoauth completion powershell
  ```
</CodeGroup>

Start a new shell (or run `source ~/.zshrc`) to enable it. After upgrading the CLI, run the command again to update the available completions. Re-running it replaces the existing script and configuration without adding duplicates.

<Note>
  To configure it yourself, pass `--print` to write the raw script to standard output instead of installing it:

  ```bash theme={"system"}
  neetoauth completion zsh --print
  ```
</Note>