ad-detach

Detach the Android debugger by invoking vm.dispose and removing adb port forwards.

3|Updated May 10, 2026
One-click install
npx skills add https://github.com/Acendas/android-debugger --skill ad-detach
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ad-detach
Source: https://github.com/Acendas/android-debugger/tree/main/skills/ad-detach
Command: npx skills add https://github.com/Acendas/android-debugger --skill ad-detach

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Detach the Android debugger from a running session to safely release resources and avoid leaving breakpoints or ports bound.

Core Features & Use Cases

  • Clean shutdown of the debug session by calling the detach command.
  • Ensures the app continues running and can be re-attached later without port conflicts.
  • Provides guidance for safe handling when asked why detach is safe, using lifecycle internals documentation for precise explanation.

Quick Start

Call mcp__android-debugger__detach to terminate the session and release the forwarded port.

Frequently Asked Questions about ad-detach

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I detach the Android debugger without stopping the app?

To detach the Android debugger without stopping the app, invoke the detach command to call vm.dispose and remove adb port forwards. This cleanly releases resources and allows you to reattach later without restarting the running session.

Why does detaching the Android debugger leave ports bound?

Detaching the Android debugger can leave ports bound if the session is not cleanly terminated. Properly invoking vm.dispose and resetting the MCP server state removes adb port forwards and prevents stale sessions from holding network resources.

How do I safely end an Android debug session to reattach later?

To safely end an Android debug session and reattach later, execute the detach command during your end-of-session workflow. It invokes vm.dispose, removes adb port forwards, and resets server state to ensure the app continues running without port conflicts.

Can I remove breakpoints from a running Android app without restarting?

You can remove breakpoints and safely release resources from a running Android app without restarting by detaching the debugger. Invoking vm.dispose cleanly terminates the JDWP session and resets server state, allowing the app to continue uninterrupted.

What happens to breakpoints when I detach the Android debugger?

When you detach the Android debugger by invoking vm.dispose, the session is cleanly terminated to safely release resources. This process removes bound ports and resets the MCP server state to prevent stale breakpoints from persisting in future sessions.