gis/README.org
2023-09-27 12:29:18 +02:00

1.8 KiB

gis

gis is a Bash script which shows a status summary of multiple Git repositories.

It was inspired by wstool, vcstool and the default Starship prompt.

/denis/gis/media/commit/2d8c76653618a31ca5f4541a2d2ecfd371e78c8c/screenshot.png

Usage

  Usage: gis [COMMANDS] [OPTIONS]

  Show a status summary of all Git repositories which are found recursively in
  current work directory. If the colon-separated environment variable $GIS_PATH
  is set, the declared directories will be used instead.

  COMMANDS
    fetch  Execute 'git fetch --prune --all' for all found repositories
    pull   Execute 'git pull' for all found repositories which are behind upstream

  OPTIONS
    -p, --path  PATH  Use PATH for searching Git repositories
    -h, --help        Show this help message and exit

Installation

Place the gis script in your $PATH. To use the autocompletion feature source the gis_completion.bash script.

On ZSH additionally the compinit and bashcompinit modules must be loaded before sourcing the completion script:

  autoload -U +X compinit && compinit
  autoload -U +X bashcompinit && bashcompinit

Alternatively, installation scripts for Bash (install.bash) and ZSH (install.zsh) are provided which will link the two files to ~/.local/{bin/gis,share/bash-completion/completions/gis} and add the corresponding entries to ~/.bashrc or ~/.zshrc. Further updates of gis require just git pull.

Nix Flake

This repository is also a Nix Flake. gis is provided as package under github:Deleh/gis#gis.