Troubleshooting and FAQ
Find your problem below. Each answer says what is happening and what to do about it.
When a rewrite does not land
When a rewrite fails PlainSpeak's checks, you see The rewrite didn't land. above the rewrite panel, with the reason. Your text is kept exactly as it was, so you lose nothing. Select Try again to run the same rewrite again.
The rewrite read more generated than your text
What is happening: the model added more wording tells than your draft had, so PlainSpeak kept your text. The message shows the two counts, your draft's first.
This check counts wording tells only: stock AI phrases, jargon, clichés, connectors such as "furthermore", and the "not just X, it is Y" antithesis (a plain "not only X but also Y" is not counted). It does not count em dashes, sentence rhythm or how the piece closes, because PlainSpeak takes the dashes out of every rewrite itself and rhythm is not something a rewrite adds word by word. One extra tell is allowed, or a tenth of what your draft had, whichever is larger.
What to do: select Try again. If it happens again, open the recipe and pick a different model. Models from a different family than the one that wrote your draft usually do better.
Only some of the words came back
What is happening: the model returned far fewer words than you sent, so most of your copy would have been lost. Some models shorten text even when asked not to.
What to do: select Try again, or choose a different model in the recipe. For a long piece, a model with a larger context window helps.
The model returned the text unchanged
What is happening: the model sent your text back without fixing anything.
After a Fix, this is a result, not a failure. A Fix may keep a flagged word the sentence needs, such as a hedge that carries real uncertainty, and the model kept every one. PlainSpeak says "Nothing changed: the model kept ... as needed", leaves your rewrite as it is, and stops offering a Fix for those words on that copy. Edit the copy and the Fix comes back.
What to do: after a Fix, nothing, unless you disagree with the model: then edit the words yourself. After a rewrite, select Try again, and if the model keeps doing it, choose a different one in the recipe.
The model returned nothing
What is happening: the model's reply was empty. This is usually a passing problem with the model or the provider.
What to do: wait a moment and select Try again, or choose a different model.
The stream from the model failed partway
What is happening: the connection to your provider dropped while the rewrite was arriving.
What to do: check your internet connection, then select Try again.
Keys and providers
API key rejected
Your provider did not accept the key. Open Settings, check that Provider matches the company the key came from, and paste the key into API key again. Keys are easy to copy with a missing character.
No API key set
Rewriting needs a key from an AI provider. Add one in Settings, on the Account tab. See Get started.
Out of credits
Your provider account has run out of credit. Top it up with your provider. For OpenRouter, that is at openrouter.ai.
Rate limited
Your provider is limiting how fast you can send requests. Wait a minute and try again.
Model not found
The model in your recipe no longer exists, or its name has changed. Open the recipe and choose a model from the list.
No response in time
The model took too long to answer. Try again, or choose a faster, cheaper model in the recipe. Very long pieces take longer.
Why do the audit and Find sources need OpenRouter?
Both pick models from OpenRouter's catalogue: the audit chooses two from families other than the one that wrote your rewrite. They only run when OpenRouter is your provider, so your text and key never go to OpenRouter unless you chose it.
Your free trial
A card appeared instead of a rewrite
Until you start your free trial, nothing that uses AI runs. Selecting Rewrite, Fix these N, Run audit, Find source or Check opens the licence card instead, headed 7 days of everything, free, with a button that names what you selected, such as Start the trial and rewrite. Select that button: the 7 days begin and the action you asked for runs. Starting the trial is that one press, and nothing was sent to your AI provider before it.
The card also takes a licence key or purchase code, and Keep editing by hand closes it. You can start the trial from Settings too, in the Licence section, where there is nothing to resume, so the button reads Start the trial.
Start the trial says to add my API key first
You see Add your API key first: the trial runs on your own key. The 7 days run as a clock that cannot be restarted, and every AI feature uses your own provider key, so PlainSpeak does not start the trial while there is no key for it to run on. Nothing was started, and none of your 7 days was used. Add your key in Settings, on the Account tab, then select Start the trial again. See Get started.
I expected a free trial and there is none
The trial is for a computer with no working licence key saved. There is no trial for a licence whose updates do not cover this version: the button beside the gear reads Free: scan and edit, the Licence section in Settings says which versions your key covers, and the way back to rewriting is a new licence, $59 once, with every update released in the next 12 months.
A key made for a newer version of PlainSpeak is a different case. PlainSpeak refuses that key as you paste it, saying That key is for a newer version of PlainSpeak. Update the app, then paste it again. Nothing is saved and your trial is untouched, so if you had not started it, Start the trial is still there. Update PlainSpeak, then paste the key again.
A trial you have already used up does not come back, and selecting Start the trial again cannot extend one that is running.
Your licence
Rewriting is locked
Scanning is free. In the desktop app, rewriting, fact checks and source checks need either a free trial you have started or a licence.
- If the button beside the gear reads Free trial: ready to start, select it, then select Start the trial in the card.
- If it reads Free: scan and edit, the trial has ended, or your licence does not cover this version. Add your licence key or purchase code in Settings, on the Account tab, then select Save licence. See Get started.
That key is not valid
Paste the whole key, exactly as your key page shows it. Copying a key from an email or a chat can add or drop characters.
That purchase code was not recognised
Paste the whole code from your Polar receipt email. You can also paste the licence key from your key page instead.
Could not reach the key service
A purchase code is checked online once. Check your internet connection and try again in a minute. A licence key needs no connection.
I lost my licence key
Your purchase code works in its place. It is in your Polar receipt email, and in your purchases on Polar, where you sign in with the email you bought with. There, Copy shows the code, and Rotate replaces it with a new one if you think someone else has it.
My licence covers versions up to a date
Each licence includes the versions released in the 12 months after you bought it. A version released after that needs a new licence. You can keep using any version your licence covers, as long as you like.
Your licence key is for a newer version of PlainSpeak
Your key was made for a newer PlainSpeak than the one installed. Update PlainSpeak, then paste the key again.
Bringing in text
A link will not import
PlainSpeak can only fetch pages anyone can open. For a Notion page, open Share in Notion and set it so anyone with the link can view. If it still fails, copy the text from the page and paste it in.
A Word file will not open
PlainSpeak opens Word files saved as .docx, up to 10 MB, with up to 1 MB of text. The message names the limit a file went over. An older .doc file does not open: open it in Word and save it as .docx first. A file that says This is not a Word file PlainSpeak can open (.docx) is usually another kind of file renamed to .docx; one that says it could not be opened as a Word file may be damaged. Either way, open it in Word and save it again as .docx.
That's a lot of text
One rewrite takes up to 512 KB of text, which is far more than most pieces. Split very long documents and rewrite them in sections.
Installing, updating and starting
Windows protected your PC
Windows shows this for software from a publisher it has not seen many downloads from yet. Select More info, check that the publisher is The KAM Coach Ltd, then select Run anyway. If the publisher shows anything else, do not run the file.
How do updates work?
PlainSpeak checks for updates by itself and downloads them in the background. When one is ready, a bell appears at the top right. Select it to restart and install now, or leave it for later: closing PlainSpeak never installs anything, and the next time you open it, PlainSpeak asks once whether to install the update. Your draft and your History are kept. Windows may ask for your permission before it installs. To check by hand, open Settings, and on the Account tab select Check for updates.
Version 0.6.0-beta.1 or beta.2 does not update itself
Those two early versions shipped without the file updates need. Download and install the newest version once from the downloads page. From then on PlainSpeak updates itself.
PlainSpeak could not start
If PlainSpeak shows PlainSpeak could not start., select Copy diagnostics and paste the result into an email to us. Open log folder shows the logs, which are in %APPDATA%\PlainSpeak\logs on Windows and ~/Library/Application Support/plainspeak/logs on a Mac.
Questions
Side by side shows the two stacked
Side by side needs a window about 1,160px wide or wider. When yours is narrower, the Side by side button is greyed, and its tooltip says Needs a wider window. Make the window wider and side by side comes back by itself. Your choice is kept in the meantime.
My paste lost its formatting
Copy puts the rewrite on the clipboard twice: formatted, and as plain text. A box that takes only text, such as a plain text editor or a form, uses the plain text, and Copy as decides whether that keeps the Markdown. If the note beside Copy says Copied as plain text. or Copied as Markdown, without formatting., the formatted copy was refused: select Copy again, or select Download .docx and open the file.
Why are there no em dashes in my rewrite?
Readers now take the em dash as a sign of AI writing, so PlainSpeak takes em dashes out of a rewrite, even when a model writes them. The reason is readers, not detectors: some detectors ignore em dashes on purpose. Quotations and code are kept exactly as written, dashes included.
Does PlainSpeak send my writing anywhere?
Only to the AI provider you chose, when you rewrite. Scanning happens on your computer. See exactly what PlainSpeak sends, and where.
Does a clean score mean my text will pass an AI detector?
No. The score counts wording a reader is likely to notice. PlainSpeak makes no claim about what a detection service would say. Detectors also flag text that people wrote, and they change without notice, so no tool can promise a pass.
Is a rewrite just a paraphrase?
No, though they share the idea of changing the words. A paraphraser changes the words and stops there. A Rewrite is aimed: before it runs, the scan names the phrases a reader is likely to notice, and the model is asked to fix those, keep every fact, keep your point of view, and leave sharp passages alone. Afterwards PlainSpeak checks the result: numbers, names, links and quotes against your original, the tells again, and how far the style moved.
We measured the difference on 18 machine drafts. The same model, asked plainly to rewrite them and keep the facts, left the tells at 10.9 per 1,000 words (the drafts had 10.2), dropped two facts and invented two. PlainSpeak's Rewrite cut the tells to 2.2 and kept all 120 checkable facts. The plain paraphrase changed more of the wording: 29% of its four-word runs also appear in the draft, against 52% for the Rewrite, because a Rewrite keeps what already works. One result cuts the other way: two blind judge models rated the plain paraphrase as human or more so. If you want even less change, use Polish, which kept 91%.
I need more help
Email [email protected]. If something went wrong, say what you did and what you saw. Never include your API key or licence key.