Sesh Docs
sesh.codes
Guides › Notifications

Notifications

Know when an agent needs you or finishes, and answer from a notification, the Lock Screen, the floating chip or your wrist.

Sesh tells you when an agent asks for approval, asks a question, finishes a turn, or stops with an error. You can answer approvals without opening anything.

Choose what notifies you

Open Settings › Notifications. Under Notify me about:

Setting When Default
Approval requests An agent is waiting for you to allow something On
Questions from agents An agent asked you something and is waiting for the answer On
Finished turns An agent finished and it’s your turn On
Errors A session stopped with an error On
Agent messages An agent sent you a note (see below) On

These follow you to your other devices over iCloud.

Nothing is sent for the session you’re looking at. Banner style and sounds are in System Settings › Notifications › Sesh.

Answer from the notification

  • Approval notifications have Allow and Don’t Allow.
  • Finished-turn notifications show the start of the reply.
  • Click a notification to open its session.

A notification goes away by itself once it no longer applies, like when you answer on another device.

An approval notification banner on the iPhone Home Screen

Notes from the agent

Ask an agent to tell you about something, like “ping me when the tests pass”, and it sends you a notification in its own words when it happens.

  • It’s titled with the session’s name first, then the agent’s title, so you can always tell it came from an agent.
  • Clicking it opens the session. It has no buttons.
  • An agent can send a few at most, five in ten minutes, so it can’t flood you.

Sesh already tells you when a turn finishes, needs you or fails, so agents keep these for what you asked to hear about. Turn them off with Agent messages.

On your Mac

If you let it open at login (Sesh asks once, after setup), it starts with no window, and it stays in the menu bar after you close its window. That’s what keeps notifications coming. Both are in Settings › General: Open at login and Show Sesh in the menu bar.

The menu bar icon shows how many sessions need you. Click it for Needs You, Working and Recent, with Allow and Don’t Allow in place.

The floating chip

A small bubble in a corner of the screen, over every app and full-screen window, says how many agents are working. When one needs you, it opens into the approval or question, so you can answer without leaving what you’re doing.

  • Click Allow (or press ↩ once you’ve clicked the card), Don’t Allow, or Open in Sesh. Hold ⌥ for Always Allow and Never Allow.
  • Click the bubble for the sessions that need you and the ones working.
  • Drag it to any corner of any screen.

Set it up in Settings › General › Floating Chip: Show floating chip (Always, When Something Needs You or Never), Answer approvals in the chip, Hide while Sesh is in front, and Hide from screen sharing and recordings. Right-click the bubble for the same choices.

While the chip shows approvals, the Mac doesn’t also post notifications for them. Finished turns and errors still notify.

On iPhone and iPad

Notifications arrive even when Sesh is closed. There’s nothing to set up. Your machines send them through Sesh’s push service, encrypted so that only your device can read them.

Allow from the Lock Screen asks you to unlock first. The app icon’s badge counts the sessions that need you.

Live Activity and Dynamic Island

While sessions work, a Live Activity for each machine shows on the Lock Screen and in the Dynamic Island:

  • the sessions working, by name, and the one that needs you, with Allow and Don’t Allow for an approval
  • in the Dynamic Island, a ring that’s orange for what needs you and blue for what’s working; press and hold it to see which

When something needs you, the Live Activity lights up instead of a separate notification arriving. An approval still waiting after two minutes gets its notification too.

The updates your machines send it carry only counts, states and ids, because Apple’s system reads them on the way. Session names come from your iPhone, so a session started while Sesh was closed shows as “A session” until you next open Sesh. Turn it off in Settings › Notifications › Live Activity.

Widgets and controls

  • The Needs You widget lists what’s waiting on you, then the most recent sessions, on the Home Screen, the Lock Screen and the Mac desktop. Widgets show names and states, never what the agent wrote.
  • The New Session control opens Sesh on New Session from Control Center, the Lock Screen or the Action button.
  • Siri and Shortcuts can Start Session, Open Session and Get Sessions That Need You: “What needs me in Sesh”.

On Apple Watch

Sesh on Apple Watch lists what needs you and lets you answer. It reaches your machines by itself, over Wi‑Fi or cellular, so your iPhone can be somewhere else.

  1. On your iPhone, open the Watch app and install Sesh from Available Apps. Your machines come over from iCloud.
  2. Open Sesh on the watch. Sessions are grouped into Needs You, Working and Recent.
  3. Tap a session to page through them:
    • Waiting on approval: Deny or Allow.
    • Working: Stop, or Queue a Reply.
    • Finished: Reply by voice or with a quick reply, or Listen to hear the agent read its reply aloud, minus the code.
  4. + on the list starts a new session: pick a project and say what to do.

With AirPods in and Sesh open on the watch, a reply that just finished is read to you. Turn that off with Read replies with AirPods in, behind the speaker button on the list. Watch faces and the Smart Stack can show a ring of what needs you and what’s working.

Plans, and approvals that only offer “always”, have to be answered on your Mac or iPhone.

Good to know

  • Notifications that arrive while Sesh is closed say which session needs you, but not what the agent asked. Open the session to see it.
  • On the Mac, Sesh sends its own notifications while it’s running. Leave Open at login on so it always is.