Troubleshooting & Known Issues
Separate capture, recognition, refinement, delivery and execution. Preserve useful drafts and inspect the original conversation before repeating uncertain sends.
A useful starting route
All articles in this collection
Update log
CueSpec release notes and update history: Mac versions, fixes, update guidance and clearly labeled work in progress.
Recording starts, but no useful audio is captured
If recording starts but produces no usable speech, check the input device and microphone access before changing text-refinement settings.
Fn does not start recording
When Fn does not trigger recording, check the active app copy, permission state and shortcut setup.
The first words of a recording are missing
Missing opening words can arise before recognition or during transcription.
The transcript changes important words
If the transcript changes meaning, correct it before sending and identify whether the error comes from capture, recognition or optional refinement.
Other people’s words appear in the draft
Background words in the draft indicate that the capture/recognition route included surrounding speech.
A headset disconnects or the input device changes
After an input device disconnects, verify the active capture route before recording again.
Transcription takes longer than expected
Determine whether you are waiting for local transcription, optional refinement or message delivery.
Optional text refinement is unavailable
Optional refinement requires a configured CueSpec Server and login.
A late transcript appears in an unexpected draft
If text appears in an unexpected draft, stop before sending.
A send result is waiting for confirmation
An uncertain send retains the draft while its receipt is checked.
The original conversation is unavailable for sending
If the target conversation is unavailable, open it in Codex and recheck before retrying.
An older version reports that sending requires a cloud host
The development history records an older send-path error stating that a cloud app-server host was required.
A message seems to appear twice
Check whether the issue is duplicate display or two actual submissions before sending anything else.
Known issue: the Codex question card stays open
A known integration issue can leave Codex’s original structured-question card open after a reply from CueSpec arrives.
A task is missing from the list
Check the all-task view before assuming a conversation is missing.
A task state looks stale or contradictory
Compare CueSpec’s state with the original Codex conversation before deciding that work is complete or sending a new instruction.
An update check, download or installation fails
Identify whether the failure is checking, downloading or installing.
macOS shows an unexpected installation warning
The published Mac 0.3.0 package is Developer ID signed and Apple notarized.