Skip to main content

​
Basic Usage

Alias — bun rm, bun uninstall, bun r
terminal
The package is removed from every dependency group in package.json that lists it, bun.lock is updated, and it is deleted from node_modules once nothing else depends on it.

​
--filter

Alias — -F
In a monorepo, remove the package from the matching workspace(s) instead of the current directory’s package, using the same patterns as bun add --filter. Use --filter '*' to remove it from every workspace package. Workspaces that don’t list the package are left untouched.
terminal

​
CLI Usage

terminal

​
General Information

​
boolean
Print this help menu. Alias: -h

​
Configuration

​
string
Specify path to config file (bunfig.toml). Alias: -c

​
Package.json Interaction

​
boolean
Don’t update package.json or save a lockfile
​
boolean
default:"true"
Save to package.json (true by default)
​
boolean
Add to trustedDependencies in the project’s package.json and install the package(s)
​
string
Remove the package(s) from the matching workspaces instead of the current package. Alias: -F

​
Lockfile Behavior

​
boolean
Write a yarn.lock file (yarn v1). Alias: -y
​
boolean
Disallow changes to lockfile
​
boolean
Save a text-based lockfile
​
boolean
Generate a lockfile without installing dependencies

​
Dependency Filtering

​
boolean
Don’t install devDependencies. Alias: -p
​
string
Exclude dev, optional, or peer dependencies from install

​
Network & Registry

​
string
Provide a Certificate Authority signing certificate
​
string
Same as —ca, but as a file path to the certificate
​
string
Use a specific registry by default, overriding .npmrc, bunfig.toml and environment variables

​
Execution Control & Validation

​
boolean
Don’t install anything
​
boolean
Always request the latest versions from the registry & reinstall all dependencies. Alias: -f
​
boolean
Skip verifying integrity of newly downloaded packages

​
Output & Logging

​
boolean
Don’t log anything
​
boolean
Excessively verbose logging
​
boolean
Disable the progress bar
​
boolean
Don’t print a summary

​
Caching

​
string
Store & load cached data from a specific directory path
​
boolean
Ignore manifest cache entirely

​
Script Execution

​
boolean
Skip lifecycle scripts in the project’s package.json (dependency scripts are never run)
​
number
Maximum number of concurrent jobs for lifecycle scripts (default: 2x CPU cores)

​
Scope & Path

​
boolean
Install globally. Alias: -g
​
string
Set a specific cwd

​
Advanced & Performance

​
string
default:"clonefile"
Platform-specific optimizations for installing dependencies. Possible values: clonefile (default), hardlink, symlink, copyfile
​
number
default:"48"
Maximum number of concurrent network requests (default 48)