status

See which repositories are clean, changed, ahead, or behind.

Usagegit-wrangler status [options]

Quick start

git-wrangler status

What it does

status gives you a compact workspace overview. It shows uncommitted changes and whether each branch has commits to push or updates to pull.

It refreshes origin first. Use --no-fetch when offline or when you intentionally want to use existing local information.

Reading the result

  • dirty means the repository has uncommitted or untracked files.
  • ahead N means there are N local commits to push.
  • behind N means there are N remote commits to pull.
  • no remote means the current branch is not connected to a remote branch.

Options

Option Default What it does
--repo <path> Whole workspace Check exactly one repository.
--no-fetch Off Skip refreshing origin; ahead/behind counts may be old.
--json Off Return machine-readable status information.
--guided Off Choose options through prompts; cannot be used with JSON.

More examples

# Check one repository
git-wrangler status --repo ./api

# Work offline
git-wrangler status --no-fetch

# Save machine-readable output
git-wrangler status --json > status.json
  • Use pull to update repositories that are behind.
  • Use review to inspect committed work before pushing.
  • Use info for a detailed inventory.