roast helps you group and manage entries in your hosts file
Switch branches/tags
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.

Roast Build Status

Roast helps you manage entries in your /etc/hosts file. Roast allows you to group entries together in a named group and disable/enable them all at once. It's pretty useful if you work with a lot of entries in your hosts file and find it annoying to constantly be enabled/editing your hosts file manually.


$ gem install roast


Roast has a decent set of commands available:

list                list the entries in the hosts file          alias: l
add                 adds a new entry to the hosts file          alias: a
enable              enables a disabled (commented out) entry    alias: e
enable-group        enables an entire group                     alias: eg
disable             disables an entry (comments it out)         alias: d
disable-group       disables an entire group                    alias: dg
delete              deletes an entry entirely
delete-group        deletes an enitre group

a few of the commands have aliases, they are listed to the right


A few examples of using roast to manage your /etc/hosts file:

# list all entires
$ roast list

# add an entry to the base group
$ sudo roast add

# add an entry to the "testing" group
$ sudo roast add testing

# add an entry to the "testing" group via another hostname (resolve the ip)
$ sudo roast add testing

# disable all entries with the ip ""
$ sudo roast disable

# delete an entry entirely
$ sudo roast delete

notice that you can list entries without sudo, but editing the hosts file does require sudo


  1. Fork it
  2. Create your feature branch (git checkout -b my-new-feature)
  3. Commit your changes (git commit -am 'Add some feature')
  4. Push to the branch (git push origin my-new-feature)
  5. Create new Pull Request