vale-cli/vale

Health v2 · maintenance only

Adoption not part of the score

6026 stars · 220 forks observed · 2026-08-28

What it is AI-extracted, prompt v1, taxonomy v1, 2026-08-29, confidence not recorded

Vale is a fast, cross-platform command-line linter for prose that enforces editorial style guides on documentation. It is markup-aware, parsing Markdown, AsciiDoc, reStructuredText, and source-code comments so rules apply only to actual prose, and rules are extensible via simple YAML files.

Use cases

• enforce a consistent editorial style guide across documentation
• lint prose in markdown files from the command line
• add a docs style check to CI pipelines
• lint comments and docstrings in source code
• check spelling, passive voice, and wordiness in technical writing
• lint AsciiDoc and reStructuredText documentation
• run a prose linter in a pre-commit hook or editor via LSP

When to choose

• you maintain a documentation set and need automated style-guide enforcement
• you want markup-aware linting that ignores code samples and syntax
• you need custom style rules expressible as simple YAML without a plugin API
• you want fast, offline linting suitable for editors, pre-commit hooks, and CI

When to avoid

• you want a general-purpose writing coach or grammar tutor rather than a rule-based checker
• you need AI-driven rewriting or content generation rather than rule enforcement
• you only need simple spellcheck without style enforcement

Facets

cli-tool · maturity active

linter cli developer-tools documentation markdown nlp documentation developer-tools windows cli cross-platform prose-linting style-guide markup-aware technical-writing docs-as-code ci-integration lsp command-line natural-language-processing linux macos docker

Member repositories

For agents

markdown · JSON · MCP: product_card(name="vale-cli/vale")