bash-git-prompt is a bash prompt customization that displays detailed information about the current Git repository state.
The tool solves the problem of having limited visibility into your Git working directory by displaying branch name, staging status, and synchronization with remote branches directly in your prompt. It works by parsing Git repository metadata and rendering symbolic indicators for common states: staged files, unstaged changes, merge conflicts, stash entries, and commits ahead or behind the remote branch. The prompt shows these details inline using Unicode symbols, allowing you to see your repository status at a glance without running separate Git commands.
The tool suits developers who work frequently with Git from the command line and want immediate feedback on repository state. It works with both bash and fish shells. Installation is straightforward via Homebrew on macOS or by cloning the repository and sourcing it in your shell configuration. The prompt is highly configurable: you can disable untracked file counting for repositories with many build artifacts, show or hide the upstream branch name, and choose from different visual themes. The README does not compare it to alternatives.
The project maintains active engagement with bug reports and feature requests. Pull requests receive review and integration. The codebase has been refined through community contributions addressing edge cases and performance concerns. Development activity shows responsiveness to issues affecting usability in different Git workflows and shell environments.
