git-squad
is a command-line tool that makes it easy to manage co-authors in
your Git commit messages. Perfect for pair programming or collaborative coding
sessions, it lets you quickly add or remove co-authors without having to
manually edit commit templates.
- Maintain a list of collaborators (buddies) with their names and emails
- Add and remove co-authors in the current git session
- Automatically updates your git commit template
- Simple command-line interface
- Shell completions for commands and buddies
Manage co-authors in git commit messages with ease
Usage: git-squad [OPTIONS] [COMMAND]
Commands:
with Add buddies to the current session
without Remove buddies from the current session
alone Remove all buddies from the current session
create Create a new buddy
forget Delete a buddy from the list of available buddies
info List both active and available buddies
list List all available buddies
active List active buddies in the current session
completions Generate completions for your shell
migrate-buddies Migrate buddies from old yaml format to new toml format
help Print this message or the help of the given subcommand(s)
Options:
--buddies-file <BUDDIES_FILE> Use a custom buddy file instead of ~/.config/git-squad/buddies.toml
-h, --help Print help
- Git must be installed and configured
- Rust and Cargo must be installed
cargo install git-squad
- Clone the repository:
git clone git@github.com:ccntrq/git-squad.git
cd git-squad
- Build and install with Cargo:
cargo install --path .
Before using git-squad
, you need to set up a git commit template. You can
either setup a global one or do this per repo.
# Create a template file
touch ~/.gitmessage
# Configure git to use it
git config --global commit.template ~/.gitmessage
# Inside your repo dir
# Create a template file
touch .git/gitmessage
# Configure git to use it
git config commit.template .git/gitmessage
There is a similar tool written in typescript called git-mob which I discovered while name hunting for this tool.