SYNOPSIS
git cola [options]
DESCRIPTION
git-cola is a powerful git GUI written in Python. It has many unique features that make git’s advanced features simple and accessible.
See below for a full list of options and usage information.
OPTIONS
- --classic
-
Launch the standalone cola classic tool.
- -r
- --repo=<path>
-
Run git-cola on the git repository in <path>. Defaults to the current directory.
- -s
- --style=<style>
-
Launch git-cola with a different stylesheet.
- -v
- --version
-
Prints the git-cola version and exits.
- -g
- --git-path
-
Specifies the path to the git binary.
GUI STYLES
git-cola ships with an alternate "dark" stylesheet. Specify --style=dark or provide an external stylesheet with --style=PATH.
CONFIG VARIABLES
- cola.savewindowsettings
-
Whether git-cola should remember its window settings.
- cola.fontdiff
-
Specifies the font to use for git-cola's diff display.
- gui.diffcontext
-
The number of diff context lines used and displayed by git-cola
- gui.editor
-
The default text editor is controlled by gui.editor. The config variable overrides the EDITOR environment variable.
- gui.historybrowser
-
Specifies the history browser to use when visualizing history.
- diff.tool
-
The default diff tool to use.
- merge.tool
-
The default merge tool to use.
- user.email
-
Your email address to be recorded in any newly created commits. Can be overridden by the GIT_AUTHOR_EMAIL, GIT_COMMITTER_EMAIL, and EMAIL environment variables. See linkgit:git-commit-tree[1].
- user.name
-
Your full name to be recorded in any newly created commits. Can be overridden by the GIT_AUTHOR_NAME and GIT_COMMITTER_NAME environment variables. See linkgit:git-commit-tree[1].
See linkgit:git-config[1] for more details.
ENVIRONMENT VARIABLES
- EDITOR
-
Specifies the default editor to use. This is ignored when the git config variable gui.editor is defined.
- GIT_PYTHON_TRACE
-
When defined, prints git commands and status to the terminal. Print more information when set to the value full.
- GIT_COLA_TRACE
-
When defined, git-cola outputs the git commands it executes into the Command Output log viewer.
SOURCE
A git-cola development repository can be obtained via git:
git clone git://github.com/davvid/git-cola.git
GUI THEMES
git-cola ships with an alternative stylesheet called dark. You can use this stylesheet by running git cola --style=dark.
You can also skin git-cola by providing your own Qt stylesheet. E.g. git cola --style=/path/to/style.qss.
Built-in styles can be found in /usr/share/git-cola/styles.
LINKS
- git-cola homepage
- git-cola sources on github
SEE ALSO
- linkgit:git-difftool[1]
-
Compare changes using common merge tools.
- linkgit:gitk[1]
-
The git repository browser. Shows branches, commit history and file differences. gitk is the utility started by git-cola's Repository Visualize actions.
GIT
git-cola is independently developed from the linkgit:git[7] suite, but you can use it just like any other git command, e.g. git cola.
AUTHOR
Written by David Aguilar <davvid@gmail.com>.