https://github.com/schwa/multigit
multigit
https://github.com/schwa/multigit
Last synced: about 2 months ago
JSON representation
multigit
- Host: GitHub
- URL: https://github.com/schwa/multigit
- Owner: schwa
- License: bsd-3-clause
- Created: 2022-12-22T21:34:37.000Z (over 2 years ago)
- Default Branch: main
- Last Pushed: 2024-03-20T16:43:05.000Z (about 1 year ago)
- Last Synced: 2025-03-16T17:19:22.505Z (2 months ago)
- Language: Python
- Size: 85 KB
- Stars: 3
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE.md
Awesome Lists containing this project
README
# multigit
multigit is a tool to manage multiple git repositories at once.
Loosely inspired by frustrations caused by trying to use [myrepos](https://myrepos.branchable.com/).
## Installation
The easiest way to install this is with [pipx](https://pypa.github.io/pipx/) (`brew install pipx`):
```sh
pipx install git+https://github.com/schwa/multigit.git
```
(If there's any demand for this, I'll set up a homebrew package.)
## Basic Usage
```sh
mmgit --help
# Registering repositories
mmgit register
mmgit register
# Unregistering repositories
mmgit register
# Perform git status on all registered repositories
mmgit status
# Perform git status with extra git flags
mmgit status -- --short --branch
# Pull on all registered repositories
mmgit pull
# Push on all registered repositories
mmgit push
```
## Help
```text
Usage: mmgit [OPTIONS] COMMAND [ARGS]...
Manage multiple git repositories.
╭─ Options ─────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╮
│ --install-completion Install completion for the current shell. │
│ --show-completion Show completion for the current shell, to copy it or customize the installation. │
│ --help Show this message and exit. │
╰───────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯
╭─ Commands ────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╮
│ add Add changes in repositories. │
│ commit Commit changes in repositories. │
│ config Show, edit or clean the config file. │
│ edit Open selected repositories in the configured editor. │
│ exec Execute a shell command in selected repositories. │
│ gc Run git gc in repositories. │
│ info Show information about selected repositories. │
│ list List selected repositories. │
│ pull Pull changes in repositories. │
│ push Push changes in repositories. │
│ register Register a git repository. │
│ reveal Reveal selected repositories in the Finder. │
│ status Show the git status of all repositories. │
│ ui Open the configured git ui program for selected repositories. │
│ unregister Unregister a git repository. │
╰───────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯
```
## Filtering
By default, multigit will perform the command on all registered repositories. You can filter the repositories that are selected by using the `--filter` flag.
The parameter passed to `--filter` is a comma-separated list of filters. The following filters are available:
- `name:`: Only select repositories that contain the given name (e.g `name:multigit`).
- `not-name:`: Only select repositories that do not contain the given name (e.g `not-name:multigit`).
- `dirty`: Only select repositories that have uncommitted changes.
- `no-dirty`: Only select repositories that have no uncommitted changes.
- `untracked`: Only select repositories that have untracked files.
- `no-untracked`: Only select repositories that have no untracked files.
- `stashes`: Only select repositories that have stashed changes.
- `no-stashes`: Only select repositories that have no stashed changes.
- `remotes`: Only select repositories that have remotes.
- `no-remotes`: Only select repositories that have no remotes.
- `branch:`: Only select repositories that contain branches with the given name (.e.g `branch:main`).
## Configuration
Configuration lives in `~/.config/multigit.toml` but can be specified with the `--config` flag or via the `XDG_CONFIG_HOME` environment variable.
```toml
# Set the default gitui tool to use
gitui = "gitup"
# Set the default editor tool to use.
editor = "code"
# Override behavior for specific commands
[commands]
[commands.status]
# Add extra flags to the git status command
args = ["--short"]
# Only perform status on dirty repositories
filter = "dirty"
# Registered repositories
[repositories."/Users/schwa/Shared/Projects/multigit"]
path = "/Users/schwa/Shared/Projects/multigit"
```
## Known Bugs
- [ ]: Can't interrupt git push/pull with Ctrl-C