Utility commands

The commands that manage the CLI itself rather than workspace data. For the full story on signing in, see Authentication.

Authentication

Signs in to a workspace through the browser and saves the session to ~/.config/neetorecord/auth.json. Run it once per workspace you work with.

neetorecord login --subdomain acme

Authenticated as oliver@example.com on acme.neetorecord.com.

Without --subdomain the command prompts for it.

logout

Signs out of a workspace and removes its saved session.

neetorecord logout --subdomain acme

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

With exactly one workspace signed in, --subdomain can be left out. With several, pass --subdomain to pick one or --all to sign out of every workspace.

Signed out of acme.neetorecord.com.

whoami

Prints the account and workspace the CLI is signed in as. Run it when you are not sure which workspace a command is about to hit.

neetorecord whoami

Authenticated as oliver@example.com on acme.neetorecord.com (default).

When several workspaces are signed in, every one is listed.

Diagnostics

doctor

Checks authentication, API reachability, and the CLI version in a single pass. Start here when a command fails and the message does not make the cause obvious.

neetorecord doctor

✓ Authentication: authenticated as oliver@example.com on acme.neetorecord.com
✓ API connection: https://acme.neetorecord.com (responding in 214ms)
✓ CLI version: 1.2.2

Each check runs independently, so a failing one does not hide the others. With no saved session, pass --subdomain to still probe the workspace URL; without it the API check is skipped.

version

Prints the version, commit, and build date of the installed binary. Include this in bug reports.

neetorecord version

neetorecord 1.2.2 (commit: 1f96f14, built: 2025-07-14)

commands

Prints the full command tree, including every flag, as JSON. This is what an AI assistant should read when it needs a flag that its rules file does not cover, and it is always accurate for the installed binary.

neetorecord commands

[
  {
    "command": "neetorecord folders",
    "description": "Manage recording folders",
    "subcommands": [
      {
        "command": "neetorecord folders create",
        "description": "Create a new folder",
        "flags": [
          {
            "name": "name",
            "type": "string",
            "description": "Folder name",
            "required": true
          }
        ]
      }
    ]
  }
]

Upgrade

update

Upgrades the CLI in place. It detects how the binary was installed and runs the matching upgrade: brew upgrade for a Homebrew install, the install script otherwise, and the PowerShell script on Windows.

neetorecord update

Detected Homebrew install.
Running: brew update && brew upgrade neetozone/homebrew-tap/neetorecord

The command prints the install method it detected and the exact command it is about to run, then hands over to it. A failed download exits non-zero instead of being silently ignored.

AI-assistant setup

setup

Teaches an AI coding assistant how to drive the CLI by writing that assistant’s rules file. See AI assistants for what each subcommand writes.

neetorecord setup claude

Available subcommands: claude, cursor, windsurf, copilot, gemini, codex.

Shell completion

completion writes the completion script under ~/.config/neetorecord/completions and wires your shell to load it on the next start. There is nothing to source by hand.

neetorecord completion zsh

neetorecord completion bash

neetorecord completion fish

neetorecord completion powershell

Shell	Script	Loader block
zsh	`~/.config/neetorecord/completions/_neetorecord`	`~/.zshrc`
bash	`~/.config/neetorecord/completions/neetorecord.bash`	`~/.bashrc`
fish	`~/.config/fish/completions/neetorecord.fish`	none, fish loads it on its own
powershell	`~/.config/neetorecord/completions/neetorecord.ps1`	`~/Documents/PowerShell/Microsoft.PowerShell_profile.ps1`

The loader block sits between # neetorecord completions and # end neetorecord completions marker lines. Re-running overwrites the script and refreshes that block instead of duplicating it; the rest of the file is left as it was. Start a new shell to pick up the completions.

The script is generated from the command tree at the time you run it. Re-run neetorecord completion <shell> after every upgrade so completions include the newest commands and flags.

Pass --print to write the script to standard output instead of installing it, which is handy when you manage shell config yourself:

neetorecord completion zsh --print > /usr/local/share/zsh/site-functions/_neetorecord

Getting Started

Commands

Authentication

logout

whoami

Diagnostics

doctor

version

commands

Upgrade

update

AI-assistant setup

setup

Shell completion

​Authentication

​login

​logout

​whoami

​Diagnostics

​doctor

​version

​commands

​Upgrade

​update

​AI-assistant setup

​setup

​Shell completion

Authentication

login

logout

whoami

Diagnostics

doctor

version

commands

Upgrade

update

AI-assistant setup

setup

Shell completion