Gherkin RefineA Gherkin linter you can trust in CI

Fast, deterministic linting and safe fixes for Cucumber feature files, built on the official parser.

Drop-in for gherkin-lint

Installs a gherkin-lint command, reads .gherkin-lintrc and .gherkin-lintignore, and supports every gherkin-lint 4.2.4 rule.

Whitespace, indentation, and keyword fixes are applied only when the result still parses as valid Gherkin.

Uses @cucumber/gherkin, so Rule blocks, Example and Scenario Template keywords, and localized dialects parse as Cucumber does.

Stable exit codes, plus stylish, compact, JSON, NDJSON, and SARIF output.

npm install --save-dev gherkin-refine
npx gherkin-refine .

Requires Node.js 22.18 or later. Continue to Getting started for configuration, safe fixes, and GitHub Actions.

Read the practical tutorial on the original site, Medium, or DEV.to.

Getting started installs the CLI, runs it in GitHub Actions, and applies safe fixes.
Migration describes migrating from gherkin-lint.
Comparison compares Gherkin Refine with gherkin-lint feature by feature.
Configuration explains config files, rule options, overrides, and inline suppression.
Rules lists the built in rules and their defaults.
Plugins explains how to write and load custom rules.
AI agent integration covers structured output and an agent remediation loop.