Notifications

Statefold tells you when a thread needs you or stops working while you are away, and the notification carries what the agent actually said, so you can often decide without opening it.

Turn them on

Open Settings → Notifications.

• Email sends to your verified account email.
• Browser push applies to the browser you enable it in. On a phone, install Statefold to the home screen first; some browsers, such as Brave, need push messaging enabled in their own settings.

Events

• Needs you: a thread has a question only you can answer.
• Idle while away: a thread stops working while you are away, including when it fails.

Away is based on whether you have Statefold open and in focus. Each newly finished turn notifies at most once; history, stopped turns and metadata refreshes stay quiet. Newer pushes for a thread replace older ones.

What a notification says

The thread title and the start of the agent's reply, the failure reason, the limit and its reset time, or the open question and its options, plus a linked pull request's number and check state. Turn off Show message content in notifications to receive only the title and status.

Per project

Thread details → Defaults and secrets → Project notifications overrides each event for one project: Use account setting, Enabled or Disabled.

Subscription turns do not notify on their own; the agent can call notify_owner when something deserves your attention. See Schedules and subscriptions.