If you shied away from collaborative coding just because you had to manually add co-authors, then this script will definitely calm your nerves. git-coco is a simple git hook (in python3) to easily add co-authors to a commit message. It gets triggered automatically as soon as you hit git-coco. coco is short for "commit coauthors".

Main features (TL; DR)-

• Run git-coco instead of git commit with the same arguments.
• Supports Autcomplete (keys - TAB, ↑, ↓) which relieves you of the mnemonic load of remembering author's initials, and Autosuggest (key →) on top of this makes the process of adding repetitive co-author groups hassle free.
• Supports issue/task/item number as part of the commit message.

Check out the screenshots!

Requirements - To get started, all you need is a linux or mac computer with bash support. If you prefer other shells (like zsh) then adapt setup.sh accordingly.

• Setup
• How to use?
  • Issue number (additional feature)
  • When to skip the triggering of hooks
• Configs
• Available git tags
• Extendable interface for programmers
• Why git-coco?
  • Comparison to other co-author tools

Adapt config in utils.py accordingly (see Configs). Then,

1. ./setup.sh - installs dependencies, updates $PATH, and adds an environment variable GIT_COCO to bashrc. Restart your terminal after this step.
2. coco.sh install <absolute-path-to-your-git-repo> : this symlinks the git hooks to the git repo where you wanna use them. This step should be done for each repo where you wanna use the hook. coco.sh is in your $PATH, so can be run from anywhere.
3. Add authors you collaborate with using git-add-authors.

and you are good to go! Happy collaborative coding :)

I would recommend adding alias gco="git-coco" to your bashrc.

coco.sh uninstall <absolute-path-to-your-git-repo>: removes the git hooks from the repo.

• git-coco (Autocomplete version): Run git-coco or git-coco -m "<msg>" to see the hook in action. git-coco takes the same arguments as git commit. With git-coco you can avail the cool autocomplete feature. Input can be either author's initials or their email ids, just type few letters of the respective author(s) for the available options to pop-up. Multiple authors should be separated by comma. Key bindings - Select using TAB or up-arrow/down-arrow key.

Autosuggest co-author groups - if a bunch of you work together frequently, then adding the same co-authors repeatedly from scratch is a hassle. You can make use of the autosuggest feature based on history to circumvent this. Key bindings - Select using right-arrow key.

e.g. if Batman and Superman work together on multiple commits, then for the next commit you only need to type Batman. The autosuggest feature automatically suggests Superman which can be completed with the right-arrow key. The autosuggest feature works along with the above autocomplete feature.

• Eidetic version: If you forget to run git-coco and run git commit instead, then the autosuggest feature will not work. However, you can still add the coauthors using initials only. Its eidetic because you gotta remember all the initials! 😃
• git-add-authors: to update authors.txt run git-add-authors. It takes a list of authors in the format specified in authors.txt, i.e., <author-initials>: <author-full-name>, <author-email-id>. For example, git-add-authors "NR: Natasha Romanoff, black-widow" "KM: Krishna Mehra, krrish". Only unique initials can be added. The script takes care of checking if the initials are unique.

If you are using frameworks like jira or codebeamer for tracking tasks, then you can also add the corresponding task/issue number to the commit message (check the screenshots). This can be done automatically if you name the branch ending with _issuexxxxx where xxxxx is the task number. The fundamental principle of this feature is to encourage one branch per issue. However, if your branch name does not contain the issue number then you will be prompted to enter it manually. This feature is an example of how to add your own custom messages on top of co-authors (see for Extendable interface more details).

In the following cases, you should skip triggering the hook-

• rebase -i - if you amend a commit message during an interactive rebase then the coauthor prompt will pop up again even if you had added them before. This is intentional. However, if you only change file(s) and do not wish to change the commit message during an amend then use git commit --amend --no-edit
• cherry-pick - git cherry-pick <hash> triggers git commit by default, which then triggers the hook. Use git cherry-pick -n <hash> to avoid that.

How the final commit message looks like:

NOTE - Coauthors and issue number are optional, the committer can simply hit enter to ignore them.

Why not wrap it completely in prepare-commit-msg and just use vanilla git commit? git-coco was born because the default hook environment provides a very minimal tty where cool features like autocomplete built on top of prompt-toolkit or even tab based completion using readline won't function. Here are my queries regarding tty on github and stackoverflow.

• Other co-author tools like git-mob and git-pair rely exclusively on author initials. As the number of authors in the database increase, usability becomes an issue due to the mnemonic load (of remembering) initials. Autocomplete in git-coco eliminates this issue.
• Each commit in git-coco can have different set of co-authors which is not supported by git-mob and git-pair.
• git-coco is written in python3 and is simple to setup.