man pages section 1: User Commands

Exit Print View

Updated: July 2014

gitk (1)


gitk - The git repository browser


gitk [<option>...] [<revs>] [--] [<path>...]


Git Manual                                                GITK(1)

     gitk - The git repository browser

     gitk [<option>...] [<revs>] [--] [<path>...]

     Displays changes in a repository or a selected set of
     commits. This includes visualizing the commit graph, showing
     information related to each commit, and the files in the
     trees of each revision.

     Historically, gitk was the first repository browser. It's
     written in tcl/tk and started off in a separate repository
     but was later merged into the main git repository.

     To control which revisions to show, the command takes
     options applicable to the git rev-list command (see git-rev-
     list(1)). This manual page describes only the most
     frequently used options.

     -n <number>, --max-count=<number>
         Limits the number of commits to show.

         Show commits more recent than a specific date.

         Show commits older than a specific date.

         Show all branches.

         After an attempt to merge stops with conflicts, show the
         commits on the history between two branches (i.e. the
         HEAD and the MERGE_HEAD) that modify the conflicted
         files and do not exist on all the heads being merged.

         Command to be run each time gitk has to determine the
         list of <revs> to show. The command is expected to print
         on its standard output a list of additional revs to be
         shown, one per line. Use this instead of explicitly
         specifying <revs> if the set of commits to show may vary
         between refreshes.

         Automatically select the specified commit after loading
         the graph. Default behavior is equivalent to specifying

Git          Last change: 02/22/2012                    1

Git Manual                                                GITK(1)


         Limit the revisions to show. This can be either a single
         revision meaning show from the given revision and back,
         or it can be a range in the form "<from>..<to>" to show
         all revisions between <from> and back to <to>. Note,
         more advanced revision selection can be applied. For a
         more complete list of ways to spell object names, see

         Limit commits to the ones touching files in the given
         paths. Note, to avoid ambiguity with respect to revision
         names use "--" to separate the paths from any preceding

     gitk v2.6.12.. include/scsi drivers/scsi
         Show the changes since version v2.6.12 that changed any
         file in the include/scsi or drivers/scsi subdirectories

     gitk --since="2 weeks ago" -- gitk
         Show the changes during the last two weeks to the file
         gitk. The "--" is necessary to avoid confusion with the
         branch named gitk

     gitk --max-count=100 --all -- Makefile
         Show at most 100 changes made to the file Makefile.
         Instead of only looking for changes in the current
         branch look in all branches.

     Gitk creates the .gitk file in your $HOME directory to store
     preferences such as display options, font, and colors.

     See attributes(5) for descriptions of the following

     |Availability   | developer/versioning/git |
     |Stability      | Uncommitted              |
         A repository browser written in C++ using Qt.

Git          Last change: 02/22/2012                    2

Git Manual                                                GITK(1)

         A repository browser written in Python using Gtk. It's
         based on bzrk(1) and distributed in the contrib area of
         the git repository.

         A minimal repository browser and git tool output
         highlighter written in C using Ncurses.

     Part of the git(1) suite

     This software was built from source available at  The original
     community source was downloaded from  http://git-

     Further information about this software can be found on the
     open source community website at

Git          Last change: 02/22/2012                    3