Here is a concise overview of the key branch decorator cases now implemented:
- The "Family" Case (Ownership)
Local branches act as "heads," automatically grouping all tracked remotes AND same-named sibling remotes into a single pill.
- Format: [ 💻 H ⇌ ☁️ origin | ≠ gitlab ]
- Logic: H tracks origin/H, while gitlab/H is just a sibling at the same location.
- Tracking Distinction
We use specific symbols to clarify the relationship between local and remote:
- ⇌ (Official Tracking): Points to the actual upstream configured in Git.
- ≠ (Sibling/Inequality): Marks remotes that share the same branch name but are NOT the official upstream.
- Smart Prefix Bolding
Remote prefixes are automatically identified and bolded to improve visual hierarchy.
- Format: [ ☁️ origin/main ] or [ ☁️ upstream/master ]
- Result: You see the "Where" (Remote) instantly, separate from the "What" (Branch).
- Common Divisor Merge
Untracked remotes with matching suffixes are collapsed into a clean group to save space.
- Format: [ ☁️ origin | gitlab : feat/search-v3 ]
- Logic: Multiple remotes sharing one common branch name, separated by :.
- The "Perfect Match" (P0)
If the local name and remote name are identical, we hide the redundant suffix.
- Format: [ 💻 main ⇌ ☁️ origin ] (instead of origin/main)

Here is a concise overview of the key branch decorator cases now implemented:
Local branches act as "heads," automatically grouping all tracked remotes AND same-named sibling remotes into a single pill.
We use specific symbols to clarify the relationship between local and remote:
Remote prefixes are automatically identified and bolded to improve visual hierarchy.
Untracked remotes with matching suffixes are collapsed into a clean group to save space.
If the local name and remote name are identical, we hide the redundant suffix.