typos

Source code spell checker

Finds and corrects spelling mistakes among source code:

• Fast enough to run on monorepos
• Low false positives so you can run on PRs

Dual-licensed under MIT or Apache 2.0

Documentation

• Installation
• Getting Started
• Reference
• Comparison with other spell checkers
• Benchmarks
• Design
• Contribute
• CHANGELOG

Install

Download a pre-built binary (installable via gh-install).

Or use rust to install:

cargo install typos-cli

Getting Started

Most commonly, you'll either want to see what typos are available with

typos

Or have them fixed

typos --write-changes
typos -w

If there is any ambiguity (multiple possible corrections), typos will just report it to the user and move on.

False-positives

Sometimes, what looks like a typo is intentional, like with people's names, acronyms, or localized content.

To mark an identifier or word as valid, add it your _typos.toml by declaring itself as the valid spelling:

[default.extend-identifiers]
# *sigh* this just isn't worth the cost of fixing
AttributeIDSupressMenu = "AttributeIDSupressMenu"

[default.extend-words]
# Don't correct the surname "Teh"
teh = "teh"

For localized content, you might want to exclude the entire file

[files]
extend-exclude = ["localized/*.po"]

Integrations

typos provides several building blocks for custom integrations

• - reads from stdin, --write-changes will be written to stdout
• --diff to provide a diff
• --format json to get jsonlines with exit code 0 on no errors, code 2 on typos, anything else is an error.

Examples:

# Read file from stdin, write corrected version to stdout
typos - --write-changes
# Creates a diff of what would change
typos dir/file --diff
# Fully programmatic control
typos dir/file --format json