Foghub is the bridge between Github and Fogbugz
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.


Foghub associates Git commits with Fogbugz cases and code reviews.

Foghub is known to run on MRI Ruby 1.9.2.

The code is under development.

Why do code reviews?

Simply read this blogpost.


Foghub is a Sinatra application that can receive, and parse, the data given by Github's service hooks.

Clone this repository, and edit config.yml to include your Fogbugz credentials and user aliases.

Aliases are aliases you can use in your commits to assign cases to other users, e.g. @user. However, for aliases to work you need to specify what aliases goes to what Fogbugz user IDs, this is done in config.yml. You can get a list of user IDs by running ruby scripts/users.rb once the Fogbugz credentials are in place.

Deploy Foghub with your configuration file, and set your Github repository's post-recieve URL service hook to:

Each time a commit hits your Github repo, Foghub should take care of getting your commits into Fogbugz.

Feature plans

Associate commit with case:

git commit -am "This is a commit #65"

This will post a comment to case 65 on Fogbugz with the commit message that references the Git commit on Github.

Request Fogbugz code review:

git commit -am "This is a commit that needs review #review @user"

Creates a new code review in Fogbugz and assigns it to @user. If you do not specify a reviewer, Foghub will simply create an unassigned code review.

Request code review and associate with case:

git commit -am "This commit to case #65 needs #review by @user"

Will create a new code review in Fogbugz and assign it to the user specified in the commit message. Additionally, the commit message will be attached to case 65 in Fogbugz.

Commits can be associated with multiple Fogbugz cases:

git commit -am "This commit is closing case #65 and #66"

Creates a Fogbugz comment with the commit message in case 65 and 66 linking to the commit on Github.


Copyright (c) 2011 Firmafon ApS. This project is licensed under the MIT license, see LICENSE for details.