Skip to main content
These commands manage the CLI itself rather than a NeetoCal resource.

​
Authentication

Full details in Authentication.

​
login

neetocal login --subdomain your-workspace
Opens the browser to sign in and saves credentials for the workspace. Omit --subdomain to be prompted.
Sample output
Authenticated as oliver@example.com on acme.neetocal.com.

​
logout

neetocal logout --subdomain your-workspace
neetocal logout --all
FlagTypeRequiredDefaultDescription
--allboolfalseSign out of every saved subdomain
Sample output
Signed out of acme.neetocal.com.

​
whoami

neetocal whoami
Lists every logged-in account, marking the entry (default) when exactly one is logged in. Pass --subdomain <name> to show just one.
Sample output
Authenticated as oliver@example.com on acme.neetocal.com (default).

​
Diagnostics

​
doctor

neetocal doctor
Checks authentication, API reachability, and the CLI version. See Troubleshooting. When multiple workspaces are logged in, pass --subdomain <name>.
Sample output
✓ 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

neetocal version
Prints the CLI version, commit hash, and build date.
Sample output
neetocal 1.4.0 (commit: a1b2c3d, built: 2026-07-01)

​
commands

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.
Sample output
[
  {
    "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 for details. 
neetocal setup claude
neetocal setup cursor
neetocal setup windsurf
neetocal setup copilot
neetocal setup gemini
neetocal setup codex
Sample output
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

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 for details, or pass --print to emit the raw script instead of installing.
Sample output
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.