Utility commands

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

Authentication

neetokb 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.neetokb.com.

logout

neetokb logout --subdomain your-workspace
neetokb logout --all

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

Sample output

Signed out of acme.neetokb.com.

whoami

neetokb 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.neetokb.com (default).

Diagnostics

doctor

neetokb 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.neetokb.com
✓ API connection: https://acme.neetokb.com (responding in 214ms)
✓ CLI version: 1.0.6

version

neetokb version

Prints the CLI version, commit hash, and build date.

Sample output

neetokb 1.0.6 (commit: a1b2c3d, built: 2026-07-01)

commands

neetokb 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": "neetokb articles",
    "description": "Manage articles",
    "subcommands": [
      {
        "command": "neetokb articles list",
        "description": "List articles",
        "flags": [
          { "name": "state", "type": "string", "description": "Filter by state (draft/published)" }
        ]
      }
    ]
  }
]

Updates

update

neetokb update

Detects how the CLI was installed and runs the matching upgrade command: brew upgrade for a Homebrew install, the install script otherwise, and the PowerShell installer on Windows.

Sample output

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

AI-assistant setup

Add NeetoKB instructions to your AI coding assistant. See AI assistants for details.

neetokb setup claude
neetokb setup cursor
neetokb setup windsurf
neetokb setup copilot
neetokb setup gemini
neetokb setup codex

Sample output

NeetoKB plugin extracted to /Users/oliver/.config/neetokb/claude-plugin

To finish installation, open Claude Code and run these slash commands:
  /plugin marketplace add /Users/oliver/.config/neetokb/claude-plugin
  /plugin install neetokb@neetokb

(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. neetokb completion <shell> installs completion for your shell. It writes a script under ~/.config/neetokb/completions and configures your shell to load it the next time it starts.

neetokb completion zsh

neetokb completion bash

neetokb completion fish

neetokb 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:

neetokb completion zsh --print

Getting Started

Commands

Authentication

logout

whoami

Diagnostics

doctor

version

commands

Updates

update

AI-assistant setup

Shell completion

​Authentication

​login

​logout

​whoami

​Diagnostics

​doctor

​version

​commands

​Updates

​update

​AI-assistant setup

​Shell completion

Authentication

login

logout

whoami

Diagnostics

doctor

version

commands

Updates

update

AI-assistant setup

Shell completion