Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/sarumaj/gh-gr
github-cli extension allowing to manage multiple github repositories at once
https://github.com/sarumaj/gh-gr
gh-cli gh-extension github-repo golang
Last synced: 2 months ago
JSON representation
github-cli extension allowing to manage multiple github repositories at once
- Host: GitHub
- URL: https://github.com/sarumaj/gh-gr
- Owner: sarumaj
- License: mit
- Created: 2023-09-30T13:25:40.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2024-09-13T07:51:36.000Z (4 months ago)
- Last Synced: 2024-09-13T20:36:59.348Z (4 months ago)
- Topics: gh-cli, gh-extension, github-repo, golang
- Language: Go
- Homepage: https://pkg.go.dev/github.com/sarumaj/gh-gr/v2
- Size: 7.69 MB
- Stars: 6
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: LICENSE
Awesome Lists containing this project
- awesome-gh-cli-extensions - **gr** - Pull, push and check status on multiple GitHub repositories at once. (Github)
README
[](https://github.com/sarumaj/gh-gr/actions/workflows/test_and_report.yml)
[](https://github.com/sarumaj/gh-gr/actions/workflows/build_and_release.yml)
[](https://goreportcard.com/report/github.com/sarumaj/gh-gr)
[](https://codeclimate.com/github/sarumaj/gh-gr/maintainability)
[](https://codeclimate.com/github/sarumaj/gh-gr/test_coverage)
[](https://pkg.go.dev/github.com/sarumaj/gh-gr/v2)
[](https://go.dev)
[](https://github.com/sarumaj/gh-gr/releases/latest)
[](https://github.com/sarumaj/gh-gr/releases/latest)
[](https://github.com/sarumaj/gh-gr/releases/latest)
[](https://github.com/sarumaj/gh-gr/releases)
[](https://github.com/sarumaj/gh-gr/releases/latest)
---
# gh-gr
**gh-gr** is a GitHub repository management tool based on the project [github-repo](https://github.com/CristianHenzel/github-repo) by [Cristian Henzel](https://github.com/CristianHenzel).
Since the original project used a configuration file containing sensitive information, the issue has been addressed by reinventing the tool as an extension to the [github cli (gh)](https://cli.github.com/).
[](https://youtu.be/LLZ4bcqc_Bk)
## Installation
Prerequisites: [github cli (gh)](https://cli.github.com/)
To install gr:
```console
$ gh extension install https://github.com/sarumaj/gh-gr
```
## Usage
```console
$ gh gr --help
> gr is a gh cli extension allowing management of multiple repositories at once
>
> Usage:
> gr [flags]
> gr [command]
>
> Examples:
> gh gr --concurrency 100 --timeout "20s"
>
> Available Commands:
> cleanup Clean up untracked local repositories
> completion Generate the autocompletion script for the specified shell
> edit Edit configuration
> export Export current configuration to stdout
> help Help about any command
> import Import configuration from stdin or a file
> init Initialize repository mirror
> pull Pull all repositories
> push Push all repositories
> remove Remove current configuration
> status Show status for all repositories
> update Update configuration
> version Display version information
> view Display current configuration
>
> Flags:
> -c, --concurrency uint Concurrency for concurrent jobs (default 12)
> -h, --help help for gr
> -t, --timeout duration Set timeout for long running jobs (default 10m0s)
>
> Use "gr [command] --help" for more information about a command.
```
First, create the configuration:
```console
$ gh gr init -d SOMEDIR -c 10
```
or, if you are willing to exclude some repositories, you can use regular expressions:
```console
$ gh gr init -c 10 -d SOMEDIR -e ".*repo1" -e "SOMEORG/repo-.*" -s
```
Run `gh gr init --help` or `gh gr help init` to retrieve more information about the init command.
After the configuration is created, you can pull all repositories using:
```console
$ gh gr pull
```
you can view the status of the repositories using:
```console
$ gh gr status
```
and you can push all repositories using:
```console
$ gh gr push
```
After creating new repositories on the server or after user data changes, you can update the local configuration using:
```console
$ gh gr update
```
## Acknowledgments
- [Cristian Henzel](https://github.com/CristianHenzel)