π ghr
Yet another repository management with auto-attaching profiles.
π₯ Motivation
ghq is the most famous solution to resolve stress of our repository management currently. However, I wanted to customise the git configuration by some rules, such as using my company email in their repositories.
To achieve that, ghq was not enough for me. So I have rewritten them as simple, in Rust, the robust and modern language today.
π¦ Installation
Using Homebrew (easy)
brew install siketyan/tap/ghr
To upgrade:
brew upgrade siketyan/tap/ghr
Using cargo (classic)
If you have not installed Rust environment, follow the instruction of rustup.
cargo install ghr
For upgrading, we recommend to use cargo-update.
cargo install-update ghr
π§ Installing the shell extension
To extend ghr features to maximum, it is recommended to install the shell extension. Add the line below to your shell configuration script to enable it.
Bash
eval "$(ghr shell bash)"
Fish
eval "$(ghr shell fish)"
π Usages
Usage: ghr <COMMAND>
Commands:
cd Changes directory into a repository (Shell extension required)
clone Clones a Git repository to local
delete Deletes a repository from local
init Initialises a Git repository in local
list Lists all managed repositories
open Opens a repository in an application
path Prints the path to root, owner, or a repository
profile Manages profiles to use in repositories
shell Writes a shell script to extend ghr features
version Prints the version of this application
help Print this message or the help of the given subcommand(s)
Options:
-h, --help Print help information
Cloning a repository
ghr supports many patterns or URLs of the repository to clone:
ghr clone <owner>/<repo>
ghr clone github.com:<owner>/<repo>
ghr clone https://github.com/<owner>/<repo>.git
ghr clone ssh://git@github.com/<owner>/<repo>.git
ghr clone git@github.com:<owner>/<repo>.git
If you have installed the shell extension, you can change directory into the cloned repository:
ghr clone <url_or_pattern> --cd
If you often use repositories of a specific owner, you can set the default owner to be resolved.
[defaults]
owner = "siketyan"
ghr clone <repo>
Changing directory
You can change directory into a repository on the shell. It requires installing the shell extension.
ghr cd <url_or_pattern>
Attaching profiles
Create ~/.ghr/ghr.toml
and edit as you like:
[profiles.default]
user.name = "Your Name"
user.email = "your_name@personal.example.com"
[profiles.company]
user.name = "Your Name (ACME Inc.)"
user.email = "your_name@company.example.com"
[[rules]]
profile.name = "company"
owner = "acme" # Applies company profiles to all repositories in `acme` org
[[rules]]
profile.name = "default"
Configuring applications to open repos in
Edit ~/.ghr/ghr.toml
and add entries as you like:
[applications.vscode]
cmd = "code"
args = ["%p"]
Note
%p
will be replaced by the repository path.
Finding path of the repository
ghr path # Root directory
ghr path <owner> # Owner root
ghr path <owner> <repo> # Repository directory
ghr path --host=github.com # Host root
ghr path --host=github.com <owner> # Owner root of the specified host
ghr path --host=github.com <owner> <repo> # Repository directory of the specified host
π Customising
You can change the root of repositories managed by ghr by setting environment variable GHR_ROOT
in your shell profile.
ghr path # ~/.ghr
GHR_ROOT=/path/to/root ghr path # /path/to/root