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.

The command opens the sign-in page in your browser and prints the URL in case it does not open. It waits up to two minutes for you to approve the session, then fails with a timeout message. 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

With several workspaces signed in, pass --subdomain as well; without it the authentication check fails and the API check is skipped. doctor --subdomain <name> also works before you sign in, which is a quick way to confirm a workspace is reachable.

version

Print the version, commit, and build date.

neetoinvoice version

neetoinvoice 1.0.7 (commit: 3f9a1c2, built: 2026-07-21T09:14:22Z)

Pass --json for a machine-readable object:

{
  "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. It prints the install method it detected and the exact command it runs.

neetoinvoice update

Re-run neetoinvoice completion <shell> and any setup command you use after upgrading so they pick up the new commands.

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. help, completion, and commands itself are left out of the catalog.

setup

Write NeetoInvoice instructions into an AI coding assistant’s config. Every target except claude writes into the current project directory, so run those from the repository you are working in. See AI assistants.

neetoinvoice setup claude

neetoinvoice setup cursor

neetoinvoice setup windsurf

neetoinvoice setup copilot

neetoinvoice setup gemini

neetoinvoice setup codex

Command	What it writes
`setup claude`	Extracts the NeetoInvoice plugin to `~/.config/neetoinvoice/claude-plugin` and prints the `/plugin marketplace add` and `/plugin install` commands to run in Claude Code.
`setup cursor`	Overwrites `.cursor/rules/neetoinvoice.mdc`
`setup windsurf`	Overwrites `.windsurf/rules/neetoinvoice.md`
`setup copilot`	Adds a NeetoInvoice section to `.github/copilot-instructions.md`
`setup gemini`	Adds a NeetoInvoice section to `GEMINI.md`
`setup codex`	Adds a NeetoInvoice section to `AGENTS.md`

The section-based targets keep the rest of the file and replace only the block between the  and  markers, so re-running never adds a duplicate.

Shell completion

neetoinvoice completion <shell> writes the completion script to disk 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.

Shell	Script	Loader
zsh	`~/.config/neetoinvoice/completions/_neetoinvoice`	Block in `~/.zshrc`
bash	`~/.config/neetoinvoice/completions/neetoinvoice.bash`	Block in `~/.bashrc`
fish	`~/.config/fish/completions/neetoinvoice.fish`	None; fish loads it automatically
powershell	`~/.config/neetoinvoice/completions/neetoinvoice.ps1`	Block in `~/Documents/PowerShell/Microsoft.PowerShell_profile.ps1`

Re-running refreshes both the script and the loader block in place, between the # neetoinvoice completions and # end neetoinvoice completions markers, so it never duplicates the block.

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