{"id":25445856,"url":"https://github.com/rkotze/git-mob-vs-code","last_synced_at":"2025-11-01T21:30:34.157Z","repository":{"id":36955678,"uuid":"162735743","full_name":"rkotze/git-mob-vs-code","owner":"rkotze","description":"Co-author commits. A quick way to add co-author metadata to a Git commit via VS Code source control panel.","archived":false,"fork":false,"pushed_at":"2025-02-10T09:56:44.000Z","size":3843,"stargazers_count":38,"open_issues_count":9,"forks_count":9,"subscribers_count":5,"default_branch":"master","last_synced_at":"2025-02-10T10:39:34.981Z","etag":null,"topics":["co-author","git","git-emojis","git-mob","github","hacktoberfest","mob-programming","pair-programming","vscode","vscode-extension","workspace-support"],"latest_commit_sha":null,"homepage":"https://marketplace.visualstudio.com/items?itemName=RichardKotze.git-mob","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/rkotze.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2018-12-21T16:31:00.000Z","updated_at":"2025-02-10T09:56:41.000Z","dependencies_parsed_at":"2023-12-09T16:30:47.389Z","dependency_job_id":"6d2270e9-796b-4632-9779-c59952ac8cb0","html_url":"https://github.com/rkotze/git-mob-vs-code","commit_stats":null,"previous_names":[],"tags_count":40,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rkotze%2Fgit-mob-vs-code","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rkotze%2Fgit-mob-vs-code/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rkotze%2Fgit-mob-vs-code/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rkotze%2Fgit-mob-vs-code/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/rkotze","download_url":"https://codeload.github.com/rkotze/git-mob-vs-code/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":239331465,"owners_count":19621220,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["co-author","git","git-emojis","git-mob","github","hacktoberfest","mob-programming","pair-programming","vscode","vscode-extension","workspace-support"],"created_at":"2025-02-17T16:50:39.500Z","updated_at":"2025-11-01T21:30:34.080Z","avatar_url":"https://github.com/rkotze.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# \u003cimg src=\"https://user-images.githubusercontent.com/10452163/79142596-a808fa00-7db3-11ea-9a02-2d020e0b29d7.png\" width=\"80\" alt=\"VS Code Git Mob logo\" /\u003e Co-author commits\n\n![Visual Studio Marketplace Installs](https://img.shields.io/visual-studio-marketplace/i/RichardKotze.git-mob?color=brightgreen\u0026label=VSCode%20installs) [![](https://img.shields.io/open-vsx/dt/RichardKotze/git-mob?color=brightgreen\u0026label=VSX%20installs)](https://open-vsx.org/extension/RichardKotze/git-mob)\n\n\u003e VS Code extension to easily _co-author a commit_ message from the source control panel.\n\nHelpful when **pair programming**.\n\n![Git Mob in action](https://user-images.githubusercontent.com/10452163/156645932-8f5629f5-24b6-42cd-b24a-767164364353.gif)\n\n1. [Install](#install)\n2. [Quick start](#quick-start)\n3. [Features](#features)\n4. [Notable changes](#notable-changes)\n5. [Settings](#settings)\n6. [Contributing](https://github.com/rkotze/git-mob-vs-code/blob/master/CONTRIBUTING.md)\n\n## Install\n\nOpen VS Code and search for **\"git-mob\"** in **Extensions panel**.\n\nOR\n\nVia the terminal `code --install-extension RichardKotze.git-mob`\n\nAvailable in [VS Code marketplace](https://marketplace.visualstudio.com/items?itemName=RichardKotze.git-mob) and [open VSX registry](https://open-vsx.org/extension/RichardKotze/git-mob)\n\nIf you also use _[git-mob cli](https://github.com/rkotze/git-mob/#install)_ they work fine together.\n\n## Quick start\n\n### Key commands\n\n**Select co-authors** - `CTRL+shift+p` or `⌘+⇧+p` -\u003e \"Select co-authors\". Use the multi-selector to add and remove co-authors.\n\n**Solo** - clear all selected co-authors: `CTRL+shift+p` or `⌘+⇧+p` -\u003e \"Solo: remove all co-authors\"\n\nAdd new co-authors from [repository contributors](#search-repository-contributors-co-authors) or add directly to your co-authors file [`.git-coauthors`](#add-new-co-authors).\n\n### Saving your co-authors\n\nTo keep track of co-authors git-mob uses a JSON file called `.git-coauthors`, and will try to find it in the following directories:\n\n1. If `GITMOB_COAUTHORS_PATH` environment variable is set this will override any other settings.\n1. If the current Git repository has a `.git-coauthors` file in the root directory.\n1. The default is the users home directory at `~/.git-coauthors`.\n\n## Features\n\n- Append _multiple co-authors_ to a commit message\n- Select multiple co-authors (`shift` or `ctrl` or `⌘`) in SCM panel view\n- Easily add co-author data by [searching repository contributors co-authors](#search-repository-contributors-co-authors) from the \"More Authors\" list.\n- **After a commit** [remove all selected co-authors](#post-commit---solo) \n- [Workspace support](#workspace-support), multiple Git repositories\n- **Search and add** co-authors from **GitHub** using anonymous email\n- [Change primary author](#change-primary-author)\n- Right-click and copy co-author data.\n- Add [emojis](#git-emojis) to commits (Gitmojis)\n- Configurable see [setting options](#settings)\n\n### Notable changes:\n\n1. [Global Git Mob](https://github.com/rkotze/git-mob-vs-code/discussions/120) meaning switch between projects will have same co-authors selected. (`v1.17.0`)\n2. `prepare-commit-msg` hook support **removed** (`v1.12.0`)\n\n### Add new co-authors\n\n**Option 1:** `CTRL+shift+p` or `⌘+⇧+p` -\u003e \"Add new co-author\". Fill in all input fields.\n\n**Option 2:** `ctrl+shift+p` or `⌘+⇧+p` -\u003e \"Open .git-coauthors file\" or use UI to open co-authors file `.git-coauthors`.\n\n### Add from repository contributors\n\nClick the **plus +** button on an author in **More Authors** list.\n\n### Search repository contributors co-authors\n\nClick the search icon on the **More Authors** section or `CTRL+shift+p` or `⌘+⇧+p` -\u003e \"Search Git repository for co-authors\".\n\n![image](https://user-images.githubusercontent.com/10452163/57807338-e2f44f00-7758-11e9-8fb1-6d8b8cb9d7ce.png)\n\n### Workspace support\n\nSelect 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.\n\n### Git Emojis\n\nUsing the **standardised** list from [Gitmoji](https://github.com/carloscuesta/gitmoji).\n\nSearch and select an emoji to add to the Git message input field. \n\n`CTRL+shift+p` or `⌘+⇧+p` -\u003e \"Search Gitmojis - emojis\"\n\n![git emojis select list](https://user-images.githubusercontent.com/10452163/79442052-ef6bd200-7fcf-11ea-85c1-82789738add3.png)\n\n### Change primary author\n\n`CTRL+shift+p` or `⌘+⇧+p` -\u003e \"Change primary author\"\n\n## Settings\n\n### Post commit -\u003e Solo\n\nAfter a commit remove selected co-authors. If you commit in the command-line the UI will update as well.\n\n`Default: false`\n\n### Author list -\u003e Expand more authors\n\nExpand 'More Authors' tree when UI starts.\n\n`Default: true`\n\n### Author list -\u003e More Authors To Co-authoring\n\nAdd a new author directly to 'Co-authoring' from 'More Authors'.\n\n`Default: true`\n\n### Co-authors -\u003e Sort direction\n\nCo-author list sorting direction.\n\n`Default: ascending`\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frkotze%2Fgit-mob-vs-code","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Frkotze%2Fgit-mob-vs-code","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frkotze%2Fgit-mob-vs-code/lists"}