Skip to content
Automate the bundle/migration tedium of Rails with Git hooks
Find file
Latest commit 09bd799 @tpope Merge pull request #33 from bostrom/bundle-exec
Add bundle exec to commands if Bundler is used
Failed to load latest commit information.
bin hookup 1.0.0
lib Add bundle exec to commands if Bundler is used
.gitignore hookup 1.0.0
Gemfile hookup 1.0.0
MIT-LICENSE Add license
README.markdown Update README.markdown
Rakefile hookup 1.0.0
hookup.gemspec hookup 1.2.4



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


See it on the wiki


Copyright (c) Tim Pope. MIT License.

Something went wrong with that request. Please try again.