Autocomplete Co-Authored-By lines in git commits. Type a GitHub handle and complete it to Name <email> format.

• Neovim 0.10+
• blink.cmp or nvim-cmp

{
  'saghen/blink.cmp',
  dependencies = {
    { 'wassimk/git-coauthors.nvim' },
  },
  opts = {
    sources = {
      per_filetype = {
        gitcommit = { 'buffer', 'snippets', 'git_coauthors' },
      },
      providers = {
        git_coauthors = {
          name = 'git_coauthors',
          module = 'git-coauthors.blink',
        },
      },
    },
  },
}

The source auto-registers when nvim-cmp is detected:

{ 'wassimk/git-coauthors.nvim' }

Add git_coauthors to your nvim-cmp sources for the gitcommit filetype.

The plugin provides a cab snippet and @ handle completion in gitcommit buffers:

1. Type cab and expand the snippet
2. The cursor lands on @handle. Type @ to see all handles, or start typing to filter
3. Select an entry to replace the placeholder with the full Name <email>

feat: add dark mode support

Co-Authored-By: Alice Smith <alice@example.com>

Co-authors are discovered automatically with zero configuration:

1. GitHub collaborators (preferred): If the gh CLI is installed and authenticated, collaborators are pulled from the GitHub API (e.g., @octocat).

2. Git log fallback: When gh is unavailable, co-authors are read from git log history (e.g., @Jane Smith).

Discovery runs in the background and results are cached after the first trigger. Set discover = false to disable it.

Define handles manually for people not yet in the repo, or to override a discovered entry. Create a JSON file at ~/.local/share/nvim/git-coauthors/handles.json:

{
  "@alice": "Alice Smith <alice@example.com>",
  "@bob": "Bob Jones <bob@example.com>"
}

Manual handles are merged on top of discovered ones. You can also pass handles inline (see Configuration).

git_coauthors = {
  name = 'git_coauthors',
  module = 'git-coauthors.blink',
  opts = {
    handles_path = '~/my/custom/handles.json',
    handles = {
      ['@user'] = 'User Name <user@example.com>',
    },
  },
}

nvim-cmp users can pass the same options to require('git-coauthors').setup().

If another completion source also triggers on @ (e.g., blink-cmp-git for GitHub mentions), both will fire on Co-Authored-By: lines. is_coauthor_context() returns true when the cursor is on a Co-Authored-By: line so you can conditionally suppress the other source:

-- blink.cmp + blink-cmp-git
git = {
  name = 'Git',
  module = 'blink-cmp-git',
  transform_items = function(_, items)
    if require('git-coauthors').is_coauthor_context() then
      return {}
    end
    return items
  end,
},

-- nvim-cmp + cmp-git
{ name = 'git', entry_filter = function(entry, ctx)
    return not require('git-coauthors').is_coauthor_context()
  end,
},

Run tests and lint:

make test
make lint

Enable the local git hooks (one-time setup):

git config core.hooksPath .githooks