BUNDLE-PLUGIN(1)

💅 bundle-plugin — bestie, let's talk plugins

okay so quick heads up: this page is from the General Commands Manual (that's the bundle-plugin(1) vibe, iykyk), and we're about to make your Bundler do extra stuff. Periodt.

---

✨ NAME ✨

bundle-plugin — literally the command that manages your Bundler plugins. that's it, that's the name 🎀

---

🦋 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 🌸

so with this command you can install, uninstall, and list plugin(s). that's the whole point — it extends the functionalities of Bundler. more Bundler, but extra. 🫶

---

🔥 SUB-COMMANDS 🔥

⭐ install

install the given plugin(s). simple as that.

for example, bundle plugin install bundler-graph will install bundler-graph gem from globally configured sources (defaults to RubyGems.org). 🎀

important bestie: the global source specified in Gemfile is ignored. like, it just doesn't get a say here. 😭

💖 OPTIONS 💖

• --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 — specify a version of the plugin gem to install via --version.

example: bundle plugin install bundler-graph --version 0.2.1

• --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 — when you specify --git, you can use --branch to use. 🌿
• --ref=REF — when you specify --git, you can use --ref to specify any tag, or commit hash (revision) to use. 🏷️
• --path=PATH — install the plugin gem from a local path.

example: bundle plugin install bundler-graph --path ../bundler-graph

---

🗑️ uninstall

uninstall the plugin(s) specified in PLUGINS. bye bestie 💀

💅 OPTIONS 💅

• --all — uninstall all the installed plugins. and if no plugin is installed, then it does nothing. (iconic honestly — no drama, no error, just vibes ✨)

---

📋 list

list the installed plugins and available commands.

no options. that's it. main character energy, zero flags. 👑

---

🧚 help

describe subcommands or one specific subcommand.

no options. it's giving helpful and low maintenance. 💜

---

🌈 SEE ALSO 🌈

• How to write a Bundler plugin — https://bundler.io/guides/bundler_plugins.html

---

okay that's the whole page, no cap. this little beauty is dated April 2026 and it comes to you straight from the Bundler fam (BUNDLE-PLUGIN(1), General Commands Manual) — go forth and plugin-ify your life, bestie 🍓💖✨