Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
GIT-GUI(1)			   Git Manual			      GIT-GUI(1)

NAME
     git-gui - A portable graphical interface to Git

SYNOPSIS
     git gui [<command>] [<arguments>]

DESCRIPTION
     A Tcl/Tk based graphical user interface to Git. git gui focuses on allowing
     users  to	make changes to their repository by making new commits, amending
     existing ones, creating  branches,  performing  local  merges,  and  fetch-
     ing/pushing to remote repositories.

     Unlike  gitk,  git gui focuses on commit generation and single file annota-
     tion and does not show project history. It does however supply menu actions
     to start a gitk session from within git gui.

     git gui is known to work on all popular UNIX systems, Mac OS X, and Windows
     (under both Cygwin and MSYS). To the extent possible OS specific  user  in-
     terface  guidelines  are followed, making git gui a fairly native interface
     for users.

COMMANDS
     blame
	 Start a blame viewer on the specified file on	the  given  version  (or
	 working directory if not specified).

     browser
	 Start	a  tree browser showing all files in the specified commit. Files
	 selected through the browser are opened in the blame viewer.

     citool
	 Start git gui and arrange to make exactly one commit before exiting and
	 returning to the shell. The interface is limited  to  only  commit  ac-
	 tions, slightly reducing the application's startup time and simplifying
	 the menubar.

     version
	 Display the currently running version of git gui.

EXAMPLES
     git gui blame Makefile
	 Show  the  contents  of the file Makefile in the current working direc-
	 tory, and provide annotations for both  the  original	author	of  each
	 line,	and  who moved the line to its current location. The uncommitted
	 file is annotated, and uncommitted changes (if any) are explicitly  at-
	 tributed to Not Yet Committed.

     git gui blame v0.99.8 Makefile
	 Show  the  contents of Makefile in revision v0.99.8 and provide annota-
	 tions for each line. Unlike the above example the file is read from the
	 object database and not the working directory.

     git gui blame --line=100 Makefile
	 Loads annotations as described above and automatically scrolls the view
	 to center on line 100.

     git gui citool
	 Make one commit and return to the shell when it is complete. This  com-
	 mand  returns	a non-zero exit code if the window was closed in any way
	 other than by making a commit.

     git gui citool --amend
	 Automatically enter the Amend Last Commit mode of the interface.

     git gui citool --nocommit
	 Behave as normal citool, but instead of making a commit  simply  termi-
	 nate  with  a	zero  exit code. It still checks that the index does not
	 contain any unmerged entries, so you can use it as  a	GUI  version  of
	 git-mergetool(1)

     git citool
	 Same as git gui citool (above).

     git gui browser maint
	 Show  a browser for the tree of the maint branch. Files selected in the
	 browser can be viewed with the internal blame viewer.

SEE ALSO
     gitk(1)
	 The Git repository browser. Shows branches,  commit  history  and  file
	 differences.  gitk is the utility started by git gui's Repository Visu-
	 alize actions.

OTHER
     git gui is actually maintained as an independent project, but  stable  ver-
     sions  are  distributed as part of the Git suite for the convenience of end
     users.

     The official repository of the git gui project can be found at:

	 https://github.com/j6t/git-gui

GIT
     Part of the git(1) suite

Git 2.54.0			   2026-04-19			      GIT-GUI(1)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=git-gui&sektion=1&manpath=FreeBSD+Ports+15.1.quarterly>

home | help