How to list npm user-installed packages?

Question

How do I list the user-installed / envirorment package ONLY in npm?

When I do npm -g list it outputs every package and their dependencies, instead I'd like to see the packages installed in the current working project or envirorment.

score 1706 · Accepted Answer · edited Apr 07 '21 at 08:44

1706

npm list -g --depth=0

npm: the Node package manager command line tool
list -g: display a tree of every package found in the user’s folders (without the -g option it only shows the current directory’s packages)
--depth 0 / --depth=0: avoid including every package’s dependencies in the tree view

edited Apr 07 '21 at 08:44

Shashikanth Reddy

307
3
13

answered Aug 26 '14 at 02:20

aris

20,635
1
25
31

1

Return empty result. My npm version is 3.6.0. – Bagusflyer Jul 21 '16 at 04:07
17

Why the `--depth=0` option is not mentioned when I run `npm help ls`? – Marecky Mar 07 '18 at 10:48
If you install your modules at another folder using `--prefix`, then you need to add the `--prefix` too into this `npm list` command. – Sany Liew Aug 06 '18 at 04:06
2

@Fabricio, you can run `npm config set depth 0` to make it the default. – David Y. Stephenson Sep 17 '18 at 12:15
It doesn't work for me on Windows: `C:\Web\git>npm list -g --depth=0 C:\Users\david\AppData\Roaming\npm `-- (empty)` – David Spector Jan 16 '19 at 21:11
I've installed several packages, but my npm directory is empty! Bug in npm? I got warning messages on each install: `C:\Web\git>npm install --save-dev webpack npm WARN saveError ENOENT: no such file or directory, open 'C:\Web\git\package.json' npm WARN enoent ENOENT: no such file or directory, open 'C:\Web\git\package.json' npm WARN git No description npm WARN git No repository field. npm WARN git No README data npm WARN git No license field. npm WARN optional SKIPPING OPTIONAL DEPENDENCY: fsevents@1.2.6 (node_modules\fsevents): npm WARN notsup SKIPPING OPTIONAL DEPENDENCY: ...` – David Spector Jan 16 '19 at 21:14
3

It also might be good to add `| grep -v "duped"` to remove duplicated dependencies onto the list – Spencer Pollock Feb 08 '19 at 21:23
The following is quite fast: `find "$(npm root -g)" -maxdepth "$(<<< "$(npm root -g)" sed 's:/: :g' | wc -w)" -name package.json | cut -d/ -f5- | sed -e 's:/package.json$::' -e '/^[^@].*\//d'`. But is it correct? – Mmmh mmh Mar 03 '21 at 19:50
@Marecky it's buried at the bottom. Look under the configuration section – lasec0203 Mar 19 '21 at 02:22

score 160 · Answer 2 · edited Oct 22 '21 at 00:16

160

You can get a list of all globally installed modules using:

ls `npm root -g`

edited Oct 22 '21 at 00:16

Koray Tugay

21,794
41
171
299

answered Feb 28 '14 at 14:46

Gil

3,251
1
18
21

1

@user2167582 On windows you would probably need something like a [cygwin](http://www.cygwin.com/) shell for it to work. – Gil Jun 12 '14 at 18:57
20

`ls -lh \`npm root -g\`` displays them in a nice list. – LanceLafontaine Feb 11 '15 at 00:53
That's so much better, simpler and more beautiful than the `npm list -g --depth=0` which is supposed to be the ~official~ way to do this. – Matheus Felipe Jun 08 '15 at 22:44
6

This solution is much faster than the top voted one. – DarkNeuron Feb 05 '16 at 11:31
3

This solution is nice but `npm list -g --depth=0` which prints out the version which is nice. Anyways, I didn't know about this command so +1 for that. – pixel 67 Dec 22 '16 at 10:31
4

`npm root -g | gci` in Powershell on windows – Lars May 17 '17 at 14:53
1

@FranzSittampalam `find "$(npm root -g)" -maxdepth "$(npm root -g | sed 's:/: :g' | wc -w)" -name package.json | cut -d/ -f5- | sed -e 's:/package.json$::' -e '/^[^@].*\//d'` – Mmmh mmh Dec 02 '19 at 23:28
@Gil more specifically a POSIX compliant shell – Charitarth Chugh Apr 24 '21 at 20:20

arcseldon · Answer 3 · 2017-01-28T18:32:55.960

As of 13 December 2015

Whilst I found the accepted answer 100% correct, and useful, wished to expand upon it a little based on my own experiences, and hopefully for the benefit of others too. (Here I am using the terms package and module interchangeably)

In answer to the question, yes the accepted answer would be:

npm list -g --depth=0

You might wish to check for a particular module installed globally, on *nix systems / when grep available. This is particularly useful when checking what version of a module you are using (globally installed, just remove the -g flag if checking a local module):

npm list -g --depth=0 | grep <module_name>

If you'd like to see all available (remote) versions for a particular module, then do:

npm view <module_name> versions

Note, versions is plural. This will give you the full listing of versions to choose from.

For latest remote version:

npm view <module_name> version

Note, version is singular.

To find out which packages need to be updated, you can use

npm outdated -g --depth=0

To update global packages, you can use

npm update -g <package>

To update all global packages, you can use:

npm update -g

(However, for npm versions less than 2.6.1, please also see this link as there is a special script that is recommended for globally updating all packages).

The above commands should work across NPM versions 1.3.x, 1.4.x, 2.x and 3.x

To update a specific global package: `npm update -g `. I believe `update` is preferable to `install` here because npm will be smart and do the installation only if the specified package is outdated. — Robin A. Meade, Jan 27 '17 at 22:22
@Talespin_Kit ShareX is FANTASTIC for creating and sharing gif screenshots (and any other screen shots). — , Apr 10 '19 at 10:49

score 60 · Answer 4 · edited Jan 05 '22 at 19:46

60

List NPM packages with some friendly gui!

This is what I personally prefer and it may be for others too, it may also help during presentations or meetings.

With npm-gui you can list local and global packages with a better visualization.

You can find the package at

Run the following

//Once
npm install -g npm-gui

cd c:\your-prject-folder
npm-gui localhost:9000

Then open your browser at http:\\localhost:9000

edited Jan 05 '22 at 19:46

Federico Baù

3,772
4
18
27

answered Aug 23 '17 at 12:29

Alireza Fattahi

38,349
12
107
156

how do you load for globally installed packages ? – Ciasto piekarz Dec 27 '18 at 05:48
@Ciastopiekarz the top menu now has a _Global_ link for globally available packages. – CPHPython Oct 11 '20 at 23:13
this is not showing my projects packages - only global? Good GUI though! – v3nt Apr 21 '22 at 08:49

score 27 · Answer 5 · answered May 31 '16 at 14:51

27

For project dependencies use:

npm list --depth=0

For global dependencies use:

npm list -g --depth=0

answered May 31 '16 at 14:51

Karthik damodara

1,751
18
17

score 27 · Answer 6 · answered Nov 24 '16 at 10:37

npm ls

npm list is just an alias for npm ls

For the extended info use

npm la    
npm ll

You can always set --depth=0 at the end to get the first level deep.

npm ls --depth=0

You can check development and production packages.

npm ls --only=dev
npm ls --only=prod

To show the info in json format

npm ls --json=true

The default is false

npm ls --json=false

You can insist on long format to show extended information.

npm ls --long=true

You can show parseable output instead of tree view.

npm ls --parseable=true

You can list packages in the global install prefix instead of in the current project.

npm ls --global=true
npm ls -g // shorthand

Full documentation you can find here.

score 11 · Answer 7 · edited Mar 16 '17 at 14:34

Node has a concept of Local modules & Global modules

Local modules are located within current project directory.

Global Modules are generally located at user's home directory, though we can change the path where global modules resides.

Lists local modules within current dir: npm list
Lists global modules : npm list --global OR npm list --g // It will list all the top level modules with its dependencies
List only top level(Installed modules) global modules : npm list -g --depth=0

score 9 · Answer 8 · answered Jul 30 '13 at 03:54

9

One way might be to find the root directory of modules using:

npm root
/Users/me/repos/my_project/node_modules

And then list that directory...

ls /Users/me/repos/my_project/node_modules
grunt                   grunt-contrib-jshint

The user-installed packages in this case are grunt and grunt-contrib-jshint

answered Jul 30 '13 at 03:54

obimod

781
9
25

2

Why not use the official built-in npm command? `npm list -g --depth=0` – Andrew Camilleri 'Kukks' Jan 16 '15 at 12:41
This way might help the developer understand what's going on under the hood – obimod Jun 13 '16 at 17:35
2

This isn't 100% correct. When I run the command `npm root` it tells me: `Users/me/node_modules` which isn't correct. My node_modules lives somewhere else. I guess it depends on how you install node. I use `brew` to install my software. I'm guessing this is if you install node from their website using their package installer? – pixel 67 Dec 22 '16 at 10:35
I think it depends on your environment variables. Check out the $NPM... vars set in your enviro. I have a custom setup, using virtualenv and the activate hook to completely rewrite $PATH from scratch depending on what the project uses. – obimod Jan 19 '17 at 14:13
2

For me, my npm broke so I couldn't use the commands. I wanted to do a full reinstall so I needed to know which packages I had installed globally to rebuild. – bryjohns May 04 '17 at 20:01
I am using nvm for maintaining different node versions. This is the only command that worked for me. – kaushalpranav Dec 06 '20 at 11:01

pixel 67 · Answer 9 · 2019-06-21T08:39:33.330

9

I use npm -g outdated --depth=0 to list outdated versions
in the global space.

edited Jun 21 '19 at 08:39

answered Dec 31 '16 at 10:45

pixel 67

1,340
16
20

score 8 · Answer 10 · answered Jul 23 '15 at 11:41

8

To see list of all packages that are installed.

$ npm ls --parseable | awk '{gsub(/\/.*\//,"",$1); print}'| sort -u

show parseable of npm packages list https://docs.npmjs.com/cli/ls#parseable

answered Jul 23 '15 at 11:41

rab

4,066
1
28
40

This is great! How can I just show dev dependencies? – Michael Bruce Aug 14 '17 at 01:58

score 8 · Answer 11 · edited Jun 19 '19 at 23:52

8

You can try NPM Desktop manager

With just one click, you can install/uninstall packages in dev or global status.

edited Jun 19 '19 at 23:52

Bryan

4,120
2
31
53

answered May 03 '19 at 20:07

kant

107
1
3

score 6 · Answer 12 · answered Jul 30 '13 at 07:18

Node_modules contains user-installed packages so change the directory to node_modules and list the items. Core Modules are defined in node's source in the lib/ folder.

Example:

     example@example:~/:~/node_modules$ ls
     express  maxmind-native  node-whois  socket.io  ua-parser-js
     geoip    mongoskin       pdfkit      tail       zeromq
     maxmind  nodemailer      request     ua-parser  zmq

Federico Baù · Answer 13 · 2022-02-23T06:05:44.813

As the end of 2021, there are few obvious way to do it, despite all the other answer are still working I think an update is needed besides a more defined and complete list of commands possible, and while am I at it, I added some other common commands for whom needs it (install, uninstall etc..)

# bare command
npm list
# ls is an alias of list
npm ls 
# don't shows dependencies
npm list --depth=0
# Global modules
npm list -g --depth=0
# More info
npm la    
npm ll
# show particual env packages
npm ls --only=dev
npm ls --only=prod
# parseable view (tree view)
npm ls --parseable=true

The Node.js Documentation is actually pretty well explained regarding the matter, this is a collective list of the main commands.

Before start NOTE:

All Commands will run the list of installed modules Locally. In order to run global level just add a -g flag at the end of the statement.

List installed dependency commands

See the version of all installed npm packages, including their dependencies.

❯ npm list

 >>> /Users/joe/dev/node/cowsay
 └─┬ cowsay@1.3.1
   ├── get-stdin@5.0.1
   ├─┬ optimist@0.6.1
   │ ├── minimist@0.0.10
   │ └── wordwrap@0.0.3
   ├─┬ string-width@2.1.1
   │ ├── is-fullwidth-code-point@2.0.0
   │ └─┬ strip-ansi@4.0.0
   │   └── ansi-regex@3.0.0
   └── strip-eof@1.0.0

Get only your top-level packages
```
npm list --depth=0
```
Get the version of a specific package by specifying its name.
```
npm list <package-name>
```
See what's the latest available version of the package on the npm repository
```
npm view <package-name> version
```
Install an old version of an npm package using the @ syntax

npm install @ npm install cowsay@1.2.0

Listing all the previous versions of a package

npm view cowsay versions
[ '1.0.0',
  '1.0.1',
  '1.0.2',
  '1.0.3',
  '1.1.0',
  '1.1.1',
  '1.1.2',
  '1.1.3',
  ....
]

Update all the Node.js dependencies

Install new minor or patch release
```
 npm update
```
Install new minor or patch release but not update package.json
```
 npm update --no-save
```
To discover new releases of the packages, this gives you the list of a few outdated packages in one repository that wasn't updated for quite a while
```
  npm outdated
```

Some of those updates are major releases. Running npm update won't update the version of those. Major releases are never updated in this way because they (by definition) introduce breaking changes, and npm wants to save you trouble.

To update all packages to a new major version, install the npm-check-updates package globally:

npm install -g npm-check-updates
ncu -u

This will upgrade all the version hints in the package.json file, to dependencies and devDependencies, so npm can install the new major version

Dev Dependency

Install in development dependencies.

npm install <package-name> -D
npm install <package-name> --save-dev # same as above

Avoid installing those development dependencies in Production with

npm install --production

Uninstalling npm packages

npm uninstall <package-name>
npm uninstall -g <package-name> # globally uninstall

Uninstall a package and ** remove the reference in the package.json**

  npm uninstall <package-name> -S
  npm uninstall <package-name> --save # same as above

Some commands with global flag examples.

npm list -g 
npm list --depth=0 -g
npm list <package-name> -g 
npm view <package-name> version -g

Additional Commands

Answer by @prosti

Documentation

score 5 · Answer 14 · answered May 30 '19 at 05:39

5

For Local module usenpm list --depth 0

Foe Global module npm list -g --depth 0

Example local npm module Example global npm module

answered May 30 '19 at 05:39

Jeyam Thillai

61
2
10

score 4 · Answer 15 · answered Feb 19 '19 at 11:41

4

Use npm list and filter by contains using grep

Example:

npm list -g | grep name-of-package

answered Feb 19 '19 at 11:41

Darlan Dieterich

1,963
1
23
33

score 4 · Answer 16 · answered May 15 '19 at 08:45

4

As a shorthand, you can run:

npm ls -g --depth=0

answered May 15 '19 at 08:45

Mwiza

6,098
3
41
35

score 0 · Answer 17 · edited Oct 31 '21 at 17:54

I am using npm version 7.20.3, and it looks the default depth is 0 already. So in my case, npm list --global showed only one installed package (npm). I knew I had a lot more packages installed, and I was puzzled at the output.

Eventually, I tried the --depth param and I was able to see all the packages installed: npm list --global --depth=1 to see the other packages installed. (Set to say 10 to see the whole dependency tree).