GitBot

From Git SCM Wiki
Revision as of 21:41, 16 August 2008 by (Talk)

(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to: navigation, search

GitBot is the bot used in the #git IRC channel on freenode. It's source is also kept in Git and can be found on GitHub.

GitBot is maintained by Pieter de Bie. You can email Pieter at frimmirf@gmail.com. Questions can also be directed to 'Pieter' on freenode.


GitBot allows you to scan Git repositories for objects mentioned in an IRC channel. This is useful for referring to a specific commit or file, which can then be viewed online using the link GitBot provides. Currently, only Gitweb and local repositories are supported. As soon as GitHub has a suitable API, support for GitHub will also be added.


GitBot works by through a list of provided Git repositories. It can scan this list every time an object is mentioned.

GitBot can be invoked implicitly by supplying a sha1 of an object, at least 7 characters long. If GitBot finds such a phrase, it tries to look up the object on all the supplied Git repositories. If it find one, it creates a tinyurl and returns this in the IRC channel.

GitBot can also be invoked implicitly. The syntax is the following:

   <[Repo] RefPath>

Where Repo and Ref are optional. This means that you can refer to the master branch by using '<master>' in the IRC channel. Similarly, <HEAD:Documentation/githooks.txt> will supply a link to the newest githooks.txt file.

Using the Repo part, you can specify which repository to look in. For example, you can look up the README of egit: <egit HEAD:README>. You can also use URL-like strings to specify repositories that are not in the supplied repository list, for example:

   <repo:glibc.git HEAD:README>

will look up the README on the main branch in the glibc.git repository on repo.or.cz


Personal tools