# cz-ccgls

> Commitizen adapter following the Conventional-Changelog with support for Gitmoji and Lerna Scopes.

Latest version **0.8.1** (published 2026-11-19) · SEE LICENSE IN UNLICENSE license · 0 weekly downloads

## Install

```sh
npm install cz-ccgls
pnpm add cz-ccgls
yarn add cz-ccgls
bun add cz-ccgls
```

Provides the command `cz-ccgls`.

## Health

**Score 65/100 (B)** — status: active.

Positive: esm support; no vulnerabilities; has provenance; recently updated; high maintenance score.

Warnings: low downloads; no types; pre 1.0.

## Facts

| | |
|---|---|
| Version | 0.8.1 |
| Published | 2026-11-19 |
| First published | 2018-09-09 |
| Weekly downloads | 0 |
| License | SEE LICENSE IN UNLICENSE |
| TypeScript types | none |
| Module format | ESM + CommonJS |
| Dependencies | 14 |
| Unpacked size | 2.6 MB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| Provenance | attested (GitHub Actions) |
| GitHub stars | 6 |
| Author | Thierry Michel |
| Maintainers | thierrymichel |
| Keywords | commit, commitizen, changelog, gitmoji, lerna, scope |

## Links

- npm: https://www.npmjs.com/package/cz-ccgls
- Repository: https://github.com/thierrymichel/cz-ccgls
- Homepage: https://github.com/thierrymichel/cz-ccgls#readme
- Issues: https://github.com/thierrymichel/cz-ccgls/issues
- npm.io page: https://npm.io/package/cz-ccgls

## Dependencies (14)

- [ora](https://npm.io/package/ora.md) ^6.0.1
- [fuzzy](https://npm.io/package/fuzzy.md) ^0.1.3
- [longest](https://npm.io/package/longest.md) ^2.0.1
- [inquirer](https://npm.io/package/inquirer.md) ^8.2.0
- [right-pad](https://npm.io/package/right-pad.md) ^1.0.1
- [wrap-ansi](https://npm.io/package/wrap-ansi.md) ^8.0.1
- [lodash.map](https://npm.io/package/lodash.map.md) ^4.6.0
- [node-fetch](https://npm.io/package/node-fetch.md) ^3.0.0
- [import-from](https://npm.io/package/import-from.md) ^4.0.0
- [read-pkg-up](https://npm.io/package/read-pkg-up.md) ^9.0.0
- [find-cache-dir](https://npm.io/package/find-cache-dir.md) ^3.3.2
- [conventional-commit-types](https://npm.io/package/conventional-commit-types.md) ^3.0.0
- [inquirer-autocomplete-prompt](https://npm.io/package/inquirer-autocomplete-prompt.md) ^1.4.0
- [inquirer-maxlength-input-prompt](https://npm.io/package/inquirer-maxlength-input-prompt.md) ^1.0.2

## Alternatives

- [cli-color](https://npm.io/package/cli-color.md) — 3.4M weekly downloads
- [log](https://npm.io/package/log.md) — 1.3M weekly downloads
- [logstash-client](https://npm.io/package/logstash-client.md) — 4.5K weekly downloads
- [@nocobase/plugin-logger](https://npm.io/package/@nocobase/plugin-logger.md) — 2.0K weekly downloads
- [child-process-debug](https://npm.io/package/child-process-debug.md) — 695 weekly downloads

## Recent versions

- 0.8.1 (latest) — 2026-11-19
- 0.8.0 — 2024-09-10
- 0.7.1 — 2023-12-04
- 0.7.0 — 2023-11-22
- 0.6.2 — 2023-11-22
- 0.6.1 — 2023-11-08
- 0.6.0 — 2023-11-08
- 0.5.4 — 2023-09-21
- 0.5.3 — 2023-09-12
- 0.5.2 — 2023-09-12
- 0.5.1 — 2023-07-19
- 0.5.0 — 2023-07-18
- 0.4.6 — 2023-01-03
- 0.4.5 — 2023-01-03
- 0.4.4 — 2023-01-02
- … 16 more at https://npm.io/package/cz-ccgls/versions

## README

# cz-ccgls

> Adapter for [commitizen](https://github.com/commitizen/cz-cli), a prompt for [conventional changelog](https://github.com/conventional-changelog/conventional-changelog) standard.<br>
> Support [gitmoji](https://gitmoji.carloscuesta.me/) and [Lerna](https://lernajs.io/) scopes.

[![npm version](https://img.shields.io/npm/v/cz-ccgls.svg?style=flat-square)](https://www.npmjs.org/package/cz-ccgls)
[![Commitizen friendly](https://img.shields.io/badge/commitizen-friendly-brightgreen.svg?style=flat-square)](http://commitizen.github.io/cz-cli/)
[![Conventional Commits](https://img.shields.io/badge/Conventional%20Commits-1.0.0-yellow.svg?style=flat-square)](https://conventionalcommits.org)
[![License](https://img.shields.io/badge/license-UNLICENSE-green.svg?style=flat-square)](https://github.com/thierrymichel/cz-ccgls/blob/master/UNLICENSE)

Inspired by [cz-conventional-changelog](https://www.npmjs.com/package/cz-conventional-changelog) and [cz-emoji](https://github.com/ngryman/cz-emoji)

![Screenshots](screenshots.gif)

## Usage

### [Making your repo Commitizen-friendly](https://github.com/commitizen/cz-cli#making-your-repo-commitizen-friendly)

First, install the Commitizen cli tools:

```sh
npm install commitizen -g
```

Next, initialize your project to use the cz-ccgls adapter by typing:

```sh
commitizen init cz-ccgls --yarn --dev --exact
```

> Or if you are using Npm: `commitizen init cz-ccgls --save-dev --save-exact`

### Locally

```sh
# Install commitizen + adapter
yarn add -D commitizen cz-ccgls
```

Add some `config` information to your `package.json`

```json
"config": {
  "commitizen": {
    "path": "./node_modules/cz-ccgls"
  }
}
```

> [More infos in the `commitizen` documentation](https://github.com/commitizen/cz-cli#optional-install-and-run-commitizen-locally)

### Configuration

Add some `config` information to your `package.json` ([default values](src/index.mjs#L24))

```json
"config": {
  "cz-ccgls": {
    "useScopes": true
  }
},
```

---

### Related

- [commitlint-config-ccgls](https://github.com/thierrymichel/commitlint-config-ccgls), the [`Commitlint`](https://github.com/marionebl/commitlint) companion.

---
_Source: https://npm.io/package/cz-ccgls · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._
