Universal ADB Debloater • No Root Required

Clean & Speed Up Any
Android Phone via ADB

Automated rollback snapshots, zero personal data loss (-k flag), and 320+ curated OEM debloat rules. Built for AI coding agents and CLI developers.

ADB User 0 • USB & Wireless • Non-destructive

1 Connect Phone (USB or Wireless Debugging)

Enable Developer Options (tap Build Number 7 times) → turn on USB Debugging or Wireless Debugging → accept "Allow debugging" prompt on phone.

2 Copy 1-Click AI Debloat Prompt

4-Step Safe Prompt Scan • Dry-Run • Auto-Snapshot • Zero Data Loss

3 Paste & Run in Any AI Assistant

320+

Curated OEM Rules

61 Pkgs

Protected Core Sentinel

0% Loss

User Data Intact (-k)

0 Root

Safe User 0 Execution

Workflow & Verification Pipeline

Deterministic, verifiable execution. Every action is simulated before making any change to your device.

$ python scripts/debloat-engine.py scan

Queries device properties via ADB, indexes all user-0 packages, and categorizes into safety tiers.

ADB Discovery & Device Detection
---------------------------------
[OK] Connected: Samsung Galaxy S24 Ultra (Android 15, SDK 35, aarch64)

Scanning installed packages for user 0:
Total: 382 packages found (358 enabled)

Safety Tier Breakdown:
  Tier 1 (Safe Bloat):     42  -> Safe to disable/remove
  Tier 2 (Advanced):       18  -> Assistants & cloud sync
  Tier 3 (Extreme):         3  -> Stock tool replacements
  Tier 4 (CRITICAL):       61  -> HARD PROTECTED (Core framework)
  Unknown / Custom:       258  -> Unmodified

Safety Tier Selection:
  [1] Tier 1 — Safe Bloat (Carrier preloads, Meta/FB daemons, Xiaomi MSA ads) [Default]
  [2] Tier 2 — Advanced (Bixby, OEM Cloud, Digital Wellbeing)
  [3] Tier 3 — Extreme (OEM Gallery, OEM Calculator, OEM Keyboard)
  [4] Tier 4 — CRITICAL BLACKLIST (Engine-enforced protection: never touched)

Selected: Tier 1 (Safe Default)
  Targeting 42 verified bloatware packages.
  Zero risk to phone calls, cellular radio, Wi-Fi, Camera, or Google Play.

[DRY-RUN] Simulating debloat operations for Tier 1:
Checking safety guardrails against 61-package critical blacklist...
  [OK] 0 collisions with Critical Blacklist packages.
  [OK] All 42 target packages classified as safe.

Planned disable operations:
  [disable] com.samsung.android.bixby.agent     tier=1  Bixby Voice Agent
  [disable] com.samsung.android.game.gos        tier=1  Game Optimizing Service
  [disable] com.facebook.katana                 tier=1  Facebook Client Stub
  [disable] com.facebook.system                 tier=1  Meta App Installer Background
  [disable] com.microsoft.skydrive              tier=1  OneDrive Cloud Preload
  ... [37 more packages]

Verification complete. 0 commands executed on device.

Executing Debloat for Tier 1:
Creating pre-debloat safety snapshot:
  [OK] Snapshot written: backups/snapshot_Galaxy_S24_Ultra_20261030_142010.json (382 packages recorded)

Executing disable commands via 'pm disable-user --user 0':
  [OK] disable: com.samsung.android.bixby.agent
  [OK] disable: com.samsung.android.game.gos
  [OK] disable: com.facebook.katana
  [OK] disable: com.facebook.system
  [OK] disable: com.microsoft.skydrive
  ... [37 packages successfully disabled]

Debloat execution finished!
  Summary: 42 packages disabled | 0 failed | 0 skipped
  Personal data & user files: 100% untouched.

Restoring packages from snapshot: backups/snapshot_Galaxy_S24_Ultra_20261030_142010.json
Target device: Samsung Galaxy S24 Ultra

Restoring package states:
  [OK] restored enable: com.samsung.android.bixby.agent
  [OK] restored enable: com.samsung.android.game.gos
  [OK] restored enable: com.facebook.katana
  [OK] restored enable: com.microsoft.skydrive
  ... [All 42 packages verified and re-enabled]

Restore finished! All packages restored to original state in 1.4 seconds. No reboot required.

Zero Brick Risk: 61 OS packages blocked at code level Pure Python 3 standard library

4-Tier Safety Framework

Every package is classified before execution. Operations run strictly within Android's unprivileged user profile layer.

TIER 1 0% Risk

Safe Bloatware

Carrier diagnostics, ad daemons, Facebook/Meta background services, and telemetry stubs.

• Xiaomi MSA & Analytics

• Meta App Installer

• OneDrive preloads

Action: pm disable-user

TIER 2 Advanced

Assistants & Sync

OEM proprietary digital assistants, background cloud sync services, and AR avatar stickers.

• Samsung Bixby voice agent

• OEM Cloud synchronizers

• AR Zone / 3D Stickers

Action: pm disable-user

TIER 3 Expert

Stock Apps

OEM bundled default apps when alternative apps (Gboard, Chrome, F-Droid) are already active.

• Samsung / Mi Internet Browser

• OEM Stock Keyboard

• Bundled Calculators & Notes

Action: pm uninstall -k

TIER 4 HARD BLOCKED

Critical Sentinel

Hardcoded blacklist enforced at engine level. Any attempt to modify will immediately abort.

• com.android.systemui

• com.android.phone

• com.google.android.gms

Protected: 61 packages

Rootless dm-verity

System partitions remain read-only. Zero firmware modification.

User 0 & -k Flag

Personal databases in /data/user/0/ remain intact.

Auto JSON Snapshots

Pre-debloat snapshots saved for instant 1-click restore.

Knox 0x0 & SafetyNet

Warranty intact. Google Play Integrity and banking apps pass.

Curated OEM Bloatware Rules Explorer

Search and inspect all 331 verified package definitions from the repository.

Feature Comparison

How AI-Phone-Debloater compares against legacy debloating tools and manual ADB commands.

Capability	AI-Phone-Debloater	UAD-ng	ADB AppControl	Manual ADB
Rootless Execution	Yes (User 0)	Yes	Yes	Yes
Zero Data Loss (`-k` flag)	Full (-k flag)	Partial	No	Manual Only
1-Click AI Agent Integration	Native (Claude, Gemini, GPT)	None	None	None
Automatic Pre-Snapshots	Automatic JSON	Manual Export	Paid License ($$)	None
1-Click Full Rollback	Instant (restore cmd)	Per-package	Manual	Manual shell
Curated OEM Rules	320+ Rules	Community list	Basic	None
Zero Dependencies (No Pip / Executables)	Pure Python Stdlib	Rust GUI Binary	Windows Binary	Shell Only
Hardcoded Critical Blacklist Interception	Engine Enforced (61 pkgs)	Rule Enforced	Warning Prompt	None

CLI Command Reference

Run scripts/debloat-engine.py directly. Standard Python 3 with zero pip dependencies.

Windows Interactive Batch

.\debloat.bat

macOS / Linux Shell Script

./debloat.sh

scan Flags: --adb-path, --serial, -v

Queries hardware specs via ADB and categorizes all user-0 packages into Safety Tiers (1-4).

$ python scripts/debloat-engine.py scan

dry-run Flags: --tier {1,2,3}

Simulates debloating for a specific safety tier. Checks the 61-package blacklist with zero changes.

$ python scripts/debloat-engine.py dry-run --tier 1

debloat Flags: --tier {1,2,3}, --action {disable,uninstall}, --yes

Executes package removal on user 0. Automatically saves a JSON safety snapshot in backups/ first.

$ python scripts/debloat-engine.py debloat --tier 1 --action disable

export-for-ai Flags: --rules-dir, -q

Exports device profile and classified inventory to JSON & Markdown for feeding into Claude Code, ChatGPT, or Gemini.

$ python scripts/debloat-engine.py export-for-ai

apply-ai-plan Flags: <plan.json>, --action {disable,uninstall}

Validates and executes an AI-generated JSON debloat plan. Intercepts and aborts if any critical package is referenced.

$ python scripts/debloat-engine.py apply-ai-plan plan.json --action disable

restore Flags: [snapshot.json], --pkg <name>, --action {auto,enable,install-existing}

Restores packages from a snapshot back to their exact original states, or restores a single package by name.

$ python scripts/debloat-engine.py restore backups/snapshot_Galaxy_S24_Ultra.json

list-backups Flags: --backups-dir

Lists all available timestamped JSON backup snapshots stored in backups/ with metadata.

$ python scripts/debloat-engine.py list-backups

interactive Flags: -i, --interactive

Launches the interactive terminal menu with numbered choices for scanning, debloating, and restoring.

$ python scripts/debloat-engine.py interactive

Frequently Asked Questions

Rootless Android debloating, safety boundaries, data protection, and AI agent execution.

Does AI-Phone-Debloater require root access or an unlocked bootloader?

No. AI-Phone-Debloater is 100% rootless and does not require an unlocked bootloader. It operates exclusively via standard Android Debug Bridge (ADB) commands targeting user profile 0 (`pm disable-user --user 0` and `pm uninstall -k --user 0`). Your Knox counter remains 0x0, warranty is intact, and Google Play Integrity API / SafetyNet continues to pass for banking apps.

Will debloating delete my WhatsApp messages, photos, contacts, or personal files?

No. All personal data and user files remain completely untouched. The engine operates using the `-k` flag (`pm uninstall -k --user 0`), which explicitly instructs the Android Package Manager to keep all application data directories (`/data/user/0/<package>`) intact. Furthermore, your personal media, photos, downloads, and contacts are stored in shared storage partitions (`/data/media`), which are never touched.

How do I restore an app or rollback if something breaks?

Every debloat operation automatically creates a timestamped JSON backup snapshot in `backups/`. To restore all apps to their exact prior state in under 2 seconds, run `python scripts/debloat-engine.py restore <snapshot.json>`. To restore a single app by name without a snapshot, run `python scripts/debloat-engine.py restore --pkg <package_name>`. The app is immediately re-enabled via `cmd package install-existing` with all user accounts and settings intact.

Can I connect wirelessly without a USB cable?

Yes. AI-Phone-Debloater works over both USB and Wireless Debugging (Android 11+). Enable 'Wireless debugging' in Developer Options, pair via `adb pair <ip>:<port>`, and connect via `adb connect <ip>:<port>`. Scanning, debloating, and backup snapshots function identically over Wi-Fi.

What happens after an Android OTA system update?

When an OEM pushes an over-the-air (OTA) system update (e.g., from Android 14 to Android 15), the OEM installer may re-enable some disabled default packages during framework re-registration. Your personal data is completely safe. If any bloatware returns after an update, simply reconnect your phone (via USB or Wireless Debugging) and re-run the 1-click prompt or `python scripts/debloat-engine.py debloat --tier 1` to clean it again in seconds.

How does AI-Phone-Debloater work with Claude Code, Gemini, and ChatGPT?

The repository contains curated AI agent prompts in `prompts/`. When you paste the 1-click prompt into Claude Code CLI, ChatGPT, or Gemini, the AI agent inspects your device via ADB, classifies detected packages using the 320+ OEM rule database, simulates a dry-run, takes a pre-debloat snapshot, and debloats safe packages while strictly obeying the 61-package critical blacklist sentinel.

Does debloating void my phone's warranty or trip Knox / SafetyNet?

No. Because the bootloader remains locked and no root binaries (like Magisk or KernelSU) are installed, Samsung Knox warranty bit stays permanently at 0x0 (void: 0). Google Play Integrity API passes all device attestation checks, and banking apps, Google Wallet, and Netflix HD DRM (Widevine L1) continue working normally.

What Android versions and smartphone brands are supported?

AI-Phone-Debloater supports any Android device running Android 8.0 (Oreo) through Android 15+. It includes 320+ verified OEM rules specifically tailored for Samsung (One UI 7/6/5), Xiaomi/Redmi/POCO (HyperOS & MIUI), Google Pixel, OnePlus (OxygenOS), BBK (Oppo ColorOS, Vivo OriginOS, Realme UI), Motorola (Hello UI & My UX), and Transsion (Tecno HiOS, Infinix XOS).

Clean & Speed Up Any Android Phone via ADB