---
name: "git-lfs-status"
section: "1"
platform: "linux"
package: "git-lfs"
version: "3.8.1-1"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/git-lfs-status"
---

# git-lfs-status(1)

Show the status of Git LFS files in the working tree

## NAME

git-lfs-status - Show the status of Git LFS files in the working tree

## SYNOPSIS

```
git lfs status [<options>]
```

## DESCRIPTION

Display paths of Git LFS objects that

• have not been pushed to the Git LFS server. These are large files that would be uploaded by `git push`.

• have differences between the index file and the current HEAD commit. These are large files that would be committed by `git commit`.

• have differences between the working tree and the index file. These are files that could be staged using `git add`.

This command must be run in a non-bare repository.

## OPTIONS

- `-p`, `--porcelain`

  Give the output in an easy-to-parse format for scripts.

- `-j`, `--json`

  Writes Git LFS file status information as JSON to STDOUT, if the command exits successfully. Intended for interoperation with external tools. If `--porcelain` is also provided, that option takes precedence.

## SEE ALSO

[git-lfs-ls-files(1)](/git-lfs-ls-files/1.md).

Part of the [git-lfs(1)](/git-lfs/1.md) suite.