š Item status indicators
Each repository card shows icons and badges reflecting its state:
General Icons
š(or[P]) ā Pinned repository.ā(or*) ā Starred / favorite repository.ā git(orG clean) ā Clean Git repository.ā dir(oro dir) ā Directory exists but is not a git repository.ā missing(orx missing) ā Path does not exist or is not a directory.
Compact Status Suffixes
For git repositories, the status indicator shows compact counts for any non-zero values:
| Suffix | Meaning | Colour |
|---|---|---|
N+ |
N files staged for commit | Cyan |
N! |
N files modified but not staged | Yellow |
N? |
N untracked files | Muted |
Nā |
N conflicted files | Red / Danger |
Nā |
N commits ahead of upstream (needs push) | Bold Green |
Nā |
N commits behind upstream (needs pull/fetch) | Bold Yellow |
When all counts are zero, the indicator shows ā clean. Press ? or h at any time to see the legend inside the app.
ā Staging Divergence (ā PARTIAL)
When a repository has both staged changes and unstaged changes (modified or untracked) coexisting simultaneously, Gitwig will display a yellow ā PARTIAL warning badge next to the repository name on its card.
Active Repository State Badges
When a repository has an active Git operation or special state, Gitwig displays a colored status badge:
ā CLEANā No active Git state/operation.ā MERGEā Active Merge session (contains conflicts).š§ REBASEā Active Interactive/Normal Rebase.ā” CHERRYā Active Cherry-pick operation.ā” REVERTā Active Revert operation.š BISECTā Active Bisect session.š¬ APPLYā Applying patches (mailbox).
Git LFS Badges ([LFS])
Files tracked by Git LFS will display a blue [LFS] badge next to their names in:
- Staged / Unstaged / Conflicts file panels (Workspace tab).
- Changed files lists (Commit Details / Inspect window).
- Repository Files Tree list (Files tab).
- Stashed Files list (Stashes tab).
Global Summary Header Bar
The high-level dashboard stats at the top of the homepage show:
- repos: Total number of configured repositories. If stale projects are hidden via configuration (
show_stale_projects), the dashboard shows<visible>/<total>repositories, indicating how many are hidden due to being stale. - dirty: Repositories with uncommitted/unstaged changes.
- ahead: Repositories with local commits ahead of their remote tracking branch.
- stale: Repositories where the last commit is older than the configured threshold (default is 1 month; configurable via
stale_threshold_monthsin settings).
Auto-Refresh & Manual Refresh
Items support ~ and ~/... expansion, so ~/code/gitwig resolves to your home directory.
Gitwig automatically refreshes all repository statuses in the background every 10 seconds using non-blocking background threads, ensuring the home dashboard is always live and up-to-date. You can also press R to manually refresh the selected item's status immediately (e.g. after running a git command externally); the status bar briefly flashes Refreshed to confirm.