Files
holocron/plugins/lint/docs/research/docs/vale/cli-reference.md
Defame1297 d1afdbeff7 feat(lint): add vale-config skill
Covers Vale install and .vale.ini setup — StylesPath, built-in/
third-party/custom styles, BasedOnStyles activation. Setup half of
Vale support; vale-run (running/interpreting) is a separate skill.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01FxG5T8EJDgkABXxuneuFfn
2026-08-08 20:20:58 +00:00

1.3 KiB

topic, source_keys
topic source_keys
cli-reference
context7-websites-vale-sh

Core Invocation

$ vale README.md

Lints the given file(s)/glob against the styles configured in .vale.ini.

Key Flags and Subcommands

Command/Flag Purpose
vale sync Downloads and installs packages/styles declared in .vale.ini. Run after install and whenever Packages changes.
vale ls-config Prints the currently active, fully-resolved configuration as JSON. Useful for debugging what settings actually apply to a file.
--output=<style> Sets the output format/template: line, JSON, CLI (default), or a custom template.
--no-exit Suppresses the non-zero exit code Vale normally returns when alerts are found — useful in CI pipelines that shouldn't hard-fail on lint output.
--ignore-syntax Treats input as plain, unformatted text, skipping syntax-aware parsing (Markdown/HTML/etc).
--minAlertLevel=<level> Overrides MinAlertLevel from the config for this run (suggestion, warning, error).
--version Prints the Vale binary version.

Exit Codes

By default, vale exits non-zero when it finds any alert at or above MinAlertLevel — this is what makes it usable as a CI gate. Pass --no-exit to always exit 0 regardless of findings.