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

> ## Agent Instructions
> This handbook preview targets personal CLI 0.11.1. Check installed command help and the matching backend schema before using examples with another release. Examples with named people and placeholder IDs are fictional.

# Notifications

> Handle provider-change pointers, then acknowledge the ones actually resolved.

A notification points to a change at a connected provider. It is not the email, calendar event, or other original itself. Its saved title and time can become stale; open the referenced original under the returned account before deciding what work, if any, is needed now.

```sh theme={"theme":{"light":"github-light","dark":"vesper"}}
almanac notifications list --provider gmail
almanac notifications show NOTIFICATION_ID
almanac notifications ack NOTIFICATION_ID
```

`list` and `show` do not acknowledge. Use `--cursor` to continue a list with its original filters; `--all` includes already acknowledged items. `notifications count` counts unread pointers, not unfinished tasks. Once the original has been checked and any useful work recorded, acknowledge the exact handled ID or IDs. If the original is inaccessible, incomplete, or still needs action, retain that fact rather than treating a notification read as completion.

`almanac notifications ack --all-listed` applies only to IDs captured by the last list receipt for the same API, identity, and current session scope. It can fail when that receipt is absent or empty, and it can cover more than the item you just examined. Exact IDs are clearer for selective work. A past alert cannot establish that the provider object is still in that state. [Email](/integrations/email) and [calendar](/integrations/calendar) explain how to read common originals; [session review](/work/review) has its own version checkpoint and is not affected by notification acknowledgment.