A set of PowerShell scripts which provide Git/PowerShell integration
The prompt within Git repositories can show the current branch and the state of files (additions, modifications, deletions) within.
Provides tab completion for common commands when using git.
E.g. git ch<tab>
--> git checkout
See profile.example.ps1
as to how you can integrate the tab completion and/or git prompt into your own profile.
Prompt formatting, among other things, can be customized using $GitPromptSettings
, $GitTabSettings
and $TortoiseGitSettings
.
Note on performance: displaying file status in the git prompt for a very large repo can be prohibitively slow. Rather than turn off file status entirely, you can disable it on a repo-by-repo basis by adding individual repository paths to $GitPromptSettings.RepositoriesInWhichToDisableFileStatus.
If you have PsGet installed just run:
Install-Module posh-git
Pre-requisites:
-
Verify you have PowerShell 2.0 or better with
$PSVersionTable.PSVersion
. PowerShell 3.0 is preferred as 2.0 support is deprecated. -
Verify execution of scripts is allowed with
Get-ExecutionPolicy
(should beRemoteSigned
orUnrestricted
). If scripts are not enabled, run PowerShell as Administrator and callSet-ExecutionPolicy RemoteSigned -Scope CurrentUser -Confirm
. -
Verify that
git
can be run from PowerShell. If the command is not found, you will need to add a git alias or add%ProgramFiles(x86)%\Git\cmd
(or%ProgramFiles%\Git\cmd
if you're still on 32-bit) to yourPATH
environment variable.
Then do this:
git clone https://github.com/dahlbyk/posh-git.git
cd posh-git
.\install.ps1
. $PROFILE
And you're set!
PowerShell generates its prompt by executing a prompt
function, if one exists. posh-git defines such a function in profile.example.ps1
that outputs the current working directory followed by an abbreviated git status
:
C:\Users\Keith [master ≡]>
By default, the status summary has the following format:
[{HEAD-name} S +A ~B -C !D | +E ~F -G !H W]
[
(BeforeText
){HEAD-name}
is the current branch, or the SHA of a detached HEAD- Cyan means the branch matches its remote
- Green means the branch is ahead of its remote (green light to push)
- Red means the branch is behind its remote
- Yellow means the branch is both ahead of and behind its remote
- S represents the branch status in relation to remote (tracked origin) branch
- ≡ = The local branch in at the same commit level as the remote branch (
BranchIdenticalStatus
) - ↑ = The local branch is ahead of the remote branch, a 'git push' is required to update the remote branch (
BranchAheadStatus
) - ↓ = The local branch is behind the remote branch, a 'git pull' is required to update the local branch (
BranchBehindStatus
) - ↕ = The local branch is both ahead and behind the remote branch, a rebase of the local branch is required before pushing local changes to the remote branch (
BranchBehindAndAheadStatus
)
- ≡ = The local branch in at the same commit level as the remote branch (
- ABCD represent the index;
|
(DelimText
); EFGH represent the working directory +
= Added files~
= Modified files-
= Removed files!
= Conflicted files- As in
git status
, index status is dark green and working directory status is dark red - W represents the status of the working folder
!
= There are untracked changes in the working tree (LocalStagedStatus
)~
= There are staged changes in the working tree waiting to be committed (LocalWorkingStatus
)- None = There are no uncommitted or unstaged changes to the working tree (
LocalDefault
) ]
(AfterText
)
The symbols and surrounding text can be customized by the corresponding properties on $GitPromptSettings
.
For example, a status of [master ≡ +0 ~2 -1 | +1 ~1 -0]
corresponds to the following git status
:
# On branch master
#
# Changes to be committed:
# (use "git reset HEAD <file>..." to unstage)
#
# modified: this-changed.txt
# modified: this-too.txt
# deleted: gone.ps1
#
# Changed but not updated:
# (use "git add <file>..." to update what will be committed)
# (use "git checkout -- <file>..." to discard changes in working directory)
#
# modified: not-staged.ps1
#
# Untracked files:
# (use "git add <file>..." to include in what will be committed)
#
# new.file
- Keith Dahlby, http://solutionizing.net/
- Mark Embling, http://www.markembling.info/
- Jeremy Skinner, http://www.jeremyskinner.co.uk/