Use bun link in a local directory to register the current package as a “linkable” package.
You can now “link” this package into other projects using bun link cool-pkg. This command creates a symlink in the target project’s node_modules directory pointing to the local directory.
The --save flag also adds cool-pkg to the dependencies field of your app’s package.json, with a version specifier that tells Bun to load from the registered local directory instead of installing from npm:
Unlinking
Use bun unlink in the root directory to unregister a local package.
CLI Usage
Installation Scope
Install globally. Alias: -g
Dependency Management
Don’t install devDependencies. Alias: -p
Exclude dev, optional, or peer dependencies from install
Project Files & Lockfiles
Write a yarn.lock file (yarn v1). Alias: -y
Disallow changes to lockfile
Save a text-based lockfile
Generate a lockfile without installing dependencies
Don’t update package.json or save a lockfile
Add to trustedDependencies in the project’s package.json and install the package(s)
Installation Control
Always request the latest versions from the registry & reinstall all dependencies. Alias: -f
Skip verifying integrity of newly downloaded packages
Platform-specific optimizations for installing dependencies. One of clonefile, hardlink,
symlink, or copyfile
Linker strategy (one of isolated or hoisted)
Perform a dry run without making changes
Skip lifecycle scripts for all packages, including the project’s package.json and trusted dependencies
Network & Registry
Provide a Certificate Authority signing certificate
Same as —ca, but as a file path to the certificate
Use a specific registry by default, overriding .npmrc, bunfig.toml, and environment
variables
Maximum number of concurrent network requests
Maximum number of concurrent jobs for lifecycle scripts (default: 2x CPU cores)
Caching
Store & load cached data from a specific directory path
Ignore manifest cache entirely
Output & Logging
Excessively verbose logging
Override CPU architecture for optional dependencies (e.g., x64, arm64, * for
all)
Override operating system for optional dependencies (e.g., linux, darwin, * for
all)
Global Configuration & Context
Specify path to config file (bunfig.toml). Alias: -c
Set a specific current working directory
Help
Print this help menu. Alias: -h