BUNDLE-PLUGIN(1) General Commands Manual BUNDLE-PLUGIN(1)

bundle-plugin - Manage Bundler plugins

bundle plugin install PLUGINS [--source=SOURCE] [--version=VERSION] [--git=GIT] [--branch=BRANCH|--ref=REF] [--local-git=LOCAL_GIT] [--path=PATH]
bundle plugin uninstall PLUGINS [--all]
bundle plugin list
bundle plugin help [COMMAND]

You can install, uninstall, and list plugin(s) with this command to extend functionalities of Bundler.

Install the given plugin(s).

For example, bundle plugin install bundler-graph will install bundler-graph gem from globally configured sources (defaults to RubyGems.org). Note that the global source specified in Gemfile is ignored.

OPTIONS

Install the plugin gem from a specific source, rather than from globally configured sources.
Example: bundle plugin install bundler-graph --source https://example.com
Specify a version of the plugin gem to install via --version.
Example: bundle plugin install bundler-graph --version 0.2.1
Install the plugin gem from a Git repository. You can use standard Git URLs like:
ssh://[user@]host.xz[:port]/path/to/repo.git
http[s]://host.xz[:port]/path/to/repo.git
/path/to/repo
file:///path/to/repo
Example: bundle plugin install bundler-graph --git https://github.com/rubygems/bundler-graph
When you specify --git, you can use --branch to use.
When you specify --git, you can use --ref to specify any tag, or commit hash (revision) to use.
Install the plugin gem from a local path.
Example: bundle plugin install bundler-graph --path ../bundler-graph
Install the plugin gem from a local Git repository.
Example: bundle plugin install bundler-graph --local-git ../bundler-graph.
This option is deprecated in favor of --git.

Uninstall the plugin(s) specified in PLUGINS.

OPTIONS

Uninstall all the installed plugins. If no plugin is installed, then it does nothing.

List the installed plugins and available commands.

No options.

Describe subcommands or one specific subcommand.

No options.

How to write a Bundler plugin https://bundler.io/guides/bundler_plugins.html
August 2025