https://github.com/j-siu/go-mygit
Git, Github repository command line tool supporting group action and mass directory processing with parallel push.
https://github.com/j-siu/go-mygit
api git gitea github go golang parallel
Last synced: 6 days ago
JSON representation
Git, Github repository command line tool supporting group action and mass directory processing with parallel push.
- Host: GitHub
- URL: https://github.com/j-siu/go-mygit
- Owner: J-Siu
- License: mit
- Created: 2022-05-05T03:19:24.000Z (over 3 years ago)
- Default Branch: main
- Last Pushed: 2025-12-11T22:59:44.000Z (8 days ago)
- Last Synced: 2025-12-13T03:06:12.585Z (7 days ago)
- Topics: api, git, gitea, github, go, golang, parallel
- Language: Go
- Homepage:
- Size: 261 KB
- Stars: 6
- Watchers: 1
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
README
# go-MyGit [](https://www.paypal.com/donate/?business=HZF49NM9D35SJ&no_recurring=0¤cy_code=CAD)
Command line tool for easy mass configuration of git remotes, and working with Github/Gites repositories API.
### Table Of Content
- [Install](#install)
- [Supported Platforms](#supported-platforms)
- [Highlight](#highlight)
- [Push multiple repository](#push-multiple-repository)
- [Set Archived](#set-archived)
- [Set Private](#set-private)
- [Update Description](#update-description)
- [Update Topics](#update-topics)
- [What It Does](#what-it-does)
- [What It Does Not](#what-it-does-not)
- [Features](#features)
- [Usage](#usage)
- [Debug](#debug)
- [Selector](#selector)
- [-g/--group](#-g--group)
- [-r/--remote](#-r--remote)
- [Git Base Commands](#git-base-commands)
- [init](#init)
- [push](#push)
- [--tags](#--tags)
- [--all](#--all)
- [Configuration](#configuration)
- [Packages Used](#packages-used)
- [Repository](#repository)
- [Contributors](#contributors)
- [License](#license)
> This replaces the bash implementation [mygit](https://github.com/J-Siu/mygit).
### Install
Go install
```sh
go install github.com/J-Siu/go-mygit/v2@latest
```
Download
- https://github.com/J-Siu/go-mygit/releases
### Supported Platforms
- github
- gitea
- gogs(not tested)
### Highlight
Following are highlight of some `go-mygit` functions.
#### Push multiple repository
```sh
# Push to all remotes
go-mygit push
# Support path operation
go-mygit push docker_*
```
#### Set Archived
```sh
# Set archived to true
go-mygit repo set archived true
# Set archived to false
go-mygit repo set archived false
```
#### Set Private
```sh
# Set current repository to private on server
go-mygit repo set private true
# Support path operation
go-mygit repo set private false docker_*
```
#### Update Description
```sh
# Update description on server of current repository/directory
go-mygit repo set description "This is a new description"
```
#### Update Topics
```sh
# Update topics on server of current repository/directory
go-mygit repo set topic golang go project
```
### What It Does
> These are the reasons "mygit" got created.
- Parallel processing multiple repository, eg. pushing 10 repos at the same time
- Pushing same repo to multiple git servers which are not mirrored
- Set up same set of git remote repeatedly
- Update repository info on git server(api)
### What It Does Not
- Replace `git` command. (`git` command is required for git function to work.)
- Replace Github cli `gh` (`go-mygit` only cover limited number of api in comparison.)
### Features
- Configuration File
- [x] remotes
- [x] groups
- [x] secrets
- Selector for git servers
- [x] -g/--group
- [x] -r/--remote
- Base(git) Commands
- [x] clone
- [x] init
- [x] pull
- [x] push
- [x] remote
- [x] add
- [x] list
- [x] remove
- Repository(api)
- [x] list all repo on server
- [x] create repo on server
- [x] get / set
- [x] actions (enable/disable)
- [x] archived
- [x] description
- [x] discussions (enable/disable)
- [x] private
- [x] projects (enable/disable)
- [x] public key (get only)
- [x] secret
- [x] topic
- [x] visibility
- [x] delete
- [x] repository
- [x] secret
### Usage
```sh
Git and Repo automation made easy.
Usage:
go-mygit [command]
Available Commands:
clone Git clone
completion Generate the autocompletion script for the specified shell
config Print configurations
help Help about any command
init Git init and reset remotes
pull Git pull
push Git push
remote Git remote commands
repository Repository commands
Flags:
--config string config file (default is $HOME/.config/go-mygit.json)
-d, --debug Enable debug
-g, --group stringArray Specify group
-h, --help help for go-mygit
--no-parallel Don't process in parallel
--no-skip Don't skip empty output
--no-title Don't print title for most output
-r, --remote stringArray Specify remotes
Use "go-mygit [command] --help" for more information about a command.
```
#### Debug
Use `-d` for debug output.
Example:
```sh
go-mygit -d repo des get
```
#### Selector
`go-mygit` allow command applied to groups or remotes through the use of `-g/--group` and `-r/--remote`. This applies to all commands except `remote` and `group` mentioned above.
`-g/--group` and `-r/--remote` must be placed right after `mygit` and before any command.
##### -g/--group
```sh
go-mygit -g external
go-mygit -g external -g internal
```
##### -r/--remote
```sh
go-mygit -r gh
go-mygit -r gh -r server3
```
`-g/--group` and `-r/--remote` can be used at the same time.
```sh
go-mygit -g external -r server2
```
#### Git Base Commands
`init`, `push` are git base commands.
##### init
`go-mygit init` will clear all existing remote and add remote base on `-g`/`-r` selector. If no group nor remote are specified, all configured remotes will be added.
`go-mygit init` by default use current directory name as repository name. Repository name can be specified in the format `go-mygit init `. File `.go-mygit.json` containing the repository name will be created, which is used by API based commands.
Before `go-mygit init`:
```sh
$ git remote -v
origin https://github.com/J-Siu/mygit.git (fetch)
origin https://github.com/J-Siu/mygit.git (push)
```
`go-mygit init` without selector:
```sh
$ go-mygit init
Reinitialized existing Git repository in /tmp/mygit/.git/
$ git remote -v
gh git@github.com:/username1/mygit.git (fetch)
gh git@github.com:/username1/mygit.git (push)
server2 git@server2:/username2/mygit.git (fetch)
server2 git@server2:/username2/mygit.git (push)
server3 git@server3:/username3/mygit.git (fetch)
server3 git@server3:/username3/mygit.git (push)
```
`go-mygit init` with group internal:
```sh
$ go-mygit --group internal init
Reinitialized existing Git repository in /tmp/mygit/.git/
$ git remote -v
server2 git@server2:/username2/mygit.git (fetch)
server2 git@server2:/username2/mygit.git (push)
server3 git@server3:/username3/mygit.git (fetch)
server3 git@server3:/username3/mygit.git (push)
```
`go-mygit init` with repository name:
```sh
$ go-mygit init mygit2
Reinitialized existing Git repository in /tmp/mygit/.git/
$ git remote -v
gh git@github.com:/username1/mygit2.git (fetch)
gh git@github.com:/username1/mygit2.git (push)
server2 git@server2:/username2/mygit2.git (fetch)
server2 git@server2:/username2/mygit2.git (push)
server3 git@server3:/username3/mygit2.git (fetch)
server3 git@server3:/username3/mygit2.git (push)
```
##### push
`go-mygit push` base on `-g`/`-r` selector. If no group nor remote are specified, all configured remotes will be pushed in sequence.
```sh
go-mygit push
```
```sh
go-mygit -r gh push
```
`go-mygit push` support options `--tags` and `--all`
###### --tags
If `--tags` is used, `go-mygit push` will push all tags.
```sh
go-mygit push --tags
```
###### --all
If `--all` is used, `mygit push` will push all branches(`--all`).
```sh
go-mygit -r gh push --all
```
### Configuration
See [go-mygit.json.md](go-mygit.json.md)
### Packages Used
- [go-gitapi](https://github.com/J-Siu/go-gitapi)
- [go-helper/v2](https://github.com/J-Siu/go-helper)
- [cobra](//github.com/spf13/cobra)
- [viper](//github.com/spf13/viper)
### Repository
- [go-mygit](https://github.com/J-Siu/go-mygit)
### Contributors
- [John, Sing Dao, Siu](https://github.com/J-Siu)
### License
The MIT License (MIT)
Copyright © 2025 John, Sing Dao, Siu
Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.