ENRU
Download
DocsGuidesComparePricingQuestions Русский

What to do when something does not work

Short answers to common problems: what you see and what to do.

A session will not start

  • The “Claude Code required” window. Claude Code is not installed. Start the install: it runs in a tab.
  • “project folder not found”. The project folder was deleted or moved. Pick the project again in a new session.
  • A dimmed row and “session ended” in the terminal. The agent process exited. No need to close the session: type a message or click “Start”, and it comes back with the same conversation.
  • “Structured mode did not start, the session runs in the terminal”. Not an error. Hedoq switched to its fallback, and the work goes on.

The message did not reach Claude

The hint reads “The message did not reach Claude. It is back in the field: send it again”. Hedoq checks that each message landed in the conversation and returns the text if it did not. Press Enter once more.

The agent seems stuck

  • Look at the Mac: a macOS window asking for access or a password may be open, and the agent is waiting for it. The iPhone shows a note about it too.
  • No question card appeared: switch to “Terminal” under the message field.
  • To stop the turn: Esc or “Stop”.

macOS access is missing

  1. Gear, Agents block, “macOS access”.
  2. Click “Allow all” or the button on the row you need.
  3. If access was already denied, the “Settings” button opens the System Settings pane: turn Hedoq on there.

Dictation does not paste into other apps

It needs Accessibility. Without it, the text stays on the clipboard: paste it with ⌘V, and grant access in “macOS access”.

No voice

Click the mic: Hedoq offers to install the voice pack. If the microphone is turned off in the system, click “Settings” in the Hedoq window and turn on Hedoq in the Microphone list.

The iPhone is offline

  • The phone says Hedoq on the computer is offline: open Hedoq on the Mac. It has to be running.
  • The Mac went to sleep: turn on “Stay awake with the lid closed”.
  • A message says it was not delivered: tap it to retry.
  • After the Mac or the iPhone wakes up, the link comes back by itself within seconds.
  • The phone was unpaired: pair it again with the QR code. See iPhone.

The subscription limit ran out

The notch shows what is left, and you get a notification at 10%. Switch the model or the agent; see switching models. In automations, Hedoq hands the work to another agent by itself.

A long conversation and the agent gets confused

Click “Refresh session”.