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

# Utility commands

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

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

## Authentication

Full details in [Authentication](/cli/authentication).

### login

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

Opens the 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.neetocal.com.
```

### logout

```bash theme={"system"}
neetocal logout --subdomain your-workspace
neetocal 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.neetocal.com.
```

### whoami

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

Lists every logged-in account, marking the entry `(default)` when exactly one is logged in. Pass `--subdomain <name>` to show just one.

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

## Diagnostics

### doctor

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

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

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

### version

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

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

```text Sample output theme={"system"}
neetocal 1.4.0 (commit: a1b2c3d, built: 2026-07-01)
```

### commands

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

Prints the full command and flag catalog as JSON — the always-accurate source of truth for the installed version. Useful for scripts and AI assistants.

```json Sample output theme={"system"}
[
  {
    "command": "neetocal bookings",
    "description": "Manage bookings",
    "subcommands": [
      {
        "command": "neetocal bookings list",
        "description": "List all bookings",
        "flags": [
          { "name": "type", "type": "string", "description": "Filter by booking type" }
        ]
      }
    ]
  }
]
```

## AI-assistant setup

Register NeetoCal instructions with your AI coding assistant. See [AI assistants](/cli/ai-assistants) for details.

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

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

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

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

## Shell completion

```bash theme={"system"}
neetocal completion <shell>    # bash, zsh, fish, or powershell
```

Installs completion for your shell (fire-and-forget) — writes the script under `~/.config/neetocal/completions` and wires your shell to load it on the next start. Re-run after upgrading the CLI to refresh it. See [Configuration](/cli/configuration#shell-completion) for details, or pass `--print` to emit the raw script instead of installing.

```text Sample output theme={"system"}
Installed zsh completion:
  script: /Users/oliver/.config/neetocal/completions/_neetocal (overwritten)
  loader: added to /Users/oliver/.zshrc
Start a new shell (or run: source /Users/oliver/.zshrc) to use it.
Re-run "neetocal completion zsh" after upgrading to keep completions current with the latest commands.
```