.\" generated with Ronn/v0.7.3
.\" http://github.com/rtomayko/ronn/tree/0.7.3
.
.TH "NPM\-CACHE" "1" "August 2014" "" ""
.
.SH "NAME"
\fBnpm\-cache\fR \- Manipulates packages cache
.
.SH "SYNOPSIS"
.
.nf

npm cache add <tarball file>
npm cache add <folder>
npm cache add <tarball url>
npm cache add <name>@<version>

npm cache ls [<path>]

npm cache clean [<path>]
.
.fi
.
.SH "DESCRIPTION"
Used to add, list, or clear the npm cache folder\.
.
.TP
add
Add the specified package to the local cache\. This command is primarily intended to be used internally by npm, but it can provide a way to add data to the local installation cache explicitly\.
.
.TP
ls
Show the data in the cache\. Argument is a path to show in the cache folder\. Works a bit like the \fBfind\fR program, but limited by the \fBdepth\fR config\.
.
.TP
clean
Delete data out of the cache folder\. If an argument is provided, then it specifies a subpath to delete\. If no argument is provided, then the entire cache is cleared\.
.
.SH "DETAILS"
npm stores cache data in the directory specified in \fBnpm config get cache\fR\. For each package that is added to the cache, three pieces of information are stored in \fB{cache}/{name}/{version}\fR:
.
.TP
\&\.\.\./package/package\.json
The package\.json file, as npm sees it\.
.
.TP
\&\.\.\./package\.tgz
The tarball for that version\.
.
.P
Additionally, whenever a registry request is made, a \fB\.cache\.json\fR file is placed at the corresponding URI, to store the ETag and the requested data\. This is stored in \fB{cache}/{hostname}/{path}/\.cache\.json\fR\.
.
.P
Commands that make non\-essential registry requests (such as \fBsearch\fR and \fBview\fR, or the completion scripts) generally specify a minimum timeout\. If the \fB\.cache\.json\fR file is younger than the specified timeout, then they do not make an HTTP request to the registry\.
.
.SH "CONFIGURATION"
.
.SS "cache"
Default: \fB~/\.npm\fR on Posix, or \fB%AppData%/npm\-cache\fR on Windows\.
.
.P
The root cache folder\.
.
.SH "SEE ALSO"
.
.IP "\(bu" 4
npm help  folders
.
.IP "\(bu" 4
npm help config
.
.IP "\(bu" 4
npm help  config
.
.IP "\(bu" 4
npm help  npmrc
.
.IP "\(bu" 4
npm help install
.
.IP "\(bu" 4
npm help publish
.
.IP "\(bu" 4
npm help pack
.
.IP "" 0