Clean up and speed up an Android device, without root

android-cleanup-agent looks at what your Android phone, tablet or TV is actually doing, offers to remove or turn off the apps you never use, applies only what you approve, and shows RAM in use and storage free before and after. Every change it makes can be undone. A free command-line tool and a Claude Code plugin.

Get started   npm install -g android-cleanup-agent

Which devices

How it works

1. Connect: over USB, or over Wi-Fi with pair --host <ip> --code <6 digits> then connect --host <ip>. The ports are found automatically over mDNS.
2. Audit (read-only): installed apps, usage history, storage per app, memory per app, what wakes the device (alarms), heat, relevant settings and days since the last restart.
3. Interview: what feels wrong, whether it runs on battery or mains power, which features you use (Bluetooth, cast, location, voice, typing, camera, calls, SMS, alarms, screensaver, accessibility, email, photos) and your main apps.
4. Plan (deterministic): only packages in a curated YAML catalog are offered, plus apps you installed yourself and haven't opened in 90+ days, which are offered unticked. Apps used in the last 60 days are not offered. Unknown system apps are reported, never offered.
5. Approve: per category. Apps you installed and high-risk items each need their own explicit yes. A risk-judge sub-agent can veto an item, never add one.
6. Apply: a dry run unless you pass --yes. Each item is re-checked against the audited state right before it changes. Risky items are done alone and followed by a health check, with automatic rollback if it fails.
7. Restart (optional): reboot --yes, refused while something is playing.
8. Results and report: RAM in use and storage free before and after, as terminal output, Markdown, an offline HTML page, or a redacted summary you can share.

What it looks like

$ android-cleanup-agent doctor
$ android-cleanup-agent devices
$ android-cleanup-agent audit --summary
$ android-cleanup-agent plan --uses cast,typing --power mains --symptoms slow-menus
$ android-cleanup-agent approvals init
$ android-cleanup-agent approvals set --category google-apps=true --category performance=true
$ android-cleanup-agent apply            # dry run: shows what would change
$ android-cleanup-agent apply --yes
$ android-cleanup-agent reboot --yes
$ android-cleanup-agent results
$ android-cleanup-agent report --format html

With the Claude Code plugin you skip the flags: say "my Google TV is slow, help me clean it up" and Claude runs the same commands and asks you the questions. See the CLI reference for every option.

What it never touches

• The apps currently acting as your home screen, keyboard, dialer, SMS app, WebView, accessibility services or device owner. This is checked live, right before every change, not from a fixed list.
• A never-touch list of core packages: the Android framework, System UI, Settings, Google Play services, the Play Store, system data providers, Wi-Fi and network components, setup and update modules, certificates, Samsung Knox, Xiaomi Security and Find Device, and more.
• Your data. Apps are removed with pm uninstall -k --user <current user>, which keeps app data and only affects the current user, so restore can bring them back. Clearing an app's data is a separate command, for one app at a time, and is never part of a plan.

Read how safety and restore work.

Use it with Claude Code

/plugin marketplace add willcoliveira/android-cleanup-agent
/plugin install android-cleanup-agent@android-cleanup-agent

Then run /android-cleanup-agent:cleanup, or just describe the problem. How the plugin works.

Guides

• Remove bloatware from a Thomson Go TV without root (a real run)
• Speed up a slow Google TV without root
• All guides