@noiseport/cli

Command-line admin for a Noiseport instance — a full mirror of the admin panel over @noiseport/sdk, authenticated with a scoped npt_ API token.

Install

npm install -g @noiseport/cli
# or run without installing
npx @noiseport/cli --help

Authenticate

# paste a token minted in the admin panel or on-box
noiseport context add prod --url https://music.example.org --token npt_...

# or bootstrap one interactively (mints an npt_ token, then discards the session)
noiseport auth login --url https://music.example.org

Environment overrides (win over config): NOISEPORT_URL, NOISEPORT_TOKEN, NOISEPORT_CONTEXT.

Commands

• auth — login, logout, whoami, token create|list|revoke
• context — list, use, add, remove, current
• users — list, get, role, deactivate, reactivate, sessions list|revoke|revoke-all
• invites — list, create (prints URL + QR), revoke
• downloads — stats, list, cancel, delete, clear-failed, clean-stuck, watch
• library — stats, rescan
• system — status, restart, restart-status, resolve-restart, navidrome-creds
• updates — check, apply, status, resolve
• audit — admin, acquisition
• logs — tail
• instance — get, set
• integrations — lastfm status|set
• doctor — preflight health check
• version — CLI + server versions and compatibility
• completion — print a shell completion script (bash|zsh|fish)

Global flags

--output table|json · --context <name> · --yes · --dry-run · --debug · --reveal (secrets). Output defaults to JSON when piped; color respects NO_COLOR.

Publish

Performed manually by the maintainer:

pnpm --filter @noiseport/cli build
cd packages/cli && npm publish

publishConfig.registry points npm publish at public npm (overriding any repo .npmrc Forgejo registry). @noiseport/sdk is inlined by tsup, so it is never a publish dependency.