SYNOPSIS

git cola [options] [sub-command]

DESCRIPTION

git-cola is a sleek and powerful git GUI written in Python. See below for a full list of options and usage information.

OPTIONS

-g
--git-path

Specifies the path to the git binary.

--prompt

Prompt for a git repository instead of using the current directory.

-r
--repo=<path>

Run git-cola on the git repository in <path>. Defaults to the current directory.

-v
--version

Print the git-cola version and exit.

SUB-COMMANDS

branch

Create branches.

browse

Browse tracked files.

config

Configure git-cola settings.

fetch

Fetch remote branches.

grep

Use git grep to search for content.

pull

Fetch and merge remote branches.

push

Push branches to remotes.

search

Search for commits.

stash

Stash modifications.

tag

Create tags.

CONFIG VARIABLES

cola.savewindowsettings

Whether git-cola should remember its window settings.

cola.fileattributes

Enables per-file linkgit:gitattributes[5] encoding support when set to true. This tells git-cola to honor the configured encoding when displaying and applying diffs.

cola.fontdiff

Specifies the font to use for git-cola's diff display.

cola.browserdockable

Whether to create a dock widget with the Browser tool. Defaults to false to speedup startup time.

cola.tabwidth

The number of columns occupied by a tab character.

cola.linebreak

Whether to automatically break long lines while editing commit messages. Defaults to true. This setting is configured using the Preferences dialog, but it can be toggled for one-off usage using the commit message editor’s settings sub-menu.

cola.textwidth

The number of columns used for line wrapping. Tabs are counted according to cola.tabwidth.

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_COLA_TRACE

When defined, git-cola logs git commands to stdout. When set to full, git-cola also logs the exit status and output. When set to trace, git-cola logs to the Console widget.

SOURCE

A git-cola development repository can be obtained via git:

git clone git://github.com/git-cola/git-cola.git

LINKS

git-cola homepage

http://git-cola.github.com/

git-cola sources on github

https://github.com/git-cola/git-cola/

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>.