Skip to main content

Run the doctor

neetocal doctor is the first thing to run when something isn’t working. It checks that you are authenticated, that the API is reachable, and reports the CLI version.
neetocal doctor
When multiple workspaces are logged in, name the one to check:
neetocal doctor --subdomain your-workspace

Common errors

Every command exits non-zero on failure and writes a single-line message to stderr.
Problem: no workspace is logged in.
Solution: run neetocal login --subdomain <name>.
Problem: more than one workspace is logged in, so the target is ambiguous.
Solution: add --subdomain <name> to the command.
Problem: the --subdomain value doesn’t match any logged-in workspace.
Solution: use one of the listed subdomains, or log in to the new one.
Problem: a required flag was omitted.
Solution: check the command’s reference page or run neetocal <command> --help for the required flags.
Problem: the server rejected the request (for example, a validation error).
Solution: the server’s message is passed through. Inspect the JSON envelope (or the --quiet payload) for error, errors, or notice keys and any suggestions the API returns.

Check the version

neetocal version
Prints the CLI version, commit hash, and build date — useful when reporting an issue.