neetorecord doctor first. It checks authentication, reachability of your
workspace, and the installed version in one pass, and each check runs
independently so one failure does not hide the rest.
Common errors
Not authenticated. Run 'neetorecord login' to authenticate.
Not authenticated. Run 'neetorecord login' to authenticate.
No workspace is signed in. Run
neetorecord login --subdomain <name> and
complete the browser sign in. See Authentication.Multiple subdomains authenticated (acme, beta); specify --subdomain.
Multiple subdomains authenticated (acme, beta); specify --subdomain.
More than one workspace is signed in, so the CLI will not guess which one
you mean. Add
--subdomain <name> to the command. logout says
specify --subdomain or --all instead, because --all signs out of every
workspace at once. neetorecord whoami lists what is signed in.Not authenticated for "foo". Authenticated subdomains: acme, beta.
Not authenticated for "foo". Authenticated subdomains: acme, beta.
The
--subdomain value does not match any saved session. Check the spelling
against neetorecord whoami, and sign in to that workspace if it is
missing.Subdomain not found. Please check that you entered the correct subdomain.
Subdomain not found. Please check that you entered the correct subdomain.
The subdomain passed to
login does not resolve to a NeetoRecord workspace.
It is the first part of your workspace URL: for acme.neetorecord.com, the
subdomain is acme. See Workspace subdomain.required flag(s) "query" not set
required flag(s) "query" not set
A required flag is missing. Run the command with
--help, or check the flag
table on that command’s reference page.command not found: neetorecord
command not found: neetorecord
The binary is not on your
PATH. The shell installer puts it in
/usr/local/bin and the PowerShell installer in
%LOCALAPPDATA%\Programs\neetorecord, adding that directory to your user
PATH. Open a new shell after installing so the change takes effect, and
see Installation.Completions do not include a new command
Completions do not include a new command
Completion scripts are generated from the command tree at the moment you
install them, so they go stale after an upgrade. Re-run
neetorecord completion <shell> and start a new shell. See
Shell completion.Claude Code not found (~/.claude/ does not exist).
Claude Code not found (~/.claude/ does not exist).
neetorecord setup claude looks for a Claude Code config directory in your
home directory. Run Claude Code once so it creates ~/.claude/, then run
setup again.API errors
Errors returned by NeetoRecord come through with the server’s own message. In JSON output they arrive inside the envelope, so inspect the payload forerror
or errors keys. A few worth knowing:
Reporting a problem
Include the output ofneetorecord version and neetorecord doctor, and the
command you ran with --json so the response envelope is visible. Reach us
through the help center or at
support@neetorecord.com.