tokenstat
tokenstat
Desktop app

Set up remote screen access

György
Reviewed by
György
Updated Sep 10, 2026 1 min

Remote screen access is a Legend feature. Before connecting, tokenstat checks that both devices are signed in and paired, the host is online, the requesting device has an explicit grant, the operating-system capture permission is enabled, and incoming files have a destination.

On the host, open Devices → Screen access and enable View for the requesting device. Enable Control only when that device should send pointer and keyboard input. View-only access needs Screen Recording on macOS. It does not need Accessibility. Control additionally needs Accessibility.

If access has not been granted, the viewer can send a fixed, content-free request. The notification contains no screen image, window title, filename, command, or user-entered text. It asks the host owner to open tokenstat and review the per-device permission card.

The session is encrypted between the two device identities. A direct connection is used when possible. Otherwise the relay forwards encrypted bytes it cannot decrypt. Closing the viewer ends its session. Revoking View immediately ends screen and file-transfer access for that device, while revoking Control leaves view-only access intact.

A direct connection does not use the hosted relay. tokenstat tries a direct path first. When the relay is needed, all relayed traffic shares one rolling 30-day allowance: 100 MiB on Free, 1 GiB on Supporter, 5 GiB on Patron, and 20 GiB on Legend. The window is today plus the previous 29 UTC days. Older usage leaves the window as those days pass. This is not a daily refill. Remote screen remains Legend-only, one relayed screen session at a time, and up to ten minutes per relayed session before reconnecting. See pricing and the terms.

Incoming files default to Downloads/tokenstat on macOS and Android and the Files-visible tokenstat folder on iPhone and iPad. You can choose another destination before receiving anything.

More in Desktop app

Set up the tokenstat desktop app
Install the Mac app, add a project folder, launch an agent, and find your usage reports. Local work needs no tokenstat account.
Run agent sessions in a workspace
A workspace is a folder with a file tree, a git history, and a session launcher. Here is how to add one, start an agent in it, run several at once, and review what they changed before anything is committed.
Plan limits on your dashboard
The app can tell your account how much of each plan window you have used, so the website shows the same figure as the window on your desk. What travels is a percentage and a reset time, nothing about what you ran.
Keep a Mac or Linux host available for remote work
Install the host, keep it running, approve devices, and troubleshoot remote access from another computer or phone.

Human-led and verified · AI-assisted content · AI tools may help draft, edit, maintain, and improve grammar or clarity. Nothing is published automatically; every change is reviewed by the human maintainer.