Manage your development enviroments faster! Project is REDESIGNING NOW!

Carlos Kleiber

Carlos Kleiber (3 July 1930 – 13 July 2004) was a German-born Austrian conductor who is widely regarded as being among the greatest conductors of the 20th century.


Kleiber provides an interface for control multiple vagrant machines. In case when you have distributed system of applications, each application have its vagrant machine and you need to manage system locally in development order Kleiber may be useful.

Kleiber combines projects into groups called symphonies which can be used over centralized control. Using projects combined in symphonies provides general environment for all used projects. Also vagrant provides tasks interface for control applications in vagrant.


On your HOST machine:

  • ruby >= 2.0
  • vagrant


Install it manually

gem install kleiber


Kleiber provides simple CLI.

kleiber <vagrant command> <symphony name> [projects] [-t tasks:chain:colon:separated ]


kleiber up symphony1 # calls vagrant up for symphonies
kleiber up symphony1 -t setup:run # calls vagrant up && vagrant ssh -c 'setupcommand... && runcommand...'
kleiber halt symphony1 project1 # calls vagrant ssh for project1 in symphony1


Before start to use kleiber you need to make config like this:

# List of projects which kleiber can use in its symphonies
  - :name: project1
    :prefix: PROJ1
    :path: /path/to/project/dir
    :guest_port: 8000
    :host_port: 8000
      setup: 'npm i'
      run: 'node start'

  - :name: project2
    :prefix: PROJ2
    :path: /path/to/project/dir
    :guest_port: 8000
    :host_port: 8000

# Dictionary of tasks with the lowest priority for all projects and symphonies
# Actually, we can call it like 'list of default task values'
  setup: 'bundle install --jobs 4'
  run: 'bundle exec rails s -p %{port}'
  console: 'bundle exec rails c'

# Dictionary of symphonies which kleiber can perform
    :projects: ['project1', 'project2']
      setup: 'bundle'
      run: 'rails c'

# Working terminal settings
  :exec: 'gnome-terminal'
  :new_tab: '--tab'
  :exec_command: '-e'

Project parameters

Key Type Description
name * string Project identificator
prefix * string Prefix for HOST and PORT env variables
path * string Absolute path to project directory
guest_port * number Vagrant guest port
host_port * number Vagrant host port
host * string Vagrant host ip address
tasks key/value List of task definitions for project
env key/value List of env variables definition for project

* - required parameters

tasks defined values have the highest priority. That means if one defined, it will be used when task required to execute for project in symphony.

Symphony parameters

Key Type Description
projects * list List of projects uses in one symphony
tasks key/value List of task definitions for symphony
env key/value List of env variables definition for symphony

* - required parameters

tasks defined values have lower priority than project task values. That means, it will be used if project value isn't defined.


Recommended to install Vagrant.
vagrant up && vagrant ssh - switch on and get access to development vagrant machine.
bin/setup - install dependecies and setup app.
bundle exec rspec - to run tests.
bundle exec rake install - install gem on your local machine.


Bug reports and pull requests are welcome on GitHub at https://github.com/qelphybox/kleiber. This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the Contributor Covenant code of conduct.


The gem is available as open source under the terms of the MIT License.