utility - NeetoInvoice Docs

Commands that manage the CLI itself rather than workspace data. Sign in to a workspace through the browser. Omit --subdomain and the CLI prompts for it.

neetoinvoice login --subdomain acme

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

Credentials for every signed-in subdomain live together in ~/.config/neetoinvoice/auth.json. See Authentication.

logout

Sign out of one workspace, or all of them.

neetoinvoice logout --subdomain acme

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

Signed out of acme.neetoinvoice.com.

With no flag, logout removes the only entry when exactly one is signed in, and errors when several are.

whoami

List the signed-in accounts. The entry is marked (default) when exactly one is signed in.

neetoinvoice whoami

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

Pass --subdomain <name> to show just one.

doctor

Check authentication, API reachability, and version. Each check runs independently, so one failure does not hide the others.

neetoinvoice doctor

✓ Authentication: authenticated as oliver@example.com on acme.neetoinvoice.com
✓ API connection: https://acme.neetoinvoice.com (responding in 142ms)
✓ CLI version: 1.0.7

doctor needs --subdomain too when several workspaces are signed in.

version

Print the version, commit, and build date.

neetoinvoice version

{
  "binary": "neetoinvoice",
  "commit": "3f9a1c2",
  "date": "2026-07-21T09:14:22Z",
  "version": "1.0.7"
}

update

Upgrade the CLI in place. The command detects how the binary was installed and runs the matching upgrade: brew update && brew upgrade for Homebrew, the PowerShell installer on Windows, and the shell installer everywhere else.

neetoinvoice update

commands

Emit the full command and flag catalog as JSON. This is the source of truth for what the installed binary supports, and it is what generates the commands overview.

neetoinvoice commands

Each entry has command, description, optional flags (with name, type, default, description, and required), and subcommands.

setup

Write NeetoInvoice instructions into an AI coding assistant’s config. Run it from the repository you are working in. See AI assistants.

neetoinvoice setup claude

Command	What it writes
`setup claude`	Registers the NeetoInvoice plugin with Claude Code.
`setup cursor`	`.cursor/rules/neetoinvoice.mdc`
`setup windsurf`	`.windsurf/rules/neetoinvoice.md`
`setup copilot`	Appends to `.github/copilot-instructions.md`
`setup gemini`	Appends to `GEMINI.md`
`setup codex`	Appends to `AGENTS.md`

Shell completion

neetoinvoice completion <shell> writes the completion script under ~/.config/neetoinvoice/completions and wires your shell to load it on next start. No manual sourcing is needed.

neetoinvoice completion zsh

neetoinvoice completion bash

neetoinvoice completion fish

neetoinvoice completion powershell

Installed zsh completion:
  script: /Users/oliver/.config/neetoinvoice/completions/_neetoinvoice (overwritten)
  loader: added to /Users/oliver/.zshrc
Start a new shell (or run: source /Users/oliver/.zshrc) to use it.
Re-run "neetoinvoice completion zsh" after upgrading to keep completions current with the latest commands.

Re-running refreshes both the script and the shell config in place, so it never duplicates the loader block. fish needs no loader: it picks the script up automatically.

Re-run the completion install after every upgrade. The script on disk is generated from the binary that wrote it, so commands added later will not be suggested until you refresh it.

Pass --print to emit the raw script to standard output instead of installing it:

neetoinvoice completion zsh --print

​login

​logout

​whoami

​doctor

​version

​update

​commands

​setup

​Shell completion

login

logout

whoami

doctor

version

update

commands

setup

Shell completion