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

# [NAME](#NAME)

**bundle-plugin** - Manage Bundler plugins

# [SYNOPSIS](#SYNOPSIS)

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

# [DESCRIPTION](#DESCRIPTION)

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

# [SUB-COMMANDS](#SUB)

## [install](#install)

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**

[**--source=SOURCE**](#source=SOURCE)

Install the plugin gem from a specific source, rather than from globally configured sources.

Example: **bundle plugin install bundler-graph --source https://example.com**

[**--version=VERSION**](#version=VERSION)

Specify a version of the plugin gem to install via **--version**.

Example: **bundle plugin install bundler-graph --version 0.2.1**

[**--git=GIT**](#git=GIT)

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**

[**--branch=BRANCH**](#branch=BRANCH)

When you specify **--git**, you can use **--branch** to use.

[**--ref=REF**](#ref=REF)

When you specify **--git**, you can use **--ref** to specify any tag, or commit hash (revision) to use.

[**--path=PATH**](#path=PATH)

Install the plugin gem from a local path.

Example: **bundle plugin install bundler-graph --path ../bundler-graph**

## [uninstall](#uninstall)

Uninstall the plugin(s) specified in PLUGINS.

**OPTIONS**

[**--all**](#all)

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

## [list](#list)

List the installed plugins and available commands.

No options.

## [help](#help)

Describe subcommands or one specific subcommand.

No options.

# [SEE ALSO](#SEE_ALSO)

•

How to write a Bundler plugin *https://guides.rubygems.org/bundler\_plugins/*

April 2026

---

Document: bundle-plugin(1) from ruby3.4-bundler 4.0.23-r0 (Chainguard OS)
Source: https://github.com/rubygems/rubygems