🛡️ Mamoru

Mamoru acts as a commit-msg hook that embeds a compiled dictionary of over 106,000 words to instantly catch and block typos before they enter your version control.

Installation

Install the binary using Cargo.

cargo install mamoru

Usage

Navigate to any Git repository and initialize the hook. This automatically configures Mamoru inside .git/hooks/commit-msg with the necessary executable permissions.

mamoru --init

# If existing git hooks exist, use --force to overwrite it
mamoru --init --force

Once installed, Mamoru intercepts your git commit commands automatically. If a commit contains unrecognized words, the hook safely aborts the commit and suggests corrections.

$ git commit -m "feat: implment algorimth update"

Commit blocked! Typos found in commit message:

  • "implment" -> Did you mean: implement?
  • "algorimth" -> Did you mean: algorithm?

error: Please fix the spelling errors above.

To remove Mamoru.

mamoru --uninstall

Performance

Benchmarks gathered using hyperfine.

$ hyperfine -N --warmup 10 --min-runs 10000 "./target/release/mamoru --path test_commit.txt"

Time (mean ± σ):     487.6 µs ± 40.7 µs
Range (min … max):   424.3 µs … 827.1 µs

Acknowledgments

Mamoru's built-in dictionary is compiled from a blend of standard natural language and specialized developer jargon, heavily drawing from:

• Linux system wordlists (via /usr/share/dict) for robust, everyday English.
• cspell repositories for modern programming, DevOps, and open-source.

License

This project is licensed under the MIT license.