How to Programmatically Determine if there are Uncommitted Changes in Git

Sometimes, it is necessary to get the uncommitted changes of the working directory inside a script. The git status command outputs too much information that may not be necessary. Hence, the aim of this article is to check whether there are uncommitted changes or not.

Watch a video course Git & GitHub - The Practical Guide

Discovering uncommitted changes

In this section, we will show you how to discover the uncommitted changes of your working directory. Below, we consider several handy ways to do that.

Using the git diff-index command

You can get your uncommitted changes with the git diff-index command in the following way:

git diff-index HEAD --

The git diff-index HEAD command will fail on a branch without commits such as a newly created repository.

Here is a small example of a bash script that determines whether there are uncommitted changes or not.

  set -e
  echo -n "Checking if there are uncommited changes... "
  trap 'echo -e "\033[0;31mCHANGED\033[0m"' ERR
  git diff-index --quiet HEAD --
  trap - ERR
  echo -e "\033[0;32mUNCHANGED\033[0m"

Using the git status command

Also, you can use the git status command with the --porcelain option to get a clearer output:

git status --porcelain

The --porcelain flag gives the output in an easy-to-parse format for scripts, which is similar to the short output. However, it will remain stable across Git versions regardless of user configuration.

Using the git diff command

Also, you can use the git diff command with the --name-only attribute to list the changed files:

git diff --name-only

The git diff-index Command

The git diff-index command is used for comparing the content mode of the blobs, detected inside a tree object with the matching tracked files within the working tree, or with the matching paths inside the index. In the case of the presence of the <paths> arguments, only the paths matching the patterns are compared. In other scenarios, all the tracked files are compared.

The git status Command

The git status command is used for demonstrating the state of the working directory and the staging area. It allows viewing the staged changes and the files that aren’t being tracked by Git. The Status output does not display any information about the committed project history. For this purpose, it is recommended to use the git log command. The git status command simply shows what has been going on with git add and git commit commands.

The git diff Command

The git diff is a multi-function Git command, which is used for comparing the committed changes. With the help of this command, you can take two input data sets and output the modifications between them. While executing, this command runs a diff function on Git data source. Commonly, it is used in combination with git status and git log commands to analyze the state of a git repository.