status

Display a summary of the current git shadow state for the active branch pair. Works from either a shadow or a public branch.

Usage

git shadow status [--json]

Example output

Git Shadow Status

🧠 Current branch : feature/login@local
   Branch type    : shadow
   Public branch  : feature/login

   Publishable commits pending : 3
   Shadow-only [MEMORY] commits: 1
   Public branch ahead         : no

✅ Status    : ready to publish
   Next step : run `git shadow feature publish`

Status labels

StatusMeaning
up to dateShadow and public branches are in sync
ready to publishCommits in @local not yet on the public branch
public branch aheadPublic branch has commits not in @local
divergedBoth branches have commits the other doesn’t
shadow branch missingNo @local counterpart found
public branch missingNo public counterpart found

JSON output

Pass --json for machine-readable output:

git shadow status --json
{
  "current_branch": "feature/login@local",
  "branch_type": "shadow",
  "shadow_branch": "feature/login@local",
  "public_branch": "feature/login",
  "publishable_count": 3,
  "memory_count": 1,
  "public_ahead": 0,
  "status": "ready to publish",
  "next_step": "run `git shadow feature publish`"
}
  • feature publish — publish pending commits to the public branch
  • commit — create a new commit on the shadow branch