cspell-parsers

A collection of parser plugins for cspell, published as scoped @cspell/parser-* packages on npm. Each one parses a specific file format for cspell, so spell checking sees only the text that was meant to be read as words — identifiers, comments, string contents — and skips the rest (keywords, punctuation, numeric literals, import specifiers, and so on).

Available parsers

Package	Languages	Tags
@cspell/parser-c-cpp-strings-comments	c, cpp	comment, string
@cspell/parser-csharp-strings-comments	csharp	comment, string
@cspell/parser-go-strings-comments	go	comment, string
@cspell/parser-java-strings-comments	java	comment, string
@cspell/parser-javascript	javascript, javascriptreact	comment, identifier, jsx module, string
@cspell/parser-php-strings-comments	php	comment, string
@cspell/parser-python-strings-comments	python	comment, string
@cspell/parser-ruby-strings-comments	ruby	comment, string
@cspell/parser-rust-strings-comments	rust	comment, string
@cspell/parser-strings-comments	c, cpp, csharp, go, java javascript, javascriptreact php, python, ruby, rust typescript, typescriptreact	comment, module, string
@cspell/parser-typescript	javascript, javascriptreact typescript, typescriptreact	comment, identifier, jsx module, string
@cspell/parser-typescript-strings-comments	javascript, javascriptreact typescript, typescriptreact	comment, module, string
@cspell/parser-typescript-tree-sitter	javascript, javascriptreact typescript, typescriptreact	comment, identifier, jsx module, string
@cspell/parser-typescript-tree-sitter-wasm	javascript, javascriptreact typescript, typescriptreact	comment, identifier, jsx module, string

See each package's own README for install instructions, usage, and — where the parser emits tags — the table of tags it can produce, for filtering with customizePlugin.

Choosing a parser

• Check identifiers too — @cspell/parser-typescript checks identifiers, comments, and strings in JavaScript, JSX, TypeScript, and TSX, and skips keywords and import specifiers. Each file type has its own parser. @cspell/parser-javascript has just the JavaScript and JSX parsers.
• Comments and strings only — the *-strings-comments packages leave code alone and check only comments and string literals. Pick the one for your language, or @cspell/parser-strings-comments to cover all of them at once.
• tree-sitter backend — @cspell/parser-typescript is built on @cspell/parser-typescript-tree-sitter-wasm (WebAssembly, no native build step). Use @cspell/parser-typescript-tree-sitter directly for tree-sitter's native Node.js bindings instead.

Requirements

Tool	Version
cspell	>=10.0.0
Code Spell Checker	>=4.4.0

Quick start

Every parser package works the same way. Install it:

npm install --save-dev @cspell/parser-typescript

Then import its recommended settings to register the plugin and select it for the relevant file types in one step:

cspell.config.jsonc

{
  "import": ["@cspell/parser-typescript/recommended"],
}

For more control — applying a parser to only some file types, or alongside other settings — wire the plugin in yourself instead; see the package's README for the exact languageIds and parser name to use.

Contributing

Want to add a new parser, or work on one of the ones here? See CONTRIBUTING.md.

License

MIT — see LICENSE.

Support Future Development

If our spell checkers and plugins save you time, please consider supporting their development.

Please show your support through one of the following sites:

     

---

Copyright (c) 2026 Street Side Software

Brought to you by Street Side Software