> ## Documentation Index
> Fetch the complete documentation index at: https://docs.worksong.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Notifications

> One inbox for what your Agents need from you, on every device.

Notifications is a list of everything Worksong sent to your phone, kept so you can also read it on the web and the desktop. If you dismissed a banner or you work at a desk, you do not lose it.

## Open the inbox

* **Phone:** the bell in the header of Home.
* **Desktop browser:** **Notifications** in the left rail.

The bell shows how many are unread. It shows "9+" above nine on the phone.

## What lands here

* An **approval** card from an Agent.
* A **message** from an Agent in a chat you were not looking at.
* A **task** that needs you (an Agent asked a question or escalated).
* A notice that an Agent used its daily limit of Computer and sandbox time.

A routine that ran quietly never sends a notification and is never listed. A message that your phone skipped (the phone shows at most one banner per chat per minute) is still listed here.

Rows older than 30 days are deleted. Rows of an Agent you deleted are not shown.

## Needs you

At the top, **Needs you** lists what is still waiting for you right now: pending approvals and tasks that need you, newest first. It is read from your open work, so a card you decided anywhere leaves this list at once.

* A simple card (a command, a sandbox command or a plain tool call whose whole ask fits on the row) can be handled on the row. Tap **Approve** to allow this one request, or **Deny**.
* Anything that needs more care shows only **Open**. That includes phone calls (you can edit the brief), tool or app access, secrets, spend requests, new Agents, messages sent outside, and writes to a connected app.
* A standing rule such as "Always allow" is never offered on a row.

Below it, **Updates** lists the other rows, grouped by day. Repeats from one Agent in one chat are one row with a count. Open it to go to the chat and mark them all read, or expand it to see each one.

## Read and unread

* A row opens where it came from: the chat, the approval or the task.
* A decided approval says **Approved** or **Denied**.
* Use the **All** and **Unread** chips to filter. **Mark all as read** is in the header. **Load older notifications** pages further back.
* What you handled anywhere counts as read everywhere. If you approve a card in the chat, its row is read on your other devices too.
* The app marks rows read only while the screen is in front of you.
* The icon badge on your phone follows the bell. The notification tray drops what you read.

## What a notification says

An approval notification has the Agent's name as the title and the ask as the text, for example "Run a command: npm run deploy" or "Send a WhatsApp message to Dana".

* If an Agent asks several times within two minutes, only the first one makes a sound. The next ones are silent and say "N requests waiting".
* On the third request for the same tool from one Agent in a day, the text ends with "Always allow is available". See [Approvals](/worksong/approvals.md).

## Allow alerts on your phone

In **Profile > Notifications** (desktop: **Settings > Notifications**) turn on notifications for this device. The browser does not show alerts: everything the app sends to a phone is kept in the inbox.

Web push alerts and per-kind preferences are not available.

<sub>Source: `worksong-ai/worksong:docs/adr/ADR-0019-notifications-inbox.md@9f0684f`, `worksong-ai/worksong:apps/mobile/src/features/notifications/NotificationsScreen.tsx@9f0684f`, `worksong-ai/worksong:apps/mobile/src/features/notifications/needsYou.ts@9f0684f`, `worksong-ai/worksong:apps/mobile/src/features/notifications/notificationList.ts@9f0684f`, `worksong-ai/worksong:docs/API.md@9f0684f`. Docs version: Worksong 2.0 with Work 1.2.</sub>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.