In Git, adding is used to add changes from the working tree to the staging area. This is where changes are saved for the next commit. When the file name appears in green, it indicates that the file is tracked and will be staged for the next commit.


Below is a short example of how the git add command works. Assuming a change was saved in a message.txt text file, running git status will show this:

$ git status
On branch main
No commits yet
Untracked files:
(use "git add <file>..." to include in what will be committed)
nothing added to commit but untracked files present (use "git add" to track)

Since the file is untracked, git add can be used to stage it for the next commit. Afterwards, running git status again should yield the following:

$ git add message.txt
$ git status
On branch main
No commits yet
Changes to be committed:
(use "git rm --cached <file>..." to unstage)
new file: message.txt

The file now appears in green when running git status, indicating that it is staged and will be saved with the next commit.

There are many extensions to the git add command such as:

  • -n: Where the file will not be added to the staging area but will show whether or not the file exists and/or if it will be ignored.
  • -f: Which stages all files including those which are ignored.
  • . : Which stages all the files in the current directory. On the command line, it references the current directory.
  • -A: Which stages all the files in the current directory as well as subdirectories.


Interested in helping build Docs? Read the Contribution Guide or share your thoughts in this feedback form.

Learn Git on Codecademy