CLI Installation

The NNO CLI (nno) is the primary tool for local development, feature scaffolding, and deployment. It is built on citty and uses a plugin-based namespace registry.

Install

Install globally with pnpm:

pnpm add -g @neutrino-io/cli

Or with npm:

npm install -g @neutrino-io/cli

Verify the installation:

nno --version

Authenticate

Before using most commands, authenticate with your NNO API token:

nno login --token <your-api-token>

Your token is stored in a local credentials file. To check your current authentication status:

nno whoami

This prints your authenticated email, platform ID, and role. If your token has expired, nno whoami will warn you and prompt you to log in again.

CI / non-interactive environments: always use --token. The interactive browser-based login flow requires the NNO CLI Service, which is not yet available.

Sign out

nno logout

This clears the stored credentials from your machine.

Configuration

The CLI reads configuration from environment variables and from a local nno.config.ts file in your project root (for feature packages). Key environment variables:

For local development of the full platform, the CLI reads .env by default.

Update

pnpm add -g @neutrino-io/cli@latest

Check the changelog for breaking changes before updating in CI pipelines.

Next steps

• CLI Commands — all available commands
• Feature Development guide — scaffold your first feature
• Full CLI reference — flags, exit codes, and advanced usage