# Install gitmux with Homebrew, Nix Git status in tmux status bar. Version 0.11.5 via Homebrew; verified 2026-07-27. Also installable with nix: nix profile install nixpkgs#gitmux. ## Install ```sh sudo av install brew:gitmux ``` Additional install commands: ### macOS - Homebrew (100%): ```sh brew install gitmux ``` Evidence: local Homebrew formula metadata ### Linux - Nix (92%): ```sh nix profile install nixpkgs#gitmux ``` Evidence: nixpkgs package indexes: pkgs/by-name/gi/gitmux/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1 ## Package facts - **Package key:** brew:gitmux - **Package manager:** Homebrew - **Package manager page:** - **Version:** 0.11.5 - **Source summary:** Git status in tmux status bar - **Homepage:** - **Repository:** - **License:** MIT - **Source archive:** - **Last updated:** 2026-07-27T14:57:49+02:00 - **Generated:** 2026-08-04T22:13:35+00:00 ## Executables - gitmux (cli) - gitmux (alias) ## Dependencies - tmux ## Build dependencies - go ## Install behavior - Post-install hook: not defined - Bottle: available on arm64_linux, arm64_sequoia, arm64_sonoma, arm64_tahoe, arm64_ventura, sonoma, ventura, x86_64_linux ## Freshness - Page generated: 2026-08-04 - Package-manager version: 0.11.5 - Package-manager updated: 2026-07-27 - Local data: ok - Upstream repository: https://github.com/arl/gitmux - Upstream latest detected: v0.11.5 (current) ## Project history and usage gitmux is a small Go command-line tool that renders Git working-tree state for the tmux status bar. Its role is deliberately narrow: it turns branch, divergence, staged, modified, untracked, stash, and cleanliness information into tmux format strings. ### Project history The GitHub repository was created in October 2019, and an early v0.2.0 release was published the same day. The README presents gitmux as an install-and-forget tmux companion with shell-agnostic behavior and a YAML configuration file for colors, symbols, and layout. ### Adoption history gitmux spread through terminal-tooling channels rather than through a large framework ecosystem. Its README documents binary releases, Homebrew installation for macOS and Linux, Arch User Repository packages, and Go source installation, which matches its position as a practical status-line utility. ### How it is used Practitioners add a `gitmux` invocation to `status-right` in `.tmux.conf`, usually passing tmux's pane path so the status bar follows the active working directory. Users generate a default YAML file with `gitmux -printcfg`, save it as `~/.gitmux.conf`, and pass it with `-cfg` when they want customized symbols or colors. ### Why package nerds care For package maintainers, gitmux is a typical compact CLI package: a single executable, no service integration, and behavior that can be verified by running it inside a Git checkout. It matters mainly to users who keep Git context visible inside long-running tmux sessions. ### Timeline - 2019: Repository created on GitHub. - 2019: v0.2.0 release published. - 2020s: README-documented install paths include Homebrew, AUR, binary releases, and Go source installation. ### Related projects - tmux provides the status bar integration point, while Git supplies the repository state that gitmux summarizes. ### Sources - - - - ## Security Notes narrow executable package without higher-risk signals. - **Geiger risk:** green / low - narrow executable package without higher-risk signals ## Configuration and credential file locations These source-backed paths show where this package keeps local settings or durable credentials. Automic Vault can use them as review targets for secret scanning, migration, and command approval. ## Configuration files - Unix: ~/.gitmux.conf ## Source Database Details - **Source Database:** Homebrew formula API - **Tap:** homebrew/core - **Full Name:** gitmux - **Version Scheme:** 0 - **Revision:** 0 - **Bottle Stable Root URL:** - **Deprecated:** no - **Disabled:** no - **Keg Only:** no - **URL Keys:** stable ## Other Package-Manager Records - Nix - gitmux: normalized package name match | nixpkgs package indexes: pkgs/by-name/gi/gitmux/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1 ## Related links - [Source-control packages](https://pkg.so/source-control-tools/) - Belongs to a source-control command family. - [Terminal utility packages](https://pkg.so/terminal-utilities/) - Matched terminal and command-line workflow metadata. - [Text processing packages](https://pkg.so/text-processing-tools/) - Matched text, document, or structured-data processing metadata. - [Developer build packages](https://pkg.so/developer-build-tools/) - Matched build, compiler, generator, or developer workflow metadata. - [tmux](https://pkg.so/brew/tmux/) - Runtime dependency declared by Homebrew. - [go](https://pkg.so/brew/go/) - Build dependency declared by Homebrew. - [diff-so-fancy](https://pkg.so/brew/diff-so-fancy/) - Shares pkgdb curated category or tags: cli, developer-tools, git, terminal. - [gitui](https://pkg.so/brew/gitui/) - Shares pkgdb curated category or tags: cli, developer-tools, git, terminal. - [sesh](https://pkg.so/brew/sesh/) - Shares pkgdb curated category or tags: cli, developer-tools, terminal, tmux. - [tmuxp](https://pkg.so/brew/tmuxp/) - Shares pkgdb curated category or tags: cli, developer-tools, terminal, tmux. - [hunk](https://pkg.so/brew/hunk/) - Shares pkgdb curated category or tags: cli, developer-tools, git, terminal. - [serie](https://pkg.so/brew/serie/) - Shares pkgdb curated category or tags: cli, developer-tools, git, terminal. - [gitu](https://pkg.so/brew/gitu/) - Shares pkgdb curated category or tags: cli, developer-tools, git, terminal. - [gitlogue](https://pkg.so/brew/gitlogue/) - Shares pkgdb curated category or tags: cli, developer-tools, git, terminal. - [tmex](https://pkg.so/brew/tmex/) - Local package facts share a topical domain. Shared terms: cli, developer, developer-tools, terminal, tmux. - [tpack](https://pkg.so/brew/tpack/) - Local package facts share a topical domain. Shared terms: cli, developer, developer-tools, terminal, tmux. ## Combined YAML source View the package source record on GitHub. [combined/gitmux.yml](https://github.com/mxcl/pkgdb/blob/main/combined/gitmux.yml) ## Sources - pkg.so package database - Geiger risk classifier - package-page enrichment - curated configuration and credential file locations - curated package history - package version freshness - pkgdb category and tag curation - package relationship graph - external package-manager database matches - cross-ecosystem install command graph