# Git Status

> A command that shows which files changed, which are staged and which are new.

**Field:** Software Development  
**Category:** Version Control  
**Also known as:** git status, Git Status Command

## Think of it like

Think of it like looking at your desk before you leave. You see what is done, what is half done and what is new.

## Definition

Git status shows the state of your files right now. It lists files you changed but did not stage. It lists files that are staged and ready to commit. It also lists new files Git is not tracking yet. It changes nothing, so you can run it as often as you like.

## Example

Before each commit, Lucy runs git status. She spots a notes file she did not mean to add.

## Example code

```console
$ git status --short
M  index.html
 M style.css
?? notes.txt
```

index.html is staged, style.css changed but is not staged, and notes.txt is new.

## Why it matters

It stops surprises. You see exactly what your next commit will hold.

## Common mistake

Committing without looking first. Secret files and junk slip in this way.

## Three principles

- **Read only.** It never changes anything.
- **Three lists.** Staged, not staged and untracked.
- **Run it often.** Check before each commit.

## Related terms

- [Staging Area](https://learn.benibix.com/term/development/staging-area)
- [Working Directory](https://learn.benibix.com/term/development/working-directory)
- [Commit](https://learn.benibix.com/term/development/commit)
- [Diff](https://learn.benibix.com/term/development/diff)
- [.gitignore](https://learn.benibix.com/term/development/gitignore)

## Taught in

- [Git Add and Commit](https://learn.benibix.com/learn/development-version-control/git-add-and-commit): Git and GitHub, 2/13

![Three columns from left to right: working directory, staging area and last commit. A file called style.css sits in the working directory, marked changed but not staged. A file called index.html sits in the staging area, marked ready to commit. A file called notes.txt sits in the working directory, marked untracked. Above them, git status reads out all three.](https://learn.benibix.com/diagrams/dev3-git-status.svg)

---

Source: https://learn.benibix.com/term/development/git-status
Author: Behnia Zarei (a developer in Vienna, Austria, who builds and teaches data, AI and business intelligence at BENIBIX)
Publisher: BENIBIX Learn (https://learn.benibix.com/)
Last updated: 2026-11-17
Licence: CC BY 4.0 (https://creativecommons.org/licenses/by/4.0/). Quote freely with attribution.
