Display current git branch with modified and untracked file counts.

󰊢 main              # Clean repository - green/ok
󰊢 main ~3           # 3 changed files - yellow/info
󰊢 main ~2 +4        # 2 changed, 4 untracked - yellow/info
󰊢 main ↑2           # 2 commits ahead - yellow/warning
󰊢 main ↓1           # 1 commit behind - yellow/info
󰊢 feature/auth…     # Truncated branch name (max 15 chars)

# macOS (Homebrew)
brew install git

# Linux (Debian/Ubuntu)
sudo apt install git

# Linux (Fedora)
sudo dnf install git

# Linux (Arch)
sudo pacman -S git

# Enable plugin
set -g @powerkit_plugins "git"

# Enable plugin
set -g @powerkit_plugins "git"

# Icons
set -g @powerkit_plugin_git_icon "󰊢"
set -g @powerkit_plugin_git_icon_modified "󰊢"

# Display options
set -g @powerkit_plugin_git_branch_max_length "15"

# Cache duration (seconds)
set -g @powerkit_plugin_git_cache_ttl "15"

# Only show on threshold (not applicable - based on presence)
set -g @powerkit_plugin_git_show_only_on_threshold "false"

This plugin uses plugin_should_be_active() to check if the current pane is in a git repository before returning cached data. This ensures the plugin disappears immediately when switching to a non-git directory, rather than showing stale data from the previous context.

The plugin shows the branch name followed by change indicators:

branch ~changed +untracked ↑ahead ↓behind

The plugin uses git status --porcelain=v1 to detect:

set -g @powerkit_plugins "git"

set -g @powerkit_plugins "git"
set -g @powerkit_plugin_git_icon ""
set -g @powerkit_plugin_git_icon_modified ""

set -g @powerkit_plugins "git"
set -g @powerkit_plugin_git_cache_ttl "5"

set -g @powerkit_plugins "git"
set -g @powerkit_plugin_git_cache_ttl "30"

set -g @powerkit_plugins "git"
# Show full branch name (no truncation)
set -g @powerkit_plugin_git_branch_max_length "0"

# Or limit to 25 characters
set -g @powerkit_plugin_git_branch_max_length "25"

1. Check if you're in a git repository:

   git rev-parse --is-inside-work-tree

2. Verify git is installed:

   which git
   git --version

3. Check tmux pane path:

   tmux display-message -p '#{pane_current_path}'

• The plugin detects the branch of the current tmux pane's working directory
• If you've changed directories in the shell, tmux's #{pane_current_path} may not reflect it
• Split a new pane or create a new window to update

For very large repositories, git status can be slow:

1. Increase cache TTL:

   set -g @powerkit_plugin_git_cache_ttl "60"

2. Consider using git's sparse checkout or partial clone features

3. Use .gitignore to exclude large directories

• Counts reflect the current pane's directory, not your current shell directory
• Use git status --short to verify the actual changes
• Submodules and nested repositories are not included in counts

• PluginGithub - GitHub notifications and PRs
• PluginGitlab - GitLab merge requests
• PluginBitbucket - Bitbucket pull requests