gra

gra (short for git remote add) is a small Bash script which allows to add new Git remotes easily. New remote URLs will be added with the same URL scheme as the one of the origin remote. The only argument which is needed is a REMOTE_NAME,

$ gra Deleh
Adding remote origin-Deleh with URL git@github.com:Deleh/example.git
Fetching from remote origin-Deleh
From github.com:Deleh/example
 * [new branch]      main       -> origin-Deleh/main

Usage

Usage: gra [OPTIONS] REMOTE_NAME

Add a Git remote by providing a single name.  All remotes get listed if no
REMOTE_NAME is provided.

REMOTE_NAME  Name of the remote

OPTIONS
  -h, --help  Show this help message and exit

Shorthands

Shorthands can be defined in ~/.config/gra.config for example like this:

ex=example
slu=SuperLongUsername

They can be passed as REMOTE_NAME argument, which is handy for often-used, long remote names. Autocompletion is available for all defined shorthands.

Installation

Manual

Place the gra script in your $PATH. To use the autocompletion feature source the gra_completion.bash script.

Script

An installation script for Bash (install.bash) is provided which will link the two files to ~/.local/{bin/gra,share/bash-completion/completions/gra} and add the corresponding entries to ~/.bashrc. Further updates of gra require just git pull.

Nix Flake

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

Deleh / gra

gra