What do you want to do?
3 use cases
-
Catch an app crash and read live state at the throw
Set exception traps, reproduce the crash, and read locals and frames without a GUI.
- Debroid
- Claude Code
- Codex
- Cursor
- Software and DevOps
- Intermediate
View prompt
Use the Debroid CLI on the Android app <package-name>. Set an uncaught exception trap, trigger the crash path <steps-to-reproduce>, and run `debroid poll --with-stacktrace` followed by `debroid pause-state`. Return the exception class, the frame where it was thrown, and the local values at that point as JSON. Verify that the exception class matches the crash in the bug report before proposing a fix.
-
Pause at a suspect line and inspect its variables
Set a line breakpoint, hit it, and read the object state the agent needs to test a hypothesis.
- Debroid
- Claude Code
- Codex
- Cursor
- Software and DevOps
- Intermediate
View prompt
Use the Debroid CLI to set a breakpoint in <class-name> at line <line-number> of the app <package-name>. Trigger <user-action>, then run `debroid pause-state --pretty` and `debroid inspect --max-depth=2`. Return the local variables and relevant object fields as JSON, and verify that the paused line matches the breakpoint you set.
-
Find which code writes a field that goes wrong
Watch a field for access and modification, then read the stack at each change.
View prompt
Use the Debroid CLI to watch the field <field-name> in <class-name> of the app <package-name>. Run <user-flow> and then run `debroid poll --with-stacktrace`. Return each access or modification with its stack trace as JSON, and verify that the watched field name matches the one you set with `debroid points`.
How to use Debroid
- Check you have what it needs: Java JDK 11+ with JAVA_HOME set; Android SDK with adb in your PATH; An Android app you can build and run, with debugging enabled.
- Open PatilShreyas/debroid on GitHub and read the README and license.
- Install the CLI with
curl -fsSL https://raw.githubusercontent.com/PatilShreyas/debroid/main/install.sh | bash - Start the app suspended with
debroid launch, or attach to a running app withdebroid attach - Set an exception trap with
debroid catch-exception(uncaught only by default; add--caughtif needed) - Trigger the bug in the app, then read events with
debroid poll --with-stacktrace(inferred, check the README)
These steps come from our top use case, Catch an app crash and read live state at the throw, which also has a copy-paste agent prompt.
Get 5 new use cases every morning. Free, one short email, unsubscribe anytime.
Get them freeDebroid alternatives · Best AI repos for Software and DevOps
About this repo
- Who it is forAndroid developers and the AI coding agents they run who need to see runtime state of a live app without opening Android Studio.
- Why it is hot
- LanguageKotlin
- Sourcegithub.com/PatilShreyas/debroid · Back to Hot repos
Requirements
- Java JDK 11+ with JAVA_HOME set
- Android SDK with adb in your PATH
- An Android app you can build and run, with debugging enabled
- A terminal where an AI agent can run commands
Maintain Debroid? Add the Featured on Deduped badge
Paste this into your README:
[](https://dedupedai.com/use-cases/patilshreyas-debroid/?ref=badge)
Questions about Debroid
What is Debroid?
Debroid is a headless Android debugger CLI that lets AI agents set breakpoints, catch exceptions, inspect and change variables, and step through a live Android app over JDWP. It is an open-source project on GitHub: https://github.com/PatilShreyas/debroid.
Who is Debroid for?
Android developers and the AI coding agents they run who need to see runtime state of a live app without opening Android Studio.
What can I do with Debroid?
3 use cases so far, for example: Catch an app crash and read live state at the throw; Pause at a suspect line and inspect its variables; Find which code writes a field that goes wrong. Each has steps and a copy-paste agent prompt.
What do I need to run Debroid?
Java JDK 11+ with JAVA_HOME set; Android SDK with adb in your PATH; An Android app you can build and run, with debugging enabled; A terminal where an AI agent can run commands.
What are alternatives to Debroid?
Other hot AI repos in Software and DevOps: Harness2, iFixAi, Orca, Diagram Design, AI Memory.
Is Debroid safe to run?
Deduped does not own, audit or vouch for it. Read the README and license, run it on your own systems first and review every command before you run it.