Linters
What is Vale? An introduction to the command-line prose linter
Vale is an open-source, cross-platform command-line tool written in Go that brings code-like linting to prose and to comments in source code. You describe your writing rules in YAML, and Vale checks text against them the way a code linter checks syntax and style. It runs in editors, notes apps and CI.
Who makes Vale
Vale is made by Vale, and the project's official website is linked below. The tool is open source and distributed as a single statically linked executable.
Official website: vale.sh
What Vale is for
Vale applies linting to prose. Instead of relying on a reviewer to remember a style guide, you encode the guidance as rules and let the tool flag text that breaks them. The rules are YAML files kept in the project repository, so a change to a writing rule is reviewed like any other change.
Vale also reaches into source code. It uses tree-sitter to find comments in source code files, so the prose in comments and docstrings can be checked with the same rules as a documentation page.
Who Vale is for
The vendor names four groups: teams with a style guide or house voice, documentation writers, developers writing comments and docstrings, and teams using AI coding assistants.
For a team with a house voice, the value is consistency that does not depend on one editor's memory. For a developer writing docstrings, it is the same feedback loop they already have for code.
Notable capabilities
Vale combines a rule format that fits into version control with support for many places where text gets written. The capabilities below are the ones the project documents.
Each is described in a sentence or two so you can see how it works in practice.
- Rules in YAML: guidelines can be encoded in YAML, or you can start from published styles such as Microsoft, Google or Red Hat.
- Rule testing: rules can be tested against sentences they should and should not flag, so a rule can be checked before it is used on real documents.
- Real parsers: Vale parses supported markup formats with real parsers rather than patterns, so markup is handled structurally instead of being guessed at.
- Comments in code: tree-sitter locates comments in source files, and markup formats can be associated with file extensions so comment bodies are parsed as that format.
- Views: these let Vale lint prose inside files that are not documents and skip the rest.
- Alert levels: Vale has three alert levels, and each project decides which findings sit at which level.
- Editor and language server support: the Vale language server keeps styles loaded, so re-linting in the editor is cheaper than a cold run.
- Agent hooks: these lint files and commits written by an AI assistant and return the alerts in the same turn.
- Browser extension: it checks text written on the web against your own Vale configuration.
How Vale fits linters
Within the linters category, Vale is unusual in what it targets. Most linters examine code. Vale examines the human language around it, in documentation, notes and comments, using the same mechanics: configurable rules, severity levels and checks that run in CI before changes merge.
For Linthelm's wider niche of linters, static analysis and code quality, Vale covers the written side of quality. It runs on macOS, Windows and Linux, works offline so drafts stay on your machine, and lints files in parallel without a separate runtime. It can be installed through package managers such as Homebrew and Chocolatey.
Frequently asked questions
What is Vale used for?
Vale is used to lint prose. It checks text against rules you define, and it can also check the comments inside source code files.
Who develops Vale?
Vale is developed by the Vale project. Its official website is https://vale.sh.
Does Vale work offline?
Yes. Vale runs on macOS, Windows and Linux and works offline, which means drafts stay on the user's machine.
Can Vale use existing style guides?
Yes. You can encode your own guidelines in YAML or start from published styles such as Microsoft, Google or Red Hat.
Does Vale work with AI coding assistants?
Yes. Agent hooks lint files and commits written by an AI assistant and return the alerts in the same turn.
Linthelm is independent and is not affiliated with Vale. Product names belong to their owners. Features change; confirm details on the official website.