# Notifications

Foxora keeps you informed without getting in your way. Quick toasts surface what just happened, the Notification Center keeps the durable record, OS notifications reach you when you've stepped away, and attention prompts stop the line when an agent genuinely needs a decision from you.

## Toasts: what just happened

Toasts are the small cards that slide in (by default, bottom-right) to tell you something in the moment — a task finished, a command failed, a suggestion is ready. The card itself is calm and monochrome; the only colour is the icon that signals how much it matters:

- Success — a task completed; clears on its own after a few seconds.
- Error — something failed; stays until you deal with it.
- Suggestion — the agent proposes a change; stays so you can act.
- Warning · Info · Notice — lighter updates that auto-dismiss.

The stack is deliberately quiet. Only a few toasts show at once; the oldest transient ones step aside under pressure, while anything you must act on — errors, suggestions, running tasks — is never pushed out. Repeats of the same event coalesce into one card with an ×N count instead of stacking up.

### Live, process-aware toasts

When an agent kicks off real work, the toast becomes a live status card: a spinner, an elapsed timer, and a progress bar that fills as the work proceeds. The same card then morphs in place into a success or error when it’s done — no second notification, just the one card following the task through its life. Long-running tasks can show a Cancel affordance while they run.

## The Notification Center

Toasts are ephemeral; the Notification Center is the durable record. The bell in the sidebar footer carries an unread badge, and opening it shows recent notifications — every toast that has left the stack, persisted across reloads. Opening the Center marks everything read and clears the badge.

- Each row shows the kind icon, title, and a compact relative time (now, 5m, 2h, 3d).
- Rows that had an action stay clickable, so you can act on something you missed.
- You can mark all read, remove a single entry, or clear the whole history.

## OS notifications when you're away

When Foxora isn’t the focused window, the things that matter follow you out to the operating system. An error, or anything an agent is waiting on, raises a native OS notification — and on macOS, bounces the dock icon and sets a badge count of how many items need you. Focusing the window cancels the bounce.

Better still, the toast’s buttons ride along as native notification buttons. Clicking Approve or Decline from the OS notification runs the same action as clicking it in-app — the window focuses, and your choice is applied.

> You decide if OS notifications fireNative notifications need the notifications permission. Grant or revoke it any time from Settings → Permissions — without it, Foxora simply keeps everything in-app.

## Attention: when an agent needs you

Some moments aren’t just updates — the agent has hit a real fork and needs your call: approve a risky command, answer a question, confirm a plan. Foxora marks these as attention prompts, and they behave differently from ordinary notifications:

- They’re never auto-dismissed — they wait for you.
- They count toward the dock badge and, while you’re away, bounce the icon until you’re back.
- They carry the decision buttons — in the toast, in the Center, and on the OS notification.

This is the human-in-the-loop bridge: the agent keeps working until it reaches a decision only you should make, then surfaces it everywhere you might be looking and waits. Most of these come from action approvals — see approving agent actions for how those prompts work and how to tune how often they appear.

> Tune the noiseRaising an agent’s autonomy means fewer attention prompts; lowering it means more. The notifications themselves are always honest about what happened — adjust the flow from the composer’s autonomy control, and the OS reach from Settings.