Git Integration

Added in:3.2

Sublime Text’s Git integration includes the following components:

Please note: the following documentation discusses the implementation of the Git integration as seen with the Default and Adaptive themes that are included with Sublime Text. Via the theme engine, it is possible for third-party themes to change the visual presentation of information, in which case the following documentation may not be accurate.

Status Bar🔗

When the focussed file us containing within the working directory of a Git repository, the status bar will contain the name of the current branch, along with the number of files that are untracked, modified, staged or unmerged. The status bar element will look like:

master 3

Diff Markers🔗

Sublime Text’s incremental_diff functionality ties in with the Git integration. By default, the incremental diff functionality tracks changes to the file since it was last saved, but it is also possible to diff against HEAD.

Here is an example of what the diff markers look like in action, using the Mariana color scheme:

28 A line that was added
30 A modified line
31 followed by another modified line
33 The line before this was deleted

Changing the setting git_diff_target to "head" will modify the diff markers to display a diff versus the version of the file at the Git repository HEAD, as opposed to the version of the file in the working directory.

See the incremental_diff documentation for more information and examples, including instructions for viewing inline diffs, navigating between hunks and reverting changes.

Sublime Merge Integration🔗

The Git features available in Sublime Text were derived from work that went into our other product, Sublime Merge. Sublime Merge is a full-featured, blazing-fast Git client built upon the technologies from Sublime Text.

Since editing source code and prose requires different tools and workflows than managing a Git repository, we opted to integrate the most appropriate Git functionality into Sublime Text, but leave more advanced features in Sublime Merge. The following integration points make it easy to jump into the appropriate Git context:

Editor Context Menu🔗

  • Open Git Repository…

  • File History…

  • Line History…

  • Blame File…

Command Palette🔗

  • Sublime Merge: Open Repository

  • Sublime Merge: Folder History

  • Sublime Merge: File History

  • Sublime Merge: Blame File


"show_git_status" boolean🔗

Enables Git integration.

Default: true

"git_diff_target" string🔗

Controls the behavior of incremental diff for files in a Git repository. Valid values include:

  • "index" – diff against the Git index

  • "head" – diff against the file at HEAD

Default: "index"