LinuxCommandLibrary

bun-outdated

List outdated Bun dependencies

TLDR

List all outdated dependencies in the current project

$ bun outdated
copy

Check if a specific package is outdated
$ bun outdated [package]
copy

List outdated dependencies matching a glob pattern
$ bun outdated "[pattern]"
copy

Show outdated dependencies for specific workspaces
$ bun outdated [[-F|--filter]] "[workspace_pattern]"
copy

Recursively check all workspaces in a monorepo
$ bun outdated [[-r|--recursive]]
copy

SYNOPSIS

bun outdated [--json]

PARAMETERS

--json
    Output machine-readable JSON array of outdated packages with name, current, and latest versions.

DESCRIPTION

bun outdated is a command from the Bun toolkit, a fast JavaScript runtime, bundler, and package manager designed as a drop-in replacement for Node.js, npm, and Webpack.

It scans your project's package.json and bun.lockb files to identify dependencies with available updates. The command compares installed versions against the latest versions from the npm registry (or configured registries), highlighting packages where the latest version exceeds the current one.

By default, it displays a color-coded table with columns for package name, current version, and latest version. This enables quick visual identification of updates for security fixes, new features, or performance gains.

Bun's implementation leverages its speedy dependency resolution, making it significantly faster than equivalents like npm outdated or yarn outdated.

Run it in your project root:
bun outdated

For automation or scripting, use JSON output:
bun outdated --json

The JSON array contains objects like: {"name": "pkg", "current": "1.0.0", "latest": "2.0.0"}.

Ideal for CI/CD pipelines or pre-commit hooks to enforce dependency freshness.

CAVEATS

Requires Bun installation (>=0.5.0); best with bun.lockb present. Uses npm registry by default; respects .bunfig.toml for custom registries. Does not auto-update—use bun update or bun add -g afterward.

DEFAULT TABLE OUTPUT EXAMPLE

pkg@current → latest
lodash 4.17.21 → 4.17.21 (up to date)
axios 1.4.0 → 1.6.0
Colors indicate update urgency.

JSON OUTPUT STRUCTURE

[
{"name": "axios", "current": "1.4.0", "latest": "1.6.0"}
]

HISTORY

Introduced in Bun 0.1.0 (September 2022) by Jarred Sumner as part of Bun's package manager. Evolved with Bun 1.0 (2024) for production stability; JSON output added early for scripting support.

SEE ALSO

bun install(1), bun update(1), npm outdated(1), yarn outdated(1)

Copied to clipboard