cmp-git

# cmp-git

Git source for [hrsh7th/nvim-cmp](https://github.com/hrsh7th/nvim-cmp) and [Saghen/blink.cmp](https://github.com/Saghen/blink.cmp).

## Features

| Git                 | Trigger                                                                  |
| ------------------- | ------------------------------------------------------------------------ |
| Commits             | :                                                                        |
| Trailer keys        | A word at the start of a line in a commit message                        |
| Trailer identities  | `Name <email>` after an identity key, such as `Co-authored-by: `         |
| Trailer values      | An earlier value of the key after any other key, such as `Assisted-by: ` |
| Autosquash prefixes | The start of `fixup`, `squash`, or `amend` on line 1 of a commit message |
| Autosquash titles   | `fixup!`, `squash!`, or `amend!` on line 1 of a commit message           |

| GitHub        | Trigger |
| ------------- | ------- |
| Issues        | #       |
| Mentions      | @       |
| Pull Requests | #       |

| GitLab         | Trigger |
| -------------- | ------- |
| Issues         | #       |
| Mentions       | @       |
| Merge Requests | !       |

| Gitea and Forgejo | Trigger |
| ----------------- | ------- |
| Issues            | #       |
| Mentions          | @       |
| Pull Requests     | #, !    |

## Requirements

- Neovim >= 0.12
- git (>= 2.31 to find trailer keys in history)
- curl (>= 7.55)
- [GitHub CLI](https://cli.github.com/) (optional, cmp-git uses curl if it is not available)
- [GitLab CLI](https://gitlab.com/gitlab-org/cli) (optional, cmp-git uses curl if it is not available)
- [tea](https://gitea.com/gitea/tea) >= 0.12.0 (optional, for Gitea, cmp-git uses curl if it is not available)
- [forgejo-cli](https://codeberg.org/forgejo-contrib/forgejo-cli) (`fj`) (optional, for Forgejo, cmp-git reads the
  token of `fj` and sends it with curl)

### GitHub private repositories

- `curl`: Generate a [token](https://github.com/settings/tokens) with the `repo` scope. Set the `GITHUB_API_TOKEN`
  environment variable to the token.
- `GitHub CLI`: Run [gh auth login](https://cli.github.com/manual/gh_auth_login).

### GitLab private repositories

- `curl`: Generate a [token](https://gitlab.com/-/profile/personal_access_tokens) with the `api` scope. Set the
  `GITLAB_TOKEN` environment variable to the token.
- `GitLab CLI`: Run [glab auth login](https://glab.readthedocs.io/en/latest/auth/login.html).

### Gitea private repositories

- `curl`: Generate an access token in Settings > Applications on the server, with the `read:issue` and
  `read:repository` scopes. Set the `GITEA_TOKEN` environment variable to the token.
- `tea`: Run `tea login add` for the server. cmp-git uses the login whose URL is the host of the remote.

### Forgejo private repositories

- `curl`: Generate an access token in Settings > Applications on the server, with the `read:issue` and
  `read:repositor