Wysebee
Docs

Wysebee Agent for Android

Install the app that lets one Wysebee agent use your phone, turn on its accessibility service, pair it, and choose the apps it may use.

Overview

Wysebee Agent for Android is an app on your phone. You pair it with Wysebee, which creates a new agent for the phone. That agent, and only that agent, can then:

  • read the screen and take screenshots;
  • open apps, tap, type, swipe, scroll, and press back or home;
  • and, only if you switch on System UI, use the notification shade and quick settings —
  • always and only in the apps you tick on the phone.

It does this through an Android accessibility service, the part of Android that lets an app see the screen and act on it. You turn it on yourself, and turning it off stops the agent at once. The app runs no AI model: your AI app (Claude, ChatGPT, or the Wysebee website) does the thinking; Wysebee Agent carries out each step, in the apps you allowed. See the product page for a shorter tour.

Requirements

Phone
Android 11 or later
Google Play services
To scan Wysebee's pairing QR code. Without it, pair by typing a code instead.
Account
A free Wysebee account, at app.wysebee.com
Distribution
An APK from this site, not Google Play; about 3 MB

Install

  1. On the phone, download wysebee-agent-android-v1.0.1.apk: scan the QR code with the phone's camera, or open this page on the phone and tap the link.
  2. Open the download. Android asks once to let your browser install apps: tap Settings, turn on Allow from this source, go back and tap Install.
  3. If Google Play Protect says it has not seen the app before, choose More details › Install anyway.
  4. Open Wysebee Agent. It asks Google Play services for its QR code scanner straight away, so scanning is ready when you pair.

Turn on accessibility

The agent can do nothing on the phone until you turn on Wysebee Agent's accessibility service. On Android 13 and later, Android also blocks it at first for an app installed from a download: you allow that once, as a restricted setting, below.

Turn on the service

  1. In Wysebee Agent, tap Open accessibility settings. (Or open Settings › Accessibility yourself.)
  2. Find Wysebee Agent. It is usually under Downloaded apps (Pixel and most phones), Installed apps (Samsung), or at the end of the list. On Xiaomi phones, Accessibility is under Settings › Additional settings.
  3. Tap it and turn on Use Wysebee Agent.
  4. Android asks whether to allow it full control of your device and lists what it can do: tap Allow.
  5. Back in Wysebee Agent, Accessibility service says On.

If the switch is greyed out, or a Restricted setting message appears instead, allow the restricted setting first.

Allow restricted settings (Android 13 and later)

Android keeps accessibility away from apps installed from a download until you say otherwise, to protect you from apps you did not mean to trust. Allowing it for Wysebee Agent:

  1. Try to turn on the service once, as above. Android shows Restricted setting (“For your security, this setting is currently unavailable”). Tap OK. This step makes the option below appear.
  2. Open Settings › Apps (on some phones Apps › See all apps, or Manage apps) › Wysebee Agent.
  3. Tap the ⋮ menu at the top right (on some phones More), then Allow restricted settings.
  4. Confirm with your PIN, pattern, password or fingerprint.
  5. Go back to Settings › Accessibility › Wysebee Agent and turn it on: it is no longer greyed out. Tap Allow.
Allow restricted settings only lets you turn the service on; it gives Wysebee Agent nothing by itself. What the agent may then touch is still only the apps you tick in the app, and you can turn the service off at any time to stop it at once.

Pair your phone

  1. In Wysebee Agent, type a name for the new agent (1 to 60 characters, such as My Pixel).
  2. On a computer, sign in at app.wysebee.com, open Devices, choose Pair a device › Pair an Android phone. The dialog shows a QR code.
  3. On the phone, tap Scan QR code and point the camera at it. The phone is paired at once, and the dialog says which agent was created.

No camera, or no Google Play services? Tap Pair with a code on the phone instead. It shows a code like XXXX-XXXX: type it in the same dialog in Wysebee.

Pairing creates a new agent. If the name belongs to one of your Android agents that has no phone now, the app offers Reconnect to it instead: the agent keeps its settings and chats. A pairing QR code works once, for 10 minutes; open the dialog again for a new one.

The agent runs in Wysebee Cloud, so the phone needs nothing but Wysebee Agent. Talk to it from the Wysebee website, or from Claude or ChatGPT through the Wysebee Assistant connector.

Choose the apps

The agent may open, read and touch only the apps you tick. There is no “every app”, and Wysebee cannot change the list: it is kept on the phone.

  1. In Wysebee Agent, under Apps the agent may operate, tap Add apps….
  2. Tick each app the agent may use. Search narrows the list; apps you allowed already are ticked and greyed out.
  3. Tap Add. Remove beside an app takes it off the list again.
  • When an app that is not ticked is on screen, the agent can only press back or home, or open an app you ticked.
  • Banking, payment, investing and password apps are marked in the list: the agent never takes a screenshot of them, even when ticked, and reads them as text only.
  • Wysebee Agent itself is never operated, so the agent can never change what it may do.

Notifications (System UI)

System UI is Android's own screens: the notification shade and quick settings. It has a switch of its own at the top of Apps the agent may operate, off until you turn it on.

  • On, the agent can open the notification shade and read it, and use quick settings.
  • That means every app's notifications, including codes your bank texts you, and switches such as Wi-Fi, Bluetooth and airplane mode. Turn it on only if you want the agent to see them.
  • The lock screen is never touched, System UI on or off.

What the agent can do

  • List the apps it may use

    The apps you ticked, and whether System UI is on.

  • Open an app

    Only one you ticked.

  • Read the screen

    The app in front, as a list of what is on screen: each button, field and line of text, with where it is. A password field is never read.

  • Take a screenshot

    A picture of the screen, scaled down. Never of a banking, payment, investing or password app, and never of a screen the app itself protects.

  • Tap and long-press

    An element from the list, or a point on the screen.

  • Type

    Into a text field, replacing or adding to what is there, and press Enter if asked. Never into a password field.

  • Swipe and scroll

    Between two points, or through a list.

  • Press the phone's keys

    Back, home, recent apps, and (with System UI on) the notification shade and quick settings.

One step at a time: after each tap, type or swipe, the phone waits for the screen to settle before answering, so the next read sees the new screen.

How it works

Claude / ChatGPT / Wysebee website
        │  asks the agent to use the phone
        ▼
Wysebee Cloud ── runs the agent, queues the step
        ▲
        │  the phone asks for work (HTTPS, outbound only)
        ▼
Wysebee Agent on your phone ──  checks the step against what you allowed,
                                does it, sends back what it saw
  • The phone makes the connection, over HTTPS to Wysebee Cloud. It opens no port, so it works on any Wi-Fi or mobile network.
  • Each step is checked on the phone: paused, service off, phone locked, app not ticked, Wysebee Agent itself, a password field, a screenshot of a banking or password app — each is refused, with a reason the agent can read.
  • If the connection drops, it tries again after 2, 5, 15, then every 30 seconds.

Security and privacy

  • What the agent may use is kept on the phone and never taken from Wysebee Cloud. The cloud can ask; only the phone decides.
  • The link's secret is made on the phone and sealed with a key in Android's Keystore. Wysebee Cloud keeps only a hash of it, and the secret is never sent anywhere else.
  • Wysebee Cloud sees each step and what the phone answers: screen text and screenshots of the apps you allowed, kept until read and an hour at most. Nothing else is uploaded from the phone: not your other apps, not the list of apps installed.
  • Password fields are never read or typed into, and the lock screen is never touched.
  • Google Play services' QR code scanner shows its own camera screen; Wysebee Agent asks for no camera permission and receives only the code's text.

See the Privacy Policy for the full picture.

Pause, unpair, update

  • Pause: turn off Let Wysebee operate this phone. Every step is refused until you turn it back on.
  • Stop at once: turn off Wysebee Agent in Settings › Accessibility.
  • Unpair: tap Unpair. The link ends and the phone forgets the apps you ticked and the System UI switch. The agent stays in Wysebee; pair again and reconnect to use it.
  • Update: download the new APK from this site and install it over the old one. Your pairing and apps are kept. If the accessibility service is off afterwards, turn it on again.
  • Uninstall: unpair, then uninstall Wysebee Agent like any app.

Troubleshooting

“For your security, your phone is not allowed to install unknown apps from this source.”
Tap Settings, turn on Allow from this source for your browser (or file manager), go back and tap Install. You can turn it off again once Wysebee Agent is installed.
Google Play Protect says it has not seen this app before.
Make sure you downloaded it from this site. Then choose More details › Install anyway. If Play Protect offers to send the app for scanning, either answer is fine.
Wysebee Agent is greyed out in Accessibility, or says “Restricted setting”.
Android blocks this for apps installed from a download. Follow Allow restricted settings: try the switch once, then allow it from the app's ⋮ menu in Settings › Apps.
I can't find “Allow restricted settings” in the ⋮ menu.
It only appears after you have tried to turn on the accessibility service once and seen the “Restricted setting” message. Do that first, then open Settings › Apps › Wysebee Agent again. On some phones the menu is labelled More, or sits at the bottom of the page.
The app says its accessibility service is off, but I turned it on.
Some phones turn accessibility services off after an update or when they clear memory. Turn it on again in Settings › Accessibility. If it keeps happening, see the next answer.
The agent says the phone is offline.
Wysebee Agent has to be running with its accessibility service on, connected, and not paused. Let it run in the background: Settings › Apps › Wysebee Agent › Battery › Unrestricted (on Xiaomi phones also turn on Autostart).
“Google Play services is still downloading its QR code scanner.”
The scanner is fetched the first time Wysebee Agent opens. Wait a minute on Wi-Fi and tap Scan QR code again, or tap Pair with a code instead.
“That QR code is not one Wysebee is waiting for.”
A pairing QR code works once, for 10 minutes. In Wysebee, close the dialog and open Pair an Android phone again for a new one.
Pairing says the name is taken.
Type another name and scan again. If the name belongs to one of your Android agents that has no phone now, the app offers Reconnect to it instead: the agent keeps its settings and chats, and you choose its apps on the phone again.
The agent says the app on screen is one it may not operate.
That app is not ticked. Add it under Apps the agent may operate, or ask the agent to open one that is. For the notification shade, turn on System UI.
The agent says the phone is locked.
It can do nothing while the lock screen is up, on purpose. Unlock the phone, or let the screen stay on longer while it works.
A screenshot is refused.
Banking, payment, investing and password apps are never screenshotted; the agent reads them as text instead. Some other apps protect their screens from any screenshot (sign-in and payment screens, for example).

Support

Email support@wysebee.com or ask in the Wysebee Discord, where questions get answered and bugs get reported. Say which phone and Android version you have, and the version of Wysebee Agent (1.0.1).