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

<?><?><?> (NAME)
       bundle-add - <?><?><?><?><?><?> gem <?><?> Gemfile <?> <?><?><?><?><?>
       bundle install

<?><?><?><?><?> <?><?><?><?><?> (SYNOPSIS)
       bundle add GEM_NAME [--group=GROUP] [--version=VERSION]
       [--source=SOURCE] [--path=PATH] [--git=GIT|--github=GITHUB]
       [--branch=BRANCH] [--ref=REF] [--quiet] [--skip-install]
       [--strict|--optimistic]

<?><?><?><?><?><?><?> (DESCRIPTION)
       <?><?> <?><?><?><?><?><?><?><?> <?><?> <?><?> [Gemfile(5)][Gemfile(5)]
       <?><?><?><?><?> <?><?><?><?> <?> bundle install <?><?> <?><?><?><?>
       <?><?><?><?><?><?>. <?><?> <?><?><?><?><?><?><?> <?><?> <?><?><?><?>
       --skip-install <?><?><?><?><?><?><?> <?><?> <?><?><?><?><?> bundle
       install <?><?><?><?><?><?><?> <?><?><?>.

<?><?><?><?><?><?><?><?> (OPTIONS)
       --version=VERSION, -v=VERSION
              <?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?><?>(<?><?><?>)
              <?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?><?><?><?><?><?>.

       --group=GROUP, -g=GROUP
              <?><?><?><?> <?><?><?><?> <?><?><?><?>(<?><?><?>)
              <?><?><?><?><?> <?><?> <?><?> <?><?><?><?><?><?><?><?><?>.
              <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?>
              <?><?> <?><?><?><?> <?><?> <?><?><?><?><?><?> <?><?><?>
              <?><?><?><?>.

       --source=SOURCE, -s=SOURCE
              <?><?><?><?> <?><?><?><?> <?><?><?><?> (source) <?><?><?><?>
              <?><?> <?><?><?><?><?><?><?><?><?>.

       --require=REQUIRE, -r=REQUIRE
              <?><?><?><?> require <?><?> <?><?> <?><?> <?><?><?><?><?>
              <?><?><?><?><?><?>. <?><?><?><?><?> false <?><?> <?><?>
              <?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?> <?><?><?><?>
              <?><?><?><?> <?><?><?><?>.

       --path=PATH
              <?><?><?><?> <?><?><?><?> <?><?><?><?>
              <?><?><?><?><?><?><?><?><?><?> <?><?><?><?> <?><?>
              <?><?><?><?><?><?><?><?><?>.

       --git=GIT
              <?><?><?><?> <?><?><?><?> <?><?><?><?> git <?><?><?><?> <?><?>
              <?><?><?><?><?><?><?><?><?>.

       --github=GITHUB
              <?><?><?><?> <?><?><?><?> <?><?><?><?> github <?><?><?><?>
              <?><?> <?><?><?><?><?><?><?><?><?>.

       --branch=BRANCH
              <?><?><?><?> <?><?><?><?> <?><?><?><?> git <?><?><?><?> <?><?>
              <?><?><?><?><?><?><?><?><?>.

       --ref=REF
              <?><?><?><?> <?><?><?><?> git ref <?><?><?><?> <?><?>
              <?><?><?><?><?><?><?><?><?>.

       --glob=GLOB
              <?><?><?><?> <?><?><?><?> <?><?><?><?> <?><?><?><?> .gemspec
              <?><?><?><?><?><?><?><?> <?><?> <?><?><?><?> Ruby <?><?><?>
              <?><?><?><?><?><?><?> (<?><?><?><?><?><?><?> <?><?>
              <?><?><?><?><?><?><?> <?><?><?> <?><?><?><?><?><?><?>
              <?><?><?><?><?><?>).

       --quiet
              <?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?> <?><?>
              <?><?><?><?><?> <?><?><?><?><?><?><?><?><?> <?><?><?>
              <?><?><?><?><?><?><?>.

       --skip-install
              <?><?> <?><?> <?><?> Gemfile <?><?><?><?><?> <?><?><?><?><?><?>
              <?><?><?> <?><?> <?><?> <?><?><?> <?><?><?><?><?><?><?>.

       --optimistic
              <?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?> (optimistic)
              <?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?><?><?>.

       --strict
              <?><?><?><?><?> <?><?><?><?> <?> <?><?><?><?><?><?><?><?><?><?>
              (strict) <?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?><?><?>.

<?><?><?><?><?><?><?> (EXAMPLES)
       1.  <?><?><?><?><?><?><?><?><?> <?><?> rails <?><?> <?><?><?><?>
           <?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?>
           Gemfile <?><?><?><?><?> <?><?><?><?>. <?><?><?><?> <?><?><?>
           <?><?><?><?> <?><?><?><?><?><?> (global source) <?><?><?><?><?>
           <?><?><?>.

           bundle add rails

       2.  <?><?><?><?><?><?><?><?><?> <?><?> rails <?><?> <?><?> <?><?><?><?>
           <?><?><?><?><?><?><?> <?><?> 1.1 (<?><?><?><?> <?><?><?><?>
           <?><?><?> <?><?><?> 1.1) <?> <?><?><?><?><?><?><?> <?><?> 3.0
           <?><?><?><?><?> <?><?><?><?>.

           bundle add rails --version "> 1.1, < 3.0"

       3.  <?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?><?>
           https://gems.example.com <?><?><?><?><?><?><?> <?><?><?><?> <?>
           <?><?> <?><?> <?><?> <?><?> <?><?><?><?> <?><?><?><?><?><?>
           <?><?><?><?>.

           bundle add rails --version "~> 5.0.0" --source
           "https://gems.example.com" --group "development"

       4.  <?><?><?><?><?> <?><?><?> <?><?><?><?> gem <?><?> <?><?><?><?>
           <?><?><?> <?><?><?><?> <?><?> Gemfile <?><?><?><?><?>
           <?><?><?><?><?><?>. <?><?><?><?><?><?><?><?><?> <?><?><?><?><?>
           <?><?><?><?><?> <?><?> <?><?> bundle install <?><?><?>
           <?><?><?><?>.

           bundle add rails --skip-install

       5.  <?><?><?><?><?><?><?><?><?> <?><?> <?><?> <?><?> <?><?><?> <?><?>
           <?><?> <?><?><?><?> <?><?><?><?><?><?> <?><?><?><?>.

           bundle add rails --group "development, test"




<?><?><?><?><?><?> <?><?><?><?><?><?> (SEE ALSO)
       Gemfile(5) https://bundler.io/man/gemfile.5.html, bundle-remove(1)
       bundle-remove.1.html

                                September 2025                   BUNDLE-ADD(1)