CleanYourPhone

Open source · Agent skill · Local app

Your phone,
minus the bloat.

CleanYourPhone is a local agent skill that disables preinstalled Android apps over ADB, with an optional app. It backs up first, reviews every package with you, and restores every change it recorded. No root, nothing uninstalled, no telemetry.

Open the skill Download for Windows

Free · MIT · No root · No telemetry · 156 profiles · 4 device-tested

CleanYourPhone · skill
AGENT SKILL Main product

Give it to your agent.

Read SKILL.md from
https://github.com/jparedesDS/cleanyourphone
and follow it exactly.
ADB only. Backup first.
Show me the plan before changing anything.
Give me the undo command.

Paste it in Claude Code, Cursor, OpenCode or any agent with shell access.

Skill first · app optional · CLI on GitHub

Choose your path

Use the skill. The app is in development.

The skill is the main product: give it to your coding agent and review the plan. The app will be the simple path for people who prefer buttons. The CLI is still on GitHub for power users.

Skill · Main product

Use the skill

Give it to Claude Code, Cursor, OpenCode or another agent with shell access. It backs up first, shows the plan before changing anything, and gives you the undo command.

Open the skill

Or and paste it in Claude Code, Cursor or OpenCode.

App · Early MVP

Download the app

The app is the simple path for people who prefer buttons over prompts. Windows 10/11 installer, tested on a OnePlus 6T. It backs up first and only continues on a supported, tested phone.

Download for Windows

Early MVP · Windows 10/11 · v0.2.0 · Connection guide

Prefer the terminal? The CLI is still on GitHub.

How it works

Three steps. You stay in control.

  1. 01

    Connect locally

    Open the repo, enable USB debugging and connect the phone. The tool checks ADB and the device before anything changes.

  2. 02

    Review

    Back up packages, roles and settings. Review DISABLE, ASK, BLOCKED and SKIP for every package. Nothing changes yet.

  3. 03

    Apply or restore

    Apply in batches of five. Verify. Restore exactly what the journal recorded; the backup is the fallback.

Optional extras: block many in-app ads with Private DNS (not YouTube) and measure free RAM and package counts before and after. Ads · Bench

Profiles

Start from evidence.
Not a forum post.

Each profile is a package list for one model and firmware. A device profile was tested on a real phone; a documented profile comes from a primary firmware dump and only asks.

  • Google
    5 profiles · Pixel 8 device-tested
  • 55 profiles · Galaxy S23 Ultra device-tested
  • Xiaomi
    15 profiles · HyperOS family device-tested
  • 56 profiles · Note, K and A families · documented only
  • 16 profiles · F, X and M families · documented only
  • 8 profiles · OnePlus 6T device-tested

Only a device profile on a tested build can auto-apply. Everything else is a reviewable starting point. Browse the 156 profiles ↗

Brand names and logos are trademarks of their respective owners.

Safety

Safe by design. Boring on purpose.

Disable, never uninstall

Only pm disable-user --user 0. No uninstall, hide, clear or root. pm enable is the undo.

Back up first

Packages, roles, IME, settings and getprop are saved before the first change. No backup, no changes.

Protected list and roles

Telephony, Play Services, WebView, permissions, emergency alerts, dialer, SMS, Home and keyboard are refused or checked.

Small batches, clear undo

Five packages, verify, then the next batch. The journal is exact; if it is lost, the backup reconstructs the change.

Runs locally: no CleanYourPhone-hosted service, no account, no telemetry. Read the safety rules ↗

FAQ

Short answers.

Is it safe?

Safer than a copied package list, but not magic. It never uninstalls, backs up first, refuses protected packages and role holders, disables in small batches and can restore every change the CLI recorded. You still review the plan and test calls, SMS, camera, keyboard, Home and notifications.

Does it uninstall anything?

No. The only state change is pm disable-user --user 0. No uninstall, hide, clear or root. pm enable is the undo.

What if something goes wrong?

Stop. Run restore if ADB still sees the phone. If the undo journal is lost, run restore --from-backup <folder> and review the list. If the phone does not boot, the recovery guide covers safe mode, ADB and recovery; factory reset is the last resort.

Why disable instead of uninstall?

pm uninstall --user 0 removes the package for the main user and can complicate OTA updates, factory-reset expectations or OEM restore flows. pm disable-user --user 0 freezes it in place and reverses with pm enable.

Does it work on tablets?

Yes, on Android 8+ with ADB. Tablet profiles set form_factor: tablet; a missing dialer or SMS role is a warning, not a failure. Home and keyboard checks still apply.

Is it free?

Yes. MIT license. No account, no subscription, no telemetry and no CleanYourPhone-hosted service.

Feedback

Send a bug, an idea or a phone checklist.

This form sends a message to the CleanYourPhone Discord. No automatic telemetry. Do not include serial numbers, IP addresses, IMEI or MAC addresses.

Review the plan. Keep the undo.

Give the skill to your agent. The app is still in development.

Open the skill Download for Windows