ghost/wellbeing

Digital Wellbeing: today's screen time, per-app usage, set or remove a daily app timer. No account.

Runs Score 20/100 Official hard skill python

4actions not benchmarked yet

No clean demo yet. Recordings will start on HOME and show the app launching.

wellbeing

Demo shows: get_screen_time_today (no params)

Ghost in the Droid seed skill for Digital Wellbeing (com.google.android.apps.wellbeing). Preinstalled, no account.

ActionWhat it doesParams
get_screen_time_todayScreen time, unlocks, notifications todaynone
list_app_usagePer-app usage today, with timerslimit (default 20)
set_app_timerDaily app timer, multiple of 5 minutesapp, minutes
remove_app_timerDelete an app's daily timerapp

Install

pip install "ghost-in-the-droid>=1.6.0"   # 1.6.0 is not on PyPI yet: until it ships, git clone the repo and `pip install -e .`
ghost skill install ghost/wellbeing

Use

ghost skill run ghost/wellbeing get_screen_time_today --device emulator-5554
ghost skill run ghost/wellbeing set_app_timer --param app=Clock --param minutes=45 --device emulator-5554
ghost skill run ghost/wellbeing remove_app_timer --param app=Clock --device emulator-5554

From any MCP agent:

run_skill(name="ghost/wellbeing", action="list_app_usage", params={"limit": 3})
# {"apps": [{"app": "Settings", "used": "11 minutes", "timer": null, "timer_allowed": false}, ...]}

Tested on

Android 14 emulator (google_apis x86_64, 1080x2400, 420 dpi), Digital Wellbeing 1.6, en-US. Signed self-runs live in runs/.

Notes

An expired timer pauses the app until midnight; remove_app_timer undoes set_app_timer. License: MIT.

Known failure modes and versions tested

Versions tested

App versionAndroidDeviceSkill versionSigned self-runs (pass/total)Dates
1.6.52106862114Google/sdk_gphone64_x86_64 (emulator, 1080x2400, 420 dpi, en-US)1.0.08/82026-10-05

Untested so far: physical devices, other OEM skins, other screen sizes, other locales.

Recorded failures

None in the signed self-runs.

Popups and first-run screens handled

  • Notification permission prompt

Other known failure modes

  • Apps that were not used today are not listed and cannot get a timer from the Dashboard.
  • Pixel builds with Bedtime and Focus mode set up show more cards on the overview; the ids above are unchanged.

Try a sample prompt or run an action by name. Replace any parameters in braces with your own values.

get_screen_time_today

no demo yet

Try asking

  • How much screen time have I had today?
  • how long was I on my phone today
  • how many notifications did I get today
  • today's screen time
ghost skill run ghost/wellbeing get_screen_time_today

list_app_usage

no demo yet

Try asking

  • Which apps did I use most today?
  • show my app usage
  • how long did I spend in Clock today
  • top 5 apps by screen time
ghost skill run ghost/wellbeing list_app_usage

set_app_timer

no demo yet

Try asking

  • Limit Clock to 30 minutes a day
  • set a 1 hour timer on Files
  • give Notes a 45 minute daily limit
  • restrict Tasks to 15 minutes per day
ghost skill run ghost/wellbeing set_app_timer

remove_app_timer

no demo yet

Try asking

  • Remove the app timer on Clock
  • delete the Files timer
  • stop limiting Notes
  • clear app timer for Tasks
ghost skill run ghost/wellbeing remove_app_timer