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

# [NAME](#NAME)

**bundle-console** - Open an IRB session with the bundle pre-loaded

# [SYNOPSIS](#SYNOPSIS)

**bundle console** \[GROUP]

# [DESCRIPTION](#DESCRIPTION)

Starts an interactive Ruby console session in the context of the current bundle.

If no **GROUP** is specified, all gems in the **default** group in the [Gemfile(5)](/man/os/ruby3.4-bundler/Gemfile.5) *https://guides.rubygems.org/gemfile/* are preliminarily loaded.

If **GROUP** is specified, all gems in the given group in the Gemfile in addition to the gems in **default** group are loaded. Even if the given group does not exist in the Gemfile, IRB console starts without any warning or error.

The environment variable **BUNDLE\_CONSOLE** or **bundle config set console** can be used to change the shell from the following:

- **irb** (default)
- **pry** (https://github.com/pry/pry)
- **ripl** (https://github.com/cldwalker/ripl)

**bundle console** uses irb by default. An alternative Pry or Ripl can be used with **bundle console** by adjusting the **console** Bundler setting. Also make sure that **pry** or **ripl** is in your Gemfile.

# [EXAMPLE](#EXAMPLE)

```
$ bundle config set console pry
$ bundle console
Resolving dependencies...
[1] pry(main)>
```

# [SEE ALSO](#SEE_ALSO)

[Gemfile(5)](/man/os/ruby3.4-bundler/Gemfile.5) *https://guides.rubygems.org/gemfile/*

April 2026

---

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