Troubleshooting

No suggestions appear

Go through these in order:

1. Is the model still downloading? The menu bar icon shows a percentage while it does. Suggestions start when it finishes.
2. Is Lyra paused? Click the menu bar icon and check Quick controls says Active, for Lyra overall and for this app.
3. Is this app switched off? Check Settings → Apps & rules. Terminals and code editors are off by default; see the list.
4. Is Accessibility still allowed? If not, the menu bar icon says “Lyra needs Accessibility permission”. Fix it below.
5. Are you writing in another language? Without Lyra Cloud, non-English text gets no suggestion. Why.
6. Has your trial ended? The marker says “Your Lyra trial has ended”. Your options.
7. Was the text very short, or already right? Lyra waits for a few words, and stays silent when it isn't sure it can improve something.

Tab doesn't accept, or moves to the next field

This almost always means macOS has dropped Lyra's Accessibility permission. That can happen after a macOS update. Without it, Lyra can't see your text or catch the Tab key, so the key goes to your app instead.

1. Click the Lyra icon in the menu bar. If you see Grant Accessibility Permission, click it.
2. In System Settings → Privacy & Security → Accessibility, make sure Lyra is switched on.
3. If Lyra is listed and on, but still doesn't work: select Lyra, click − to remove it, then add it back with + (or drag it in from Applications).
4. Quit Lyra from the menu bar and open it again.

The model download fails

• “Not enough disk space” means Lyra needs room for the model plus 500 MB: about 1.6 GB on 8 GB Macs, 3.5 GB on 12 GB or more. Free some space and reopen Lyra.
• “Download interrupted” means your connection dropped. Check your Wi-Fi or VPN, then quit and reopen Lyra to resume.
• “The download was corrupted” means the file didn't arrive intact. Quit and reopen Lyra to download it again.

The suggestion is in an odd place

Lyra places its marker beside your cursor using the position the app reports. Some apps don't report where the cursor is, and then Lyra places the marker at the edge of the text box instead. Either way, keep typing or press Esc and it's gone. If an app gets it consistently wrong, tell us which one.

A suggestion changed something it shouldn't have

• Lyra never applies a suggestion until you've opened it with Tab, so you can always read it first, and ⌘ Z undoes an accept in most apps.
• If it keeps “correcting” a name or a word you use on purpose, add it to your personal dictionary.
• If it makes you sound stiffer than you are, please send us the example. That's exactly the kind of mistake we're fixing.

My Mac feels slower

The writing model uses about 1.5 GB of memory while you write, and Lyra gives that memory back when you stop. If your Mac keeps running short of memory, Lyra switches itself to a lighter model for a week, then tries again. If your Mac still feels slow, quit Lyra from the menu bar to compare, and tell us which Mac and how much memory it has.

Still stuck?

Click the Lyra icon in the menu bar and choose Chat to founder. Switch on Send logs so we can see what happened. Lyra removes the text of your messages from the logs before sending. You can also attach a screenshot. Or email founder@heylyra.co.uk; the person who reads it wrote the code.