Support

For setup and how-to walkthroughs, see the getting started guide. This page covers common problems and how to fix them.

Troubleshooting

My computer isn't showing up in the app

• Make sure the Hearth daemon is running on that computer:

hearth host status

• If it's not running, start it:

hearth host start

• Confirm you signed in to the same email address on both the computer (hearth login) and the app.
• Check your internet connection on both devices.

An agent won't start

• Confirm the daemon is running:

hearth host status

• Make sure the AI software the agent uses (e.g. Claude) is installed on the computer and working. Try running it directly from the terminal to confirm.
• The daemon log path is shown in the output of hearth host status — check it for error messages.

I'm not getting push notifications

• Push notifications require a Hearth Pro subscription.
• On your iPhone, go to Settings → Hearth → Notifications and confirm notifications are enabled.
• If you use Focus modes, add Hearth to the allowed apps list, or enable Time Sensitive notifications for Hearth so critical alerts get through.
• If the Hearth app is open on your screen, requests arrive silently via the app connection — push notifications are only sent when the app is in the background.

The agent keeps asking for the same permissions

• Tap Always Allow instead of just Allow. This creates a rule so that type of action is approved automatically in the future.
• Check the Grants tab for that agent to see existing rules and confirm they're set up correctly.

A request timed out

• Requests time out after about 10 minutes if no response is received. The agent will not proceed — the action is denied by default on timeout.
• If you're missing requests, make sure push notifications are enabled (Pro), or keep the app open in the foreground while agents are running.

The daemon stops when I restart my computer

• The Hearth daemon does not start automatically on reboot. Run this after restarting:

hearth host start

• To have it start automatically, add hearth host start to your shell profile, or set up a launchd (Mac) or systemd (Linux) user service.

Talk to Agent isn't available

• Talk to Agent requires a Hearth Pro subscription.

Voice input isn't showing up

• Voice input requires Hearth Pro, iPhone 12 or later, and English as your device language.
• If you just subscribed, force-quit and relaunch the app.

Contact

Can't find your answer here? Email support@vergelabs.org and we'll get back to you.