gitctl
is a command-line interface (CLI) tool designed to simplify and streamline your GitLab workflow. It is built with Go and is designed to be easy to use and highly efficient.
- Base Path Config: Define base paths for all your GitLab projects (
gitctl.yaml
) - Search Git Repositories:
gitctl
will search for Git repositories in the base paths you've defined - Run Git Commands:
gitctl
will run Git commands on the repositories found in the base paths
Currently, gitctl
supports the following Git commands:
git status
git pull
Download the latest release for your platform from the Releases page,
then extract and move the gitctl
binary to any place in your $PATH
.
To install gitctl
, follow these steps:
- Clone the repository:
git clone [email protected]:ethical-developer/cli/gitctl.git
- Navigate to the cloned directory:
cd gitctl
- Build the project:
go build
- Install the CLI:
go install
Add a gitctl.yaml
file to your home directory (~/.gitctl.yaml
) with the following format:
base:
dir:
- "C://dev//swe-codeshare"
- "C://dev//other-folder"
Here's how you can use gitctl
:
gitctl [command] [arguments]
For more information about the commands, use:
gitctl --help
Run git commands on multiple git repositories.
For example, you can run 'gitctl pull' to pull all the git
repositories in the base directories.
Usage:
gitctl [command]
Available Commands:
completion Generate the autocompletion script for the specified shell
help Help about any command
pull Execute git pull on multiple git repositories.
status Execute git status on multiple git repositories.
Flags:
--config string config file (default is $HOME/gitctl.yaml)
-h, --help help for gitctl
-v, --verbose verbose output
--version version for gitctl
--viper use Viper for configuration (default true)
Use "gitctl [command] --help" for more information about a command.
We welcome contributions to gitctl
. If you'd like to contribute, please submit a merge request with your changes.
If you encounter any problems or have any questions, please open an issue on our GitLab page.
gitctl
is currently under active development. We're always looking for feedback and suggestions for new features.