← Back to Varterm

Questions and solutions

Short answers for the things that usually go wrong. The first ones are the Cursor Agents window — Varterm cannot put a button there — and how Replay Agents reads the thread you select there, including its plan.

On this page

Cursor

Why is there no Varterm bar in Cursor’s Agents window, and why don’t I hear replies there?

Cursor does not run third-party extensions inside the Agents window, so Varterm never appears there and cannot play from that window alone. Open an editor window (Command Palette → Open Editor Window or Open IDE), install Varterm TTS, and turn on Agents window in that editor’s status bar. Keep the editor open — it can sit in the background — and it will read every finished Agents-window reply. The next reply plays automatically. To hear one that already finished, or its plan, select that agent thread in the Agents window and press Replay Agents in the editor.

How do I replay a chat from Cursor’s Agents window?

Select the agent thread in the Agents window, then press Replay Agents in the editor status bar (the Agents button, or ⌘⇧⌥W / Ctrl+Shift+Alt+W). That always reads the thread you selected there, even if a sidebar tab is in front. If that thread just wrote a plan, it reads the plan; otherwise it reads the last reply. The speech-bubble last-reply button is different: it follows whichever chat is in front, so a sidebar tab can play instead. Keep an editor open. There is no Varterm button inside the Agents window itself.

How do I hear a Cursor plan?

Select the agent thread in the Agents window, then press Replay Agents in the editor (or ⌘⇧⌥W). If that thread still has a pending plan, or the plan is newer than the last chat line, Varterm reads the plan file instead of “created a plan.” You can also open the plan as a text file and press Play, or press the selection button while the plan tab is in front. Keep an editor open so Replay Agents has a place to run.

Auto-read is on, but nothing is speaking.

The reply is captured even when nothing plays. Check that an editor window for that project is open and that Auto-read is on in that window, not only in another project. If you work in the Agents window, that editor also needs Agents window turned on. A paused listen holds the speaker and queues later replies until you press Play or Stop. After installing or updating, reload every Cursor window.

I pressed Play and it read a plan instead of the agent reply.

Play prefers what is in front: a highlighted plan, a selection, or a fresh copy, then the last agent reply. That is expected when a plan tab is showing. To hear a plan from the Agents window on purpose, select that agent thread there and press Replay Agents. The speech-bubble last-reply button reads the chat in front, which can be a sidebar tab. The Agents window switch only turns auto-read on or off; it does not start a read.

Chrome

How do I hear new AI chat replies in Chrome?

Auto-read is off until you turn a site on in the extension popup. Chrome then asks for access to that site. Reload the tab once after you approve. Existing replies stay quiet; only new ones play.

Web

The site or an extension says speech synthesis failed.

That message means the cloud voice request did not come back as audio. Try Play again, or switch to an offline Piper voice on the site. If it keeps failing, send a note from the support page with the voice you picked and whether you were on the site, Cursor, or Chrome.

Still stuck

Send a support note · Cursor setup · All extensions