ad-attach

Attach the Android debugger to a running process by pid or package.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Attaching to a running Android process to inspect live state, set breakpoints, and patch code without rebuilding.

Core Features & Use Cases

  • Resolve and attach to a running process across devices for real-time debugging.
  • List devices and debuggable processes, with auto-resolution when unambiguous.
  • Provide target resolution by pid, package, exact, or partial matches, with fallback prompts when needed.
  • Surface VM version, VM name, and capabilities to guide user actions and tool limitations.

Quick Start

Attach Claude to a running Android process by selecting a target device and process, then attach with the debugger.

Frequently Asked Questions about ad-attach

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

FAQPage Schema
How do I attach an Android debugger to a running process without rebuilding?

You can attach an Android debugger to a running process by resolving the target device and debuggable process, then connecting via JDWP. This enables live state inspection and code patching without rebuilding the application.

Can I target a specific Android process for debugging using a partial package name?

Yes, Android process debugging supports target resolution by pid, exact package name, or partial package matches. It automatically resolves unambiguous targets and prompts for clarification when multiple debuggable processes match.

How does debugging handle multi-device scenarios when attaching to an Android process?

For multi-device scenarios, the Android debugger lists all connected devices and their debuggable processes. It handles target resolution across devices to ensure you attach to the correct process on the right hardware.

What information is reported after attaching to a running Android process?

After attaching to an Android process, the debugger reports VM version, VM name, and capabilities. It also performs a smoke probe of events to inform tool limitations and guide further investigation.

What are the limitations of attaching to an Android process for live debugging?

Live Android process debugging requires the target process to be running in a debuggable state. VM capabilities are reported upon attachment to indicate supported actions and any tool limitations you may encounter.