# Install gitmux with Homebrew, Nix Git status in tmux status bar. Version 0.11.5 via Homebrew; verified from local package data. ## 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:** - **Upstream docs:** - **License:** MIT - **Source archive:** - **Generated:** 2026-07-08T18:08:21+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-07-08 - Package-manager version: 0.11.5 - Local data: ok - Upstream repository: https://github.com/arl/gitmux - Upstream latest detected: v0.11.5 (current) - info: No package-manager update timestamp was available. ## 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://www.automicvault.com/pkg/source-control-tools/) - Belongs to a source-control command family. - [Terminal utility packages](https://www.automicvault.com/pkg/terminal-utilities/) - Matched terminal and command-line workflow metadata. - [Text processing packages](https://www.automicvault.com/pkg/text-processing-tools/) - Matched text, document, or structured-data processing metadata. - [Developer build packages](https://www.automicvault.com/pkg/developer-build-tools/) - Matched build, compiler, generator, or developer workflow metadata. - [tmux](https://www.automicvault.com/pkg/brew/tmux/) - Runtime dependency declared by Homebrew. - [go](https://www.automicvault.com/pkg/brew/go/) - Build dependency declared by Homebrew. - [diff-so-fancy](https://www.automicvault.com/pkg/brew/diff-so-fancy/) - Shares av.db curated category or tags: cli, developer-tools, git, terminal, version-control. - [git-split-diffs](https://www.automicvault.com/pkg/brew/git-split-diffs/) - Shares av.db curated category or tags: cli, developer-tools, git, terminal, version-control. - [gitu](https://www.automicvault.com/pkg/brew/gitu/) - Shares av.db curated category or tags: cli, developer-tools, git, terminal, version-control. - [gitui](https://www.automicvault.com/pkg/brew/gitui/) - Shares av.db curated category or tags: cli, developer-tools, git, terminal, version-control. - [serie](https://www.automicvault.com/pkg/brew/serie/) - Shares av.db curated category or tags: cli, developer-tools, git, terminal, version-control. - [aicommit](https://www.automicvault.com/pkg/brew/aicommit/) - Shares av.db curated category or tags: cli, developer-tools, git, version-control. - [aicommit2](https://www.automicvault.com/pkg/brew/aicommit2/) - Shares av.db curated category or tags: cli, developer-tools, git, version-control. - [aicommits](https://www.automicvault.com/pkg/brew/aicommits/) - Shares av.db curated category or tags: cli, developer-tools, git, version-control. ## Combined YAML source View the package source record on GitHub. [combined/gitmux.yml](https://github.com/automic-vault/db/blob/main/combined/gitmux.yml) ## Sources - Nucleus package database - Geiger risk classifier - package-page enrichment - curated configuration and credential file locations - curated package history - package version freshness - av.db category and tag curation - package relationship graph - external package-manager database matches - cross-ecosystem install command graph