Vale CMS Need more than a rule playground? Explore
OPEN SOURCE · MIT

Your style.
Our editor.

GitHub stars
6K
downloads
13.3M
teams listed
395

Vale brings code-like linting to prose. Turn a team’s style guide, a house voice, or a journal’s author guidelines into checks that run in your editor and alongside your code.

macOS, Windows & Linux · Runs offline · Other installs

01Your guideline

Writing guide · Terminology

The product is Vale CLI. Don’t write Vale cli or vale-cli.

02A rule you own

styles/Docs/Terms.yml

extends: substitution
message: "Use '%s' instead of '%s'."
level: error
action:
  name: replace
swap:
  'Vale cli|vale-cli': Vale CLI
  'style ?guide': style guide
  'e-?mail': email
03Feedback where you write

docs/install.md

  1. # Installation
  2. Vale cli runs on macOS, Windows, and Linux.
error Use 'Vale CLI' instead of 'Vale cli'. Docs.Terms
Encode your guidelines in YAML, or start with a published style: Microsoft, Google, or Red Hat. Browse them all in the Explorer.

Watch

Vale in a minute.

Why Vale

Most tools see text. Vale sees a document.

Check the writing in context. Target a heading, a comment, or a description, while leaving the code around it alone.

The same answer on every run.
A rule’s verdict is decided before the draft exists. Test each one against the sentences it should catch and the ones it should leave alone. Testing rules
Milliseconds, not tokens.
On one draft, Vale and a model review found the same fourteen long sentences. Vale took 70 milliseconds; the review took 46 seconds and 45,000 tokens. Read the measurements
Yours to read.
Rules are YAML files in your repository, reviewed in a pull request like any other change. Vale runs offline, so no draft leaves your machine.
A model writes the rule. The rule checks the docs.
Describe a guideline in a sentence and your agent writes the YAML and its tests. Its attention then goes to what no pattern can judge. Agent skills

One tool, every app

More than just a command-line interface.

Vale runs where you already write—in your editor, in your notes app, and in CI before anything merges.

Apps Wherever the prose gets written, with diagnostics as you type.
Automation The same run, before anything merges.
Documentation platforms Hosted docs that run Vale for you.

Vale for your browser

Your style guide, in every text box.

The extension checks what you write on the web, from a pull-request description to an email, against your Vale configuration.

  • Marks as you type, in text areas, inputs, and rich editors, on the sites you turn on.
  • A card on each mark with its fix, from a click or Alt+Enter.
  • One configuration everywhere: library packages, or your house style as a .zip.
  • Free, with no account. Vale runs inside the extension, so nothing leaves your browser.
  • Chrome Soon
  • Edge Soon
  • Firefox Soon

Source on GitHub Privacy policy Thanks to FLOSS/fund for funding it.

Vale for agents

Your assistant writes the docs. Something should check them.

A model writes plausible prose with confidence either way. Vale tells it which sentences break your style, in the turn it wrote them.

A few lines of config.
A consistent first draft.

Start with an existing style guide. Keep the configuration in your project so everyone runs the same checks.

  1. Install Vale.brew install vale on macOS and Linux, choco install vale on Windows, or another package.
  2. Pick your styles.Save this as .vale.ini in your project.
  3. Sync, then lint.Download the styles and check your docs.

Working with a coding assistant? Agent tools has it do all three, then lint every file it writes.

StylesPath = styles
MinAlertLevel = suggestion
Packages = Microsoft

[*.md]
BasedOnStyles = Vale, Microsoft
$ vale sync
$ vale docs/
Make it your own with a YAML rule
extends: substitution
message: "Use '%s' instead of '%s'."
level: warning
swap:
  utilize: use
Learn to write rules →
Or have your assistant set it up
/plugin marketplace add vale-cli/agent-tools
/plugin install vale@agent-tools

Type both in Claude Code, then run /vale:onboard. It shows one proposal and writes nothing until you say yes.

See the agent tools →