.vectorlint.ini is VectorLint’s project configuration file. It lives in your project root and controls three things: global behavior settings, where VectorLint looks for custom rules, and which rule packs run on which files.
Run vectorlint init to generate a starter file. You can edit it manually at any time.
Global Settings
These settings apply to all reviews in the project.File Pattern Sections
Use[glob/pattern] sections to map file types to rule packs. Each section targets files matching the pattern and specifies which rules to run.
RunRules
A comma-separated list of rule pack names. Pack names correspond to subdirectory names inside RulesPath.
RunRules= with no value to explicitly skip all rules for matching files (useful for drafts or generated content).
Rule Pack Directory Structure
TheRulesPath setting defines where VectorLint looks for rule packs. Each subdirectory becomes an available pack name.
Acme/ are available when you set RunRules=Acme. Nesting is supported: you can organize rules into subdirectories within a pack.
Cascading Configuration
VectorLint applies configuration blocks from general to specific, similar to Vale’s cascade behavior. All blocks that match a given file are applied, and rule packs accumulate. A file runs every pack from every matching block, from the most general to the most specific.content/docs/**/*.md is more specific than **/*.md.
Confidence threshold
VectorLint filters findings through confidence checks before surfacing violations. The confidence threshold controls how aggressively this filter applies. Set it in your.env file or as an environment variable:
Invalid values fall back to the default of
0.75.
Complete Example
Global Style Guide (VECTORLINT.md)
In addition to.vectorlint.ini, you can place a VECTORLINT.md file in your project root to define global style instructions in plain language.
Zero-config mode: If no .vectorlint.ini exists, VectorLint automatically detects VECTORLINT.md, creates a synthetic “Style Guide Compliance” rule, and reviews content against it.
Combined mode: When .vectorlint.ini is present, the contents of VECTORLINT.md apply globally to every review, making your tone and terminology preferences active across all rules.
Keep
VECTORLINT.md concise. VectorLint emits a warning if the file exceeds approximately 4,000 tokens, as very large contexts can degrade review quality and increase API costs.Next Steps
- LLM Providers: configure the model that runs reviews
- Style Guide: write custom rules for your content standards