| name | easy-english |
| description | Check how easy an English text is to read, and make it simpler. Measures vocabulary level and sentence length with the easyen CLI, then points at the exact hard words to reword and long sentences to break up. Use it when writing or reviewing English that should stay plain — docs, a README, error messages, release notes — or to hold your own writing at a chosen reading level. |
easyen
See how easy a piece of English is to read, by running npx easyen.
It gives you two simple signals — you decide what to change:
- Words — how many of the words are in a chosen word list, and which words
are too hard.
- Sentences — the average sentence length, and which sentences are long.
easyen only reports. It does not change your text. You decide which hard words
to make simpler and which long sentences to break up.
When to use
- You wrote some English and want it to stay simple for the reader.
- You want to find the hard words or long sentences in a text.
- You want to keep your writing at a level (everyday, academic, or technical).
How to run
No install needed — npx easyen gets the package on first run. It reads text
from stdin and prints JSON. Pipe the text in, using whatever your shell offers
(this follows the Unix convention, and works on macOS, Linux, and Windows
PowerShell / cmd). everyday is the default word list.
cat your-doc.md | npx easyen
Get-Content your-doc.md | npx easyen
If piping is hard on your system, read a file directly instead:
npx easyen --file your-doc.md --dict everyday,tech
Without it,
code blocks, URLs and HTML count as words, and the result is mostly noise —
on this project's own README that alone moved the ratio from 0.94 to 0.83.
