Spelling

A misspelled word is flagged where you typed it, in any host, in any sentence. One press replaces it with the correction, and one more press gives back exactly what you wrote.

A misspelling dims where you typed it

No popup, no red underline, no dialog to dismiss.

You keep typing. A word that came back misspelled goes grey in place, and stays grey until you do something about it or edit it yourself.

i will recieve teh package tommorow

Three words flagged, one line. The grey says there is something here; it does not yet say what. Nothing has changed in your text.

The note says what the next press gives

It appears when the cursor reaches the word, and only then.

i will recieve teh package tommorow↳ ✍️ receive (underscore to correct)

Move the cursor off the word and the note goes with it. Only the word under the cursor can be changed by a press, so the other two are unaffected.

You seeIt means
✍️this word is a mistake. The mark is used for spelling and nothing else, so it never appears on a word that is merely open to improvement
✍️receiveone correction, so no count: the note names it, and the next press gives "receive"
was: recieveafter the press, what it was; one more press brings your word back
(underscore to correct)shown until you press once, then the hint reads revert

Your own word is always one of the stops

Which is why there is no undo to learn.

Type the linethe word dims
i will recieve the package
Cursor onto the wordthe note appears
i will recieve the package↳ ✍️ receive (underscore to correct)
Press _the word is replaced
i will receive the package↳ was: recieve (underscore to revert)
Press _your word is back
i will recieve the package↳ ✍️ receive

The rotation includes the word you typed, so pressing past the correction returns it character for character. Nothing is remembered, reverted or restored: your word never left the ring.

KeyDoesWhen
_next stopwith the cursor on a flagged word. No _ character is typed
Ctrl+Alt+↑next stopwhile the word is selected
Ctrl+Alt+↓previous stopthe only way back one step, since _ only goes forward

Away from a flagged word, _ means what it always means: fill in the blank.

What it leaves alone

A spell checker that flags your own vocabulary is one you switch off.

The shipped instructions name the cases to skip by category, so a line that is already correct comes back empty and nothing goes grey.

Left aloneExample
Proper nouns, place names, brand namesTokyo
Acronyms, assumed intentionalAPI
Numbers, codes, hex200
URLs and file paths/usr/bin
Single-letter wordsa, I
The blank character itself_
i visited Tokyo last summer and the API returned 200 from /usr/bin

Nothing in that line is flagged. Words your other cue files have claimed are left alone too, for a different reason: spelling never sees them.

Where the corrections come from

One ordinary file, seeded at install and yours to edit.

opencues install <host> writes it to ~/.cues/cues/spelling/CUE.md. It is a cue file like any other, and it is switched on from the moment it is written.

SettingValueMeaning
scopewordsit offers single words, not whole sentences
match.*every word in the line is a candidate
priority10the lowest of the shipped files, so it goes last

Those two settings work as a pair. Matching everything is what catches a typo in any sentence, whatever it is about. Going last is what stops it reaching a word another file wants: your project's own vocabulary, a client's name, a term of art. Each word is claimed by exactly one file, and spelling takes only the leftovers.

A word you spell your own way stops being a typo when you give it a cue file, rather than by adding it to a list of exceptions.

Nothing is added to your text

The grey and the note are painted over your line, not inserted into it.

What you send is what you typed, up to the presses you made. The mark, the note and the correction cannot be submitted, copied or saved with the text, because they are not in it.

No word changes without a keypress. A line with three flagged words and no presses is the line you wrote.