nno <namespace> <command> [options]

pnpm add -g @neutrino-io/cli

nno --version

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

# CI / non-interactive
nno login --token $NNO_API_TOKEN

nno logout

nno whoami

i Authenticated as [email protected]
i Platform: r4xk9m2zt5
i Role: platform-admin

nno project check
nno project check --env stg

nno project check --env stg

  ✓ P01  wrangler.toml found (auth, billing)
  ✓ P02  [env.stg] defined in all service configs
  ✓ P03  D1 IDs populated (no placeholders)
  ✓ P04  PLATFORM_ID=r4xk9m2zt5, TENANT_ID=n7wp3fy8q1
  ⚠ P05  VITE_AUTH_API_URL not set in .env.stg

  0 errors, 1 warning(s) — project is deployable with caveats

nno project dev

nno project build
nno project build --env prod

nno project build --env prod
# → Building console for env: prod
# ✓ Build complete → apps/console/dist/

nno project deploy <platform-id>
nno project deploy <platform-id> --env prod

nno project deploy r4xk9m2zt5 --env stg
# Triggering deployment for platform r4xk9m2zt5 (stg)...
# Deployment started: dep_9x2m4k7p1q
# URL: https://r4xk9m2zt5-stg.pages.dev
# Polling for completion...
#   Status: deploy — success
# Deployment complete

nno feature init <name>
nno feature init analytics --no-service
nno feature init crm --dir ./packages/crm

<name>/
├── src/
│   ├── feature.ts        ← FeatureDefinition
│   ├── routes/index.tsx  ← Page component
│   └── index.tsx         ← Package entry
├── nno.config.ts
├── package.json
├── tsconfig.json
├── README.md
└── service/              ← Hono Worker (omitted with --no-service)
    ├── src/index.ts
    └── wrangler.toml.template

nno feature init analytics
# cd analytics
# pnpm install
# nno feature dev

nno feature dev
nno feature dev --no-service
nno feature dev --platform r4xk9m2zt5 --env stg

nno feature test
nno feature test --watch
nno feature test --coverage
nno feature test --service-only
nno feature test --ui-only

nno feature build
nno feature build --analyze

nno feature validate
nno feature validate ./packages/analytics

nno feature validate
# Validating feature at /projects/analytics...
#
#   ✓ package.json exists
#   ✓ package.json has "neutrino": {"type": "feature"}
#   ✓ exports featureManifest
#   ✓ TypeScript compiles without errors
#   ✓ Permission keys follow {featureId}:{action} format
#
# Result: 5 passed, 0 failed

nno feature submit
nno feature submit --message "Initial submission"
nno feature submit --private
nno feature submit --dry-run

nno feature status
nno feature status <submission-id>

nno marketplace list
nno marketplace list --type domain
nno marketplace list --search payments

nno marketplace approve <submission-id>
nno marketplace approve sub_9x2m4k7p1q --note "Looks good"

nno marketplace reject <submission-id> --reason "Missing featureManifest export"

import type { SubCommandsDef } from 'citty'

export interface NnoPlugin {
  /** Namespace name — becomes the top-level subcommand (e.g. 'project'). */
  name: string
  /** Short description shown in `nno --help`. */
  description?: string
  /** Citty subcommands for this namespace. */
  commands: SubCommandsDef
}

import { definePlugin, registerPlugin } from '@neutrino-io/cli/plugin'
import { defineCommand } from 'citty'

export const analyticsPlugin = definePlugin({
  name: 'analytics',
  description: 'Analytics management commands',
  commands: {
    report: defineCommand({
      meta: { name: 'report', description: 'Generate analytics report' },
      async run() {
        // ...
      },
    }),
  },
})

// Register before runMain in your entry point
registerPlugin(analyticsPlugin)