macOS
brew install git-format-stagedlocal Homebrew formula metadata
brew
Git command to transform staged files using a formatting command. Version 4.0.1 via Homebrew; verified from local package data.
install
brew install git-format-stagedlocal Homebrew formula metadata
overview
Git command to transform staged files using a formatting command
history
git-format-staged is a Python Git helper that runs a formatter or linter against the staged version of files, preserving unstaged working-tree edits.
The repository began in March 2018. Its README explains the project as a response to pre-commit formatting hooks that run a formatter over working-tree files and then restage the result, a pattern that can accidentally commit unrelated unstaged edits or disrupt `git add -p` workflows.
git-format-staged sits in the ecosystem around Prettier, Husky, lint-staged, pre-commit, pretty-quick, and language-specific hook managers. It distinguishes itself by formatting blobs from the Git index and then attempting to patch the working tree afterward, rather than stashing user edits before formatting.
Practitioners install it through Nix, npm, Homebrew, or by copying the script, then call it from pre-commit hooks with a formatter command that reads from stdin and writes to stdout. Typical use passes file patterns and a formatter placeholder, such as running Prettier with `--stdin-filepath` for staged JavaScript, TypeScript, or CSS files.
The package is notable because it solves a small but sharp Git-index problem without tying users to one language ecosystem. That makes it attractive for polyglot repositories and hook setups where the important boundary is Git's staged content rather than a particular formatter.
security posture
narrow executable package without higher-risk signals.
green risk · low confidence · appliance
Before unattended agent use, check whether the tool reads plaintext credentials, writes remote state, publishes artifacts, or shells out to plugins.
executables
| Command | Kind | Exposure | Note |
|---|---|---|---|
git-format-staged | cli | global executable |
freshness
These signals separate page generation age, package-manager activity, and upstream release comparison. Version lag is warned only when an evidence URL and comparable versions are present.
https://github.com/hallettj/git-format-staged
install metadata
| Package key | brew:git-format-staged |
|---|---|
| Version | 4.0.1 |
| Package manager | Homebrew |
| Package manager page | https://formulae.brew.sh/formula/git-format-staged |
| Homepage | https://github.com/hallettj/git-format-staged |
| Repository | https://github.com/hallettj/git-format-staged |
| Upstream docs | https://github.com/hallettj/git-format-staged#readme |
| License | MIT |
| Source archive | https://github.com/hallettj/git-format-staged/archive/refs/tags/v4.0.1.tar.gz |
| Uses from macOS | python |
| Bottle | available (on all) |
| Homebrew post-install | not defined |
| Service | none declared |
registry facts
| Source Database | Homebrew formula API |
|---|---|
| Tap | homebrew/core |
| Full Name | git-format-staged |
| Version Scheme | 0 |
| Revision | 0 |
| Head Version | HEAD |
| Bottle Stable Root URL | https://ghcr.io/v2/homebrew/core |
| Deprecated | no |
| Disabled | no |
| Keg Only | no |
| URL Keys |
|
source trail
This page is generated by av-web from the private package SQLite artifact built by scripts/generate-pkg-sqlite.py.
View the package source record on GitHub.