bundle-outdated(1) -- List installed gems with newer versions available
=======================================================================

## SYNOPSIS

`bundle outdated` [GEM] [--local]
                        [--pre]
                        [--source]
                        [--filter-strict | --strict]
                        [--update-strict]
                        [--parseable | --porcelain]
                        [--group=GROUP]
                        [--groups]
                        [--patch|--minor|--major]
                        [--filter-major]
                        [--filter-minor]
                        [--filter-patch]
                        [--only-explicit]
                        [--cooldown=NUMBER]

## DESCRIPTION

Outdated lists the names and versions of gems that have a newer version available
in the given source. Calling outdated with [GEM [GEM]] will only check for newer
versions of the given gems. Prerelease gems are ignored by default. If your gems
are up to date, Bundler will exit with a status of 0. Otherwise, it will exit 1.

## OPTIONS

* `--local`:
  Do not attempt to fetch gems remotely and use the gem cache instead.

* `--pre`:
  Check for newer pre-release gems.

* `--source=<list>`:
  Check against a specific source.

* `--filter-strict`, `--strict`:
  Only list newer versions allowed by your Gemfile requirements, also respecting conservative update flags (--patch, --minor, --major).

* `--update-strict`:
  Strict conservative resolution, do not allow any gem to be updated past latest --patch | --minor | --major.

* `--parseable`, `--porcelain`:
   Use minimal formatting for more parseable output.

* `--group=GROUP`:
  List gems from a specific group.

* `--groups`:
  List gems organized by groups.

* `--minor`:
  Prefer updating only to next minor version.

* `--major`:
  Prefer updating to next major version (default).

* `--patch`:
  Prefer updating only to next patch version.

* `--filter-major`:
  Only list major newer versions.

* `--filter-minor`:
  Only list minor newer versions.

* `--filter-patch`:
  Only list patch newer versions.

* `--only-explicit`:
  Only list gems specified in your Gemfile, not their dependencies.

* `--cooldown=<number>`:
  Annotate (rather than hide) versions that are still inside the
  cooldown window of <number> days. The prose output appends "in
  cooldown for Nd more days" and the table form adds "(cooldown Nd)" to
  the Latest column. See `cooldown` in bundle-config(1).

## PATCH LEVEL OPTIONS

See [bundle update(1)](bundle-update.1.html) for details.

## FILTERING OUTPUT

The 3 filtering options do not affect the resolution of versions, merely what versions are shown
in the output.

If the regular output shows the following:

    * Gem       Current  Latest  Requested  Groups              Release Date
    * faker     1.6.5    1.6.6   ~> 1.4     development, test   2024-02-05
    * hashie    1.2.0    3.4.6   = 1.2.0    default             2023-11-10
    * headless  2.2.3    2.3.1   = 2.2.3    test                2022-08-19

`--filter-major` would only show:

    * Gem       Current  Latest  Requested  Groups   Release Date
    * hashie    1.2.0    3.4.6   = 1.2.0    default  2023-11-10

`--filter-minor` would only show:

    * Gem       Current  Latest  Requested  Groups  Release Date
    * headless  2.2.3    2.3.1   = 2.2.3    test    2022-08-19

`--filter-patch` would only show:

    * Gem       Current  Latest  Requested  Groups              Release Date
    * faker     1.6.5    1.6.6   ~> 1.4     development, test   2024-02-05

Filter options can be combined. `--filter-minor` and `--filter-patch` would show:

    * Gem       Current  Latest  Requested  Groups              Release Date
    * faker     1.6.5    1.6.6   ~> 1.4     development, test   2024-02-05

Combining all three `filter` options would be the same result as providing none of them.
