Co-author commits

VS Code extension to easily co-author a commit message from the source control panel.

Helpful when pair programming or mobbing.

1. Install
2. Features
3. Settings
4. Contributing

Install

Open VS Code and search for "git-mob" in Extensions panel and click install.

Set your primary author in Git.

$ git config --global user.name "Jane Doe"
$ git config --global user.email "jane@example.com"

Optional, will sync with git-mob cli

Features

• Apply co-author metadata to commit message
• Select multiple co-authors to add to commit (shift or ctrl or ⌘)
• Search suggested co-authors from the "More Authors" list (Add from local repository)
• Workspace support, multiple Git repositories
• Add co-authors from GitHub, see setting options to learn more
• Change primary author
• Add emojis to commits (Gitmojis)
• Manually add new co-authors via input
• Button to open co-author file (.git-coauthors) in VS Code
• Remove co-authors from input after a commit
• Configurable see setting options

prepare-commit-msg hook support removed in v1.12.0

Add new co-authors

Option 1: CTRL+shift+p or ⌘+⇧+p and search for "Add new co-author". Fill in all input fields. (ctrl+shift+p -> "Open .git-coauthors file")

Option 2: Add your co-authors to the .git-coauthors files in your user folder.

Add new co-authors from repository

Click the plus + button on an author in More Authors list.

Search suggested co-authors

Click the search icon on the More Authors section or CTRL+shift+p or ⌘+⇧+p and search for "Search suggested co-authors".

Workspace support

Select one of multiple open Git repositories and add co-author metadata to source control input field.

Git Emojis

Using the standardised list from Gitmoji.

Search and select an emoji to add to the Git message input field

Change primary author

Settings

Post commit -> Solo

After a commit remove selected co-authors from input to unselected. If you commit in the command-line the UI will update as well.

Default: false

Author list -> Expand more authors

Expand 'More Authors' tree when UI starts.

Default: true

Author list -> More Authors To Co-authoring

Add a new author directly to 'Co-authoring' from 'More Authors'.

Default: true

Github -> Personal Access Token

Search for co-authors on GitHub you will need to generate a PAT.

1. Visit GitHub > settings > tokens
2. Click "generate new token"
3. Select "user:read" (This allows GitMob to fetch a users public email)

Default: <empty>

Co-authors -> Sort direction

Co-author list sorting direction.

Default: ascending