Cycling

With the cursor on a flagged word, _ replaces it with the next alternative, in place. The cursor stays at the end of the changed word.

Cues: alternatives on words you wrote

A flagged word dims

No popup or prompt; the word dims while you continue typing.

i will recieve the package

Moving the cursor onto the word shows the note underneath: what the next press gives. Moving off, or editing the word, removes it.

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

What you submit is exactly what you typed: the note is painted, never part of your text, so it cannot be sent or copied.

Reading the note

One format, whichever cue produced it.

You seeIt means
✍️receiveone correction: no count, the note names it. ✍️ marks a spelling correction
was: recieveafter the press, what it was; one more press brings your word back
(underscore to correct)the hint is a verb: correct, fix, apply, then revert once the next press restores your word. Cycle appears only with three stops or more, until you first cycle that note
⚠the 15th is a Fridayan emoji marks a detected problem; no emoji means an optional improvement
3| Improve formalitythree stops or more keep a count; a list after it rotates as you cycle, always showing what the next press gives

The keys

KeyDoesWhen
_next alternativewith the cursor on a flagged word; no _ character is typed
Ctrl+Alt+↑next alternativewhile a word is selected
Ctrl+Alt+↓previous alternativethe only way back one step; _ only goes forward

Off the word, or once you edit it, _ reverts to its normal meaning: a blank request.

Worked example

Two stops: the correction, and the word you typed.

Write the sentenceone word dims
i will recieve the package
Cursor onto the wordthe note appears
i will recieve the package↳ ✍️ receive (underscore to correct)
Press _the correction
i will receive the package↳ was: recieve (underscore to revert)
Press _back where you started
i will recieve the package↳ ✍️ receive

The word you typed is always one of the stops, so cycling returns to it; no undo gesture is involved. The count never reaches zero.

Multiple flagged words per line

Each carries its own alternatives.

i will recieve teh package tommorow

Three flagged words in one line, each with its own note when the cursor reaches it. Only the word under the cursor is affected by a press.

Multi-word alternatives

A phrase is one unit.

sorry i cant make the meeting tomorrow↳ 4 | Improve formality

The cursor anywhere inside the phrase selects the whole of it, and one press replaces all of it. Whole sentences are offered and cycled the same way.

Where the alternatives come from

Cue files, one per subject.

Alternatives come from cue files under ~/.cues/cues/, one per subject. Each declares which words it matches, and the model is asked only about those; a file never sees words another file claimed. The shipped spelling cue claims any word no other file wanted.

No request is made until a word matches, and no word changes without a keypress.