Mobile and notifications

Install the app

Termdeck installs as a progressive web app, so there is no store download and no separate build to keep updated.

Turn on notifications

Go to Settings, then Notifications and enable push. Your browser asks for permission once. Termdeck then registers this device, so each phone, tablet, and desktop is subscribed separately and you can keep the phone loud and the desktop quiet.

Push needs a secure context. On termdeck.io that is always true. If the option says not supported, the browser itself lacks push rather than something being misconfigured.

What can notify you

Each is a separate switch. A reasonable starting point is approvals and questions on, turn finished off, because a finished run is something you go and look at while a blocked run is something that needs you now.

Approving from a notification

Approval notifications carry Allow and Deny buttons, so a blocked run can be unblocked without opening the app. Each notification carries a single use token that expires after 15 minutes, which is why answering an old notification asks you to open the app instead.

Notifications are always free, on every plan. Watching your agents and unblocking them is never something Termdeck meters.

In app alerts

Separately from push, the interface keeps its own count of everything that needs you: the bell in the sidebar, the badge on the tab title, and the Approvals page. All three are computed from one list, so they cannot disagree with each other.

What counts is deliberately narrow: a waiting permission, a waiting question or plan, and a turn that failed. A turn that finished cleanly and has not been opened yet does not count as something that needs you.

Using Termdeck on a phone

Everything is reachable on a small screen. The sidebar becomes a drawer, the transcript takes the full width, and the dock opens over it.

• Read a live transcript and follow tool calls as they run.
• Approve or deny anything waiting.
• Send a prompt, including a photo or a screenshot.
• Read the diff of what an agent changed.
• Stop a run that has gone the wrong way.
• Switch account when a rate limit is reached.

Dictation uses the browser's own speech recognition where the browser provides it, which keeps audio out of any upload path.

When notifications do not arrive

Nothing arrives on an iPhone

Almost always the home screen requirement. Add the site to your home screen from Safari's share menu, open Termdeck from that icon, and enable push there. A subscription created in a Safari tab does not carry over.

Then check iOS Settings, Notifications, Termdeck, and confirm alerts are allowed.

The switch turns itself back off

The browser denied permission. Reset the site's notification permission in browser settings and enable it again. A denied permission cannot be re asked for by the page.

They worked and then stopped

Browsers expire push subscriptions, particularly after a long idle period or a browser data clear. Toggle push off and on in Settings, then Notifications to register a fresh subscription for that device.

Some events notify and others do not

Check the per event switches. In particular, a run finishing in a terminal is a separate switch from a run you started in Termdeck, since many people want one and not the other.

They arrive late

Delivery goes through the browser vendor's push service, and aggressive battery saving on the device can delay it. On Android, exclude the browser or the installed app from battery optimisation. On desktop, keep the browser running rather than fully quit.