Git Branch Selector

Interactively select git branches and print them to stdout. Use within pipes to perform commands on multiple git branches.

Usage

To interactively select branches and print your selection, use the bselect (for 'branch-select') executable without any arguments.

Use the Up/Down arrow keys to navigate branch selection. Use Space to select/deselect an entry, Enter to confirm the selection, or press Q or Esc to exit without action.

Use in conjunction with xargs (or command substitution) to perform operations on selected branches. This example demonstrates how to interactively delete branches.

Configuration

You can make and select your own themes using the application's JSON config file. Get the path to the config file on your system using:

bselect --config

See the JSON schema for all available settings. As a quick example to get started configuring a new theme, the below produces the theme used in the GIF above:

{
    "theme": "emoji",
    "themes": [
        {
            "name": "emoji",
            "checked_item_prefix": {
                "value": "✓",
                "foreground": "green"
            },
            "unchecked_item_prefix": {
                "value": "✕",
                "foreground": "red"
            },
            "active_item_prefix": {
                "value": "👉 "
            },
            "inactive_item_prefix": {
                "value": "   "
            }
        }
    ]
}

Build, Install, and Test

Do this using the usual cargo commands:

cargo build

cargo install --path .

cargo test

Or grab the latest release package or installer.