Skip to content

simoleone/git-coauthor

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

11 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

git-coauthor

Simple multiple author support porcelain for git. Written in pure Bash.

Installation

brew install simoleone/tap/git-coauthor

Usage

git coauthor
    display current coauthors and this usage message

git coauthor <initials or name> ...
    set current co-authors to developers with matching initials or names

git coauthor --solo
    remove current co-authors and go solo

git coauthor --add "Jane Smith <jane@example.com>"
    add a new author to the database

git coauthor --ls
    list all authors in the database

git coauthor --rm <initials or name>
    remove author with matching initials or name from the database

Why?

Github announced support for Co-authored-by: trailers for git commits in January 2018. Pairing is a great way to get things done, and everyone gets credit in commit graphs as well as in Github's UI by using this method. So basically, this is great.

There are a number of existing solutions to this problem out there, but all of them fall a little bit short for one reason or another. The goals of this project are simple:

  • No external dependencies (no node, ruby, etc). Should only depend on Bash and Git.
  • Integration with git built-in porcelains. git commit should "just work".
  • No munging of author (and do not interfere with gpg commit signing). Use only the Co-authored-by trailer.

See Also

Prior Art