git status Tutorial

The short version

git status is the safest and most useful command for checking what is going on in your repository right now.

What it tells you

• current branch
• staged changes
• unstaged changes
• untracked files
• ahead / behind state relative to the upstream branch

Common forms

git status
git status --short

What problem this command solves in a workflow

In the workflow, git status is mostly a “inspect first, decide second” command. It usually does not rewrite history by itself; instead, it helps you confirm the current state of the working tree, index, refs, or commit objects.

Typical use cases

• Use git status before changing files or history so you have observable evidence first.
• Put git status into review, debugging, and incident-analysis flow so the team can align on the same context.
• When you need to explain why the repository looks the way it does, let git status surface verifiable information first.

Diagram view

Observed layers

Working treeIndexCommit historyRefs

→git status

Outputs

Console outputDiff contextDecision signal

If the output looks wrong, the first thing to question is usually the scope you inspected, not whether the command “worked”.

Special cases and boundaries

• Most inspection commands do not mutate history, but their output still depends on which HEAD, path, range, or ref you asked them to inspect.
• If git status shows something unexpected, first verify whether you are looking at the working tree, the index, the current branch, or a historical commit.
• Combining git status with git status, git log, and git show is usually safer than trusting a single output in isolation.