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 are free — no subscription needed.
• 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, 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 is free and available to everyone. If it's not showing, make sure the app is up to date and the agent's host is connected.

Voice input isn't showing up

• Voice input is free. It requires iPhone 12 or later and English as your device language.
• If it's still not showing, force-quit and relaunch the app.

Contact

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