DocsAccount & data1 min read

Troubleshooting

Fixes for the most common problems.

"Hex can't be opened" / "can't check it for malicious software"

Control-click Hex in Applications, choose Open, then Open again.

The model is slow

  • Pick a smaller model, or one rated Great fit in Customize → Built-in models.
  • Close other apps that use a lot of memory.
  • Lower Thinking under the message box, or turn it off.

A model won't load or the engine won't start

Open Customize → Built-in models. The card at the top shows whether a model is running and any error. Free up disk space if a download failed, then try again.

The agent keeps asking for approval

That's your permission setting. Switch to Auto mode, choose Always allow on the step, or change the tool in Customize → Agent → Permissions.

A tool was denied

In Plan mode, nothing is changed until you approve the plan. Otherwise check the tool's permission in Customize → Agent → Permissions.

The chat got long and answers got worse

Type /compact to summarise older messages, or start a new chat. The context meter under the message box shows how full the model's context is.

Sync isn't working

Sync needs Pro and you need to be signed in (Settings → Account). Check your plan in Settings → Billing, then click Sync now.

I deleted a chat by mistake

Restore it from Settings → Privacy → Recently deleted within 30 days.

Still stuck?

Email jangidp318@gmail.com and include your Hex version from Settings → About.

Something unclear or out of date? Email jangidp318@gmail.com.

Troubleshooting · Docs · Hex