Skip to content
This repository

Quickly freeze and unfreeze external git dependencies

branch: master

Fetching latest commit…


Cannot retrieve the latest commit at this time

Octocat-spinner-32 bin
Octocat-spinner-32 lib
Octocat-spinner-32 spec
Octocat-spinner-32 MIT-LICENSE
Octocat-spinner-32 README.markdown
Octocat-spinner-32 Rakefile
Octocat-spinner-32 externals.gemspec


Quickly freeze and unfreeze external git dependencies.


Tested with Ruby 1.8.6, 1.8.7, and 1.9.1.


sudo gem install externals --source


Create config/externals.yml:

  repo: git://
  path: vendor/plugins
  repo: git://
  path: vendor

Freeze or unfreeze

You can run either of these for the first time, depending on what you want:

externals freeze
externals unfreeze

If you only want to freeze one of the items in config/externals.yml

externals freeze acts_as_archive
externals unfreeze acts_as_archive

The usual flow is to unfreeze, commit to the external, freeze, and commit to the parent project.

Your .git directories will be zipped and stored in /tmp when frozen, and moved back to the external when unfrozen.

Are my externals frozen?

When you want to know the status of your externals:

externals status
Something went wrong with that request. Please try again.