Utility commands

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

Authentication

neetoplaydash login --subdomain your-workspace

Opens your browser to sign in and saves credentials for the workspace. Omit --subdomain to be prompted. See Authentication.

Sample output

Authenticated as oliver.smith@example.com on acme.neetoplaydash.com.

logout

neetoplaydash logout --subdomain your-workspace
neetoplaydash logout --all

With exactly one workspace signed in, neetoplaydash logout on its own removes it. With several, pass --subdomain or --all.

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

Sample output

Signed out of acme.neetoplaydash.com.

whoami

neetoplaydash 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.smith@example.com on acme.neetoplaydash.com (default).

Diagnostics

doctor

neetoplaydash doctor

Checks authentication, API reachability, and the CLI version. Each check runs independently, so one failure does not hide the next. When several workspaces are signed in, pass --subdomain <name>. See Troubleshooting.

Sample output

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

version

neetoplaydash version

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

Sample output

neetoplaydash 1.0.9 (commit: a1b2c3d, built: 2026-08-05)

commands

neetoplaydash commands

Prints the complete command and flag catalog for the installed version as JSON. It is useful in scripts and with AI assistants, and it is the source this reference is generated from.

Sample output

[
  {
    "command": "neetoplaydash runs",
    "description": "Manage runs",
    "subcommands": [
      {
        "command": "neetoplaydash runs list",
        "description": "List runs for a project",
        "flags": [
          { "name": "branch", "type": "string", "description": "Filter runs by branch name" }
        ]
      }
    ]
  }
]

Updating

update

neetoplaydash update

Detects how the CLI was installed and runs the matching upgrade: brew update && brew upgrade for a Homebrew install, and the install script otherwise. See Installation.

Sample output

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

AI-assistant setup

Add NeetoPlaydash instructions to your AI coding assistant. See AI assistants for what each command writes and where.

neetoplaydash setup claude
neetoplaydash setup cursor
neetoplaydash setup windsurf
neetoplaydash setup copilot
neetoplaydash setup gemini
neetoplaydash setup codex

Sample output

NeetoPlaydash plugin extracted to /Users/oliver/.config/neetoplaydash/claude-plugin

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

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

neetoplaydash completion zsh

neetoplaydash completion bash

neetoplaydash completion fish

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

neetoplaydash completion zsh --print

Getting Started

Commands

Authentication

logout

whoami

Diagnostics

doctor

version

commands

Updating

update

AI-assistant setup

Shell completion

​Authentication

​login

​logout

​whoami

​Diagnostics

​doctor

​version

​commands

​Updating

​update

​AI-assistant setup

​Shell completion

Authentication

login

logout

whoami

Diagnostics

doctor

version

commands

Updating

update

AI-assistant setup

Shell completion