Co-author commits

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

Helpful when pair programming.

1. Install
2. Quick start
3. Features
4. Settings
5. Contributing

Install

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

Optional, will sync with git-mob cli

Quick start

Key commands

Select co-authors - CTRL+shift+p or ⌘+⇧+p -> "Select co-authors". Use the multi-selector to add and remove co-authors.

Solo - clear all selected co-authors: CTRL+shift+p or ⌘+⇧+p -> "Solo: remove all co-authors"

Add new co-authors from repository contributors or add directly to your co-authors file .git-coauthors.

Features

• Append multiple co-author metadata to commit message
• Select multiple co-authors (shift or ctrl or ⌘) in SCM panel view
• Search repository contributors co-authors from the "More Authors" list (Add from local repository)
• After a commit remove all selected co-authors
• Workspace support, multiple Git repositories
• Add co-authors from GitHub, see setting options to learn more
• Change primary author
• Right-click and copy co-author data.
• Add emojis to commits (Gitmojis)
• Manually add new co-authors via input
• Button to open co-author file (.git-coauthors) in VS Code
• 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 -> "Add new co-author". Fill in all input fields.

Option 2: ctrl+shift+p or ⌘+⇧+p -> "Open .git-coauthors file" or use UI to open co-authors file .git-coauthors.

Add from repository contributors

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

Search repository contributors co-authors

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

Workspace support

Select one of multiple open Git repositories and add co-author metadata to source control input field. You can have different co-authors applied to all the open Git repositories.

Git Emojis

Using the standardised list from Gitmoji.

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

CTRL+shift+p or ⌘+⇧+p -> "Search Gitmojis - emojis"

Change primary author

CTRL+shift+p or ⌘+⇧+p -> "Change primary author"

Settings

Post commit -> Solo

After a commit remove selected co-authors. 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