Utility commands

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

Authentication

neetocal login --subdomain your-workspace

Opens your 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

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

Sample output

Signed out of acme.neetocal.com.

whoami

neetocal whoami

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

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 several workspaces are signed 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 complete command and flag catalog for the installed version as JSON. It is useful in scripts and with AI assistants.

Sample output

[
  {
    "command": "neetocal bookings",
    "description": "Manage bookings",
    "subcommands": [
      {
        "command": "neetocal bookings list",
        "description": "List bookings",
        "flags": [
          { "name": "type", "type": "string", "description": "Filter by type (upcoming, past, cancelled, incomplete)" }
        ]
      }
    ]
  }
]

Upgrade

update

neetocal update

Updates the CLI to the latest release using the method that installed it. When the binary lives in a Homebrew Cellar it runs brew update && brew upgrade neetozone/tap/neetocal; on other macOS and Linux installs it downloads the shell installer to a temporary file and runs it; on Windows it runs the PowerShell installer. The installers are the same ones the Installation page uses, fetched over HTTPS. The command prints the detected method and the command it runs, and exits non-zero if that command fails.

Sample output

Detected Homebrew install.
Running: brew update && brew upgrade neetozone/tap/neetocal

After upgrading, re-run neetocal completion <shell> and any neetocal setup command you use so their files match the new version.

AI-assistant setup

Add NeetoCal instructions to 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

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. neetocal completion <shell> installs completion for your shell. For zsh, bash, and PowerShell it writes the script under ~/.config/neetocal/completions and adds a marked block to ~/.zshrc, ~/.bashrc, or ~/Documents/PowerShell/Microsoft.PowerShell_profile.ps1 that loads it the next time the shell starts. For fish it writes ~/.config/fish/completions/neetocal.fish, which fish loads on its own.

neetocal completion zsh

neetocal completion bash

neetocal completion fish

neetocal completion powershell

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.

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

neetocal completion zsh --print

Getting started

Commands

Authentication

logout

whoami

Diagnostics

doctor

version

commands

Upgrade

update

AI-assistant setup

Shell completion

​Authentication

​login

​logout

​whoami

​Diagnostics

​doctor

​version

​commands

​Upgrade

​update

​AI-assistant setup

​Shell completion

Authentication

login

logout

whoami

Diagnostics

doctor

version

commands

Upgrade

update

AI-assistant setup

Shell completion