# Working Directory

> The project files you see and change right now. Git has not saved them yet.

**Field:** Software Development  
**Category:** Version Control  
**Also known as:** Working Tree, Working Copy

## Think of it like

Think of it like your desk. The papers on it are the ones you are working on right now.

## Definition

The working directory is the set of files you see and edit in your project folder. It is where you type, save and test your changes. Git compares it with the last commit to see what you have changed. Changes here are not part of the history until you stage and commit them. The git status command shows what is different.

## Example

Jack edits index.html and saves it. The change is in his working directory, but Git has not recorded it yet.

## Example code

```console
$ git status --short
?? index.html
```

The ?? means Git sees a new file it is not tracking yet.

## Why it matters

What is only here is what you could still lose. So check it before you shut down.

## Common mistake

Thinking a saved file is safe in Git. Saving in the editor is not a commit.

## Three principles

- **What you edit.** The files open in your editor.
- **Not yet history.** Changes here are not recorded.
- **Check with status.** git status shows what changed.

## Related terms

- [Staging Area](https://learn.benibix.com/term/development/staging-area)
- [Commit](https://learn.benibix.com/term/development/commit)
- [Repository](https://learn.benibix.com/term/development/repository)
- [Diff](https://learn.benibix.com/term/development/diff)

## Taught in

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

---

Source: https://learn.benibix.com/term/development/working-directory
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.
