Automate the bundle/migration tedium of Rails with Git hooks
Clone or download
Failed to load latest commit information.
bin hookup 1.0.0 Apr 8, 2011
lib Add bundle exec to commands if Bundler is used Oct 20, 2015
.gitignore hookup 1.0.0 Apr 8, 2011
Gemfile hookup 1.0.0 Apr 8, 2011
MIT-LICENSE Add license Apr 8, 2011
README.markdown Adds removal instruction to README (#35) Oct 15, 2016
Rakefile hookup 1.0.0 Apr 8, 2011
hookup.gemspec hookup 1.2.4 Jun 19, 2014



Hookup takes care of Rails tedium like bundling and migrating through Git hooks. It fires after events like

  • pulling in upstream changes
  • switching branches
  • stepping through a bisect
  • conflict in schema


gem install hookup
cd yourproject
hookup install


Each time your current HEAD changes, hookup checks to see if your Gemfile, Gemfile.lock, or gem spec has changed. If so, it runs bundle check, and if that indicates any dependencies are unsatisfied, it runs bundle install.


Each time your current HEAD changes, hookup checks to see if any migrations have been added, deleted, or modified. Deleted and modified migrations are given the rake db:migrate:down treatment, then rake db:migrate is invoked to bring everything else up to date.

Hookup provides a -C option to change to a specified directory prior to running bundle or rake. This should be used if your Gemfile and Rakefile are in a non-standard location.

To use a non-standard db directory (where schema.rb and migrate/ live), add --schema-dir="database/path" to the hookup post-checkout line in .git/hooks/post-checkout.

To force reloading the database if migrating fails, add --load-schema="rake db:reset" to the hookup post-checkout line in .git/hooks/post-checkout.

Schema Resolving

Each time there's a conflict in db/schema.rb on the Rails::Schema.define line, hookup resolves it in favor of the newer of the two versions.

Skip Hookup

Set the SKIP_HOOKUP environment variable to skip hookup.

SKIP_HOOKUP=1 git checkout master

Removing Hookup

hookup remove


See it on the wiki


Copyright (c) Tim Pope. MIT License.