# @nuxt/cli

> Nuxt CLI

Latest version **3.37.0** (published 2026-07-14) · MIT license · 0 weekly downloads

## Install

```sh
npm install @nuxt/cli
pnpm add @nuxt/cli
yarn add @nuxt/cli
bun add @nuxt/cli
```

Provides the commands `nuxi`, `nuxt`, `nuxi-ng`, `nuxt-cli`.

## Health

**Score 70/100 (B)** — status: active.

Positive: has types; esm support; no vulnerabilities; has provenance; recently updated; high maintenance score.

Warnings: low downloads.

## Facts

| | |
|---|---|
| Version | 3.37.0 |
| Published | 2026-07-14 |
| First published | 2018-11-16 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | bundled |
| Module format | ESM |
| Node | ^16.14.0 \|\| >=18.0.0 |
| Dependencies | 28 |
| Unpacked size | 204 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| Provenance | attested (GitHub Actions) |
| GitHub stars | 392 |
| Maintainers | danielroe |

## Links

- npm: https://www.npmjs.com/package/@nuxt/cli
- Repository: https://github.com/nuxt/cli
- Homepage: https://github.com/nuxt/cli#readme
- Issues: https://github.com/nuxt/cli/issues
- npm.io page: https://npm.io/package/@nuxt/cli

## Dependencies (28)

- [c12](https://npm.io/package/c12.md) ^3.3.4
- [fzf](https://npm.io/package/fzf.md) ^0.5.2
- [ufo](https://npm.io/package/ufo.md) ^1.6.4
- [defu](https://npm.io/package/defu.md) ^6.1.7
- [jiti](https://npm.io/package/jiti.md) ^2.7.0
- [nypm](https://npm.io/package/nypm.md) ^0.6.8
- [srvx](https://npm.io/package/srvx.md) ^0.11.22
- [citty](https://npm.io/package/citty.md) ^0.2.2
- [debug](https://npm.io/package/debug.md) ^4.4.3
- [giget](https://npm.io/package/giget.md) ^3.3.0
- [ohash](https://npm.io/package/ohash.md) ^2.0.11
- [pathe](https://npm.io/package/pathe.md) ^2.0.3
- [scule](https://npm.io/package/scule.md) ^1.3.0
- [youch](https://npm.io/package/youch.md) ^4.1.1
- [ofetch](https://npm.io/package/ofetch.md) ^1.5.1
- [semver](https://npm.io/package/semver.md) ^7.8.5
- [confbox](https://npm.io/package/confbox.md) ^0.2.4
- [consola](https://npm.io/package/consola.md) ^3.4.2
- [exsolve](https://npm.io/package/exsolve.md) ^1.1.0
- [fuse.js](https://npm.io/package/fuse.js.md) ^7.4.2
- [listhen](https://npm.io/package/listhen.md) ^1.10.0
- [std-env](https://npm.io/package/std-env.md) ^4.2.0
- [tinyclip](https://npm.io/package/tinyclip.md) ^0.1.15
- [tinyexec](https://npm.io/package/tinyexec.md) ^1.2.4
- [pkg-types](https://npm.io/package/pkg-types.md) ^2.3.1
- [@bomb.sh/tab](https://npm.io/package/@bomb.sh/tab.md) ^0.0.19
- [@clack/prompts](https://npm.io/package/@clack/prompts.md) ^1.7.0
- [perfect-debounce](https://npm.io/package/perfect-debounce.md) ^2.1.0

## Recent versions

- 3.37.0 (latest) — 2026-07-14
- 4.0.0-alpha.1 (alpha) — 2026-09-03
- 3.26.0-rc.3 (rc) — 2025-07-07
- 2.16.2 (2x) — 2023-03-01
- 4.0.0-alpha.0 — 2026-08-24
- 3.36.1 — 2026-06-26
- 3.36.0 — 2026-06-20
- 3.35.2 — 2026-05-11
- 3.35.1 — 2026-04-27
- 3.35.0 — 2026-04-27
- 3.34.0 — 2026-03-10
- 3.33.1 — 2026-02-08
- 3.33.0 — 2026-02-07
- 3.32.0 — 2026-01-06
- 3.31.3 — 2025-12-17
- … 98 more at https://npm.io/package/@nuxt/cli/versions

## README

# Nuxt CLI (nuxi)

⚡️ [Nuxt](https://nuxt.com/) CLI

## Usage

```bash
$ nuxt [OPTIONS] [COMMAND]

OPTIONS

  --cwd=<directory>    Specify the working directory

COMMANDS

           add    Add Nuxt modules and layers
  add-template    Create a new template file.
       analyze    Build Nuxt and analyze production bundle (experimental)
         build    Build Nuxt for production deployment
       cleanup    Clean up generated Nuxt files and caches
           dev    Run Nuxt development server
      devtools    Enable or disable devtools in a Nuxt project
      generate    Build Nuxt and prerender all routes
          info    Get information about Nuxt project
          init    Initialize a fresh project
        module    Manage Nuxt modules
       prepare    Prepare Nuxt for development/build
       preview    Launches Nitro server for local testing after `nuxi build`.
         start    Launches Nitro server for local testing after `nuxi build`.
          test    Run tests
     typecheck    Runs type-checking throughout your app using `vue-tsc` or Golar.
       upgrade    Upgrade Nuxt
      complete    Generate shell completion scripts

Use nuxi <command> --help for more information about a command.
```

## Documentation

All commands are documented on https://nuxt.com/docs/api/commands

## Adding modules and layers

`nuxt add <name>` installs the package and writes it to `nuxt.config`. Where it is written depends on what the package is:

```bash
# added to `modules`
nuxt add nuxt-shiki

# a layer, added to `extends`
nuxt add nuxt-seo-kit
```

## Update Notifications

Once a day, `nuxt/cli` checks in the background whether a newer version of Nuxt has been released and, if so, prints a short nudge to run `nuxt upgrade` after the command finishes. The `latest` dist-tag is read from the registry configured in your `.npmrc` and cached in your user-level `.nuxtrc`.

To keep the nudge meaningful, it is not shown for prereleases, and not shown for patch releases within the same minor unless you are at least five patches behind.

The check is skipped in CI, on StackBlitz, and when the output is not a terminal. Set `NUXT_IGNORE_UPDATE_CHECK=1` (or `NO_UPDATE_NOTIFIER=1`) to skip a single run, or opt out permanently by adding `updateCheck.enabled=false` to your user-level `.nuxtrc`.

## Shell Autocompletions

`nuxt/cli` provides shell autocompletions for commands, options, and option values &ndash; powered by [`@bomb.sh/tab`](https://github.com/bombshell-dev/tab).

### Package Manager Integration

`@bomb.sh/tab` integrates with [package managers](https://github.com/bombshell-dev/tab?tab=readme-ov-file#package-manager-completions). Autocompletions work when running `nuxt` directly within a Nuxt project:

```bash
pnpm nuxt <Tab>
npm exec nuxt <Tab>
yarn nuxt <Tab>
bun nuxt <Tab>
```

For package manager autocompletions, you should install [tab's package manager completions](https://github.com/bombshell-dev/tab?tab=readme-ov-file#package-manager-completions) separately.

## Contributing

```bash
# Install dependencies
pnpm i

# Build project and start watcher
pnpm dev

# Go to the playground directory
cd playground

# And run any commands
pnpm nuxt <command>
```

## License

[MIT](./LICENSE)

---
_Source: https://npm.io/package/@nuxt/cli · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._
