New advertisers: 50% off your first month with code FIRSTMONTHSee slots

Spell-check at commit time with typos, blocking only on typos in lines a commit adds.

GitHub stars
32
View on GitHub

What it does

  • Adds a lint git pre-commit entry, the setup skill, and an opt-in end-of-turn Stop hook
  • Covers registering the git hook through lefthook, husky, or plain git hooks, with local or shared scope
  • Honors your repository's typos configuration, merging the bundled default config through extend-* keys
  • Designed for teams that want spelling findings to reach every author, including Claude and other agents

Spell-check at commit time via typos-cli: a git pre-commit lint entry that blocks only on typos in the lines a commit adds, with an opt-in end-of-turn check, honoring the consuming repo's own typos configuration; hooks never run an ecosystem record's command.

Add marketplace

/plugin marketplace add melodic-software/claude-code-plugins

Run it inside Claude Code once, then install the plugin below.

Install

/plugin install spelling@melodic-software

Run it inside Claude Code after adding the marketplace.

Files

Discovered from source

Readme

spelling

A Claude Code plugin that spell-checks with typos at commit time. Findings arrive when you commit, from a git pre-commit entry that blocks only on a typo in a line the commit adds, so they reach every author: Claude, other agents and people. Nothing is reported while Claude edits. An opt-in end-of-turn check hands findings in the uncommitted changes back to Claude before a turn ends.

The check honors your repository's own typos configuration and runs with or without one: typos discovers it from the checked path, and the plugin's bundled config/default-typos.toml (passed with -c, so that SHA-shaped hex is not read as a misspelling) merges with it through extend-* keys. Pointer: the Sources list in typos' configuration reference.

The hooks run only this typos adapter (git-hooks/adapters.sh). They never run a command from a .claude/ecosystems/spelling.yaml record; /toolchain:lint and /toolchain:check run its lint-cmd on request, and /spelling:setup check says when one exists.

Git pre-commit entry

The plugin ships one git-hook entry, lint (git-hooks/entries.json): a pre-commit check that blocks a commit only on a typo in a line the commit adds, printed as <path>:<line>: <message>. It reports and never rewrites a file. A typo on a line the commit leaves alone never blocks, a partly staged file is checked as staged, and your config's excludes hold for every path. typos exiting with an error and no finding blocks the commit and shows its output. It replaces the earlier typos-check entry: /spelling:setup check reports an installed typos-check copy as superseded, apply install-git-hooks retires it, and a decline of typos-check carries to lint. The entry runs once /spelling:setup apply install-git-hooks [scope=local|shared] registers it with the repository's hook manager (lefthook, husky or plain git hooks). Local scope stays in this clone; shared scope commits the copy under .githooks/spelling/. The bundled config/default-typos.toml is copied beside it. /spelling:setup check reports drift, and the SessionStart probe prints one line when the entry is missing, stale or edited.

When typos is missing, an agent's commit fails with the install command; a person's commit gets a one-line notice and goes through. git -c checks.skipmissing=typos commit ... skips the check while typos is absent. The placement rules are the check-placement convention in the marketplace repository.

End-of-turn check (opt-in)

With spelling_end_of_turn on, a Stop hook runs the same check over the lines changed since the last commit, untracked files included. Findings go back to Claude with exit 2, so they are fixed before the turn ends; once a Stop hook has continued the turn it stays quiet, so it blocks at most once per turn. Off, its default, a turn end costs one process: the node launcher, whose gate closes before bash starts (scripts/hook-census.sh, WSL2 Ubuntu, 2026-10-15, fenced by .performance/ratchets.json). On, a clean work tree measured 19 process creations and execs on the same host.

Requirements

  • typos on PATH, installed at the machine level by the machine's owner (install typos). It is never downloaded on the fly. The SessionStart probe reports a missing typos once per session from prerequisites.json.
  • Bash runs the check (3.2 or newer, so macOS's own bash works). On native Windows, install Git for Windows.
  • Node.js on PATH for the Claude Code rows, which launch through node hooks/exec-bash.mjs, and for the installer the setup skill runs. node "<plugin root>/lib/prerequisites.mjs" check "<plugin root>" reports what resolves; it is read-only and installs nothing.

Install

/plugin marketplace add melodic-software/claude-code-plugins
/plugin install spelling@melodic-software

Then verify prerequisites with /spelling:setup check.

Configuration

The rules themselves are never configured here. They come from the typos config already in your repository, which the plugin reads automatically. To change the rules (allowlist a false positive, ignore a pattern), edit that file.

Two userConfig options tune the Claude Code hooks; the git pre-commit entry has none:

OptionDefaultEffect
spelling_enabledtrueKill switch for the SessionStart probe and the end-of-turn check. The installed git pre-commit entry keeps running.
spelling_end_of_turnfalseSet true to run the pre-commit check over the uncommitted changes when a turn ends; findings go back to Claude once per turn so they are fixed before it stops.

Set them interactively with /plugin configure spelling@<marketplace>, or headless on the install command:

claude plugin install spelling@<marketplace> --config spelling_enabled=false

Options reference

Generated from this plugin's .claude-plugin/plugin.json. For how Claude Code asks for these and hands them to the plugin, see User configuration.

OptionTypeDefaultDescription
spelling_enabledbooleantrueKill switch for the plugin's Claude Code hooks: the SessionStart probe and drift line, and the opt-in end-of-turn check. On by default. The git pre-commit entry is installed separately and is not affected.
spelling_end_of_turnbooleanfalseAt the end of each turn, run the pre-commit lint entry over the lines changed since the last commit and hand any findings back so they are fixed before the turn ends, at most once per turn. Off by default.

How to set these

Set the options above for spelling@<marketplace>, replacing <marketplace> with the marketplace you installed this plugin from:

Do not uninstall the plugin to reconfigure it: see What an uninstall deletes and keeps. For a Claude Code release without plugin configure, see Plugin install.

Upstream documentation

License

MIT (SPDX-License-Identifier: MIT).

Details

Marketplace
melodic-software/claude-code-plugins
Source
plugins/spelling
Category
Development

More from melodic-software/claude-code-plugins

All 139

Similar to spelling

More Development Tools