Report the Android toolchain this server sees: SDK path and installed packages, Android Studio install, JAVA_HOME, and the resolved project. Call this first when something isn't found.

Summarize the Android project: modules, their type, namespace/applicationId, SDK levels, launcher activities, Gradle and AGP versions.

List APKs produced by previous builds, newest first.

Open a project, or a file at a line, in Android Studio (reuses the running IDE window if one is open). Handy for handing off to the human.

List installed/available SDK packages or install packages (e.g. 'platforms;android-36', 'system-images;android-36;google_apis;x86_64'). Requires the SDK Command-line Tools package.

Check a background job (build, run_app, emulator_start). Optionally wait for it to finish. Omit id to list all jobs.

Cancel a running background job.

List the Gradle tasks available in the project (or one module).

Run Gradle tasks through the project's wrapper (e.g. ['assembleDebug'], [':app:testDebugUnitTest'], ['clean','build']). Returns parsed compiler errors. Runs as a job; poll with job_status if still running.

Assemble an APK for a module and variant (default: the app module, debug). Returns compiler errors and the APK path.

The Android Studio 'Run' button: assemble the variant, install it on the device, and launch the launcher activity. Runs as a job.

Parse JUnit XML results from the last unit test (testUnitTest) or instrumented test (connectedAndroidTest) run. Run tests with gradle_run first.

Parse the Android Lint XML report (run gradle_run with lintDebug or lint first).

List connected Android devices and running emulators (adb devices -l).

Model, Android version, API level, ABI, screen size and density of a device.

Run an arbitrary shell command on the device (e.g. 'pm list packages -3', 'dumpsys battery'). Output is truncated to the tail.

Install (or reinstall, keeping data) an APK on a device. Use project_apks to find built APKs.

Uninstall an app package from a device.

Start an app's launcher activity (or a given activity) and report launch time.

Force-stop an app, optionally also clearing all of its data.

List installed packages, third-party only by default.

Read recent device logs. Filter by app package (uses its current PID), minimum priority, tag, or a regex. Use crashesOnly to get the crash buffer.

Capture the device screen as a PNG image. Optionally also save it to a file on this machine.

Dump the on-screen view hierarchy via uiautomator, as a compact list of nodes with text, resource-id, content-desc and tap-ready center coordinates.

Drive the device UI: tap or long-press at coordinates, swipe, type text, or press a key (BACK, HOME, ENTER, APP_SWITCH, DEL, or any KEYCODE_*). Get coordinates from ui_dump.

Copy a file between this machine and the device (adb push / adb pull).

List Android Virtual Devices and which are currently running (with their serials).

Boot an AVD in the background and wait for it to finish booting. Returns a job; if it isn't done within waitSec, poll it with job_status.

Shut down a running emulator by serial (e.g. emulator-5554).

Whether Android Studio (with the bridge plugin) is running, its version, and its open projects and indexing state.

Files open in Android Studio, which have unsaved changes, and the active file with caret position and selection.

Read a file as Android Studio currently has it, including unsaved edits. Prefer this over reading from disk when the user is editing in the IDE.

Errors and warnings from Android Studio's live analysis of a file (Kotlin/Java compiler checks, Android Lint, inspections), without running Gradle. Opens the file in the IDE if needed.

Open a file at a line/column in the running Android Studio and bring its window to the front.

Save all unsaved editor buffers to disk (build and run_app do this automatically when Studio is running).

Search Android Studio's action ids by id or menu text (e.g. 'sync', 'reformat', 'rebuild').

Invoke an Android Studio action by id, as if chosen from the menu. Useful ids: Android.SyncProject (Gradle sync), ReformatCode, OptimizeImports, MakeGradleProject (Build › Make), CompileDirty, Android.RunAndroidLint. Editor actions apply to the active editor; use ide_open first.

List the project's run/debug configurations and which one is selected.

Run or debug a run configuration in Android Studio, like its toolbar buttons (deploys to the IDE's selected device). Defaults to the selected configuration.

Find every reference to the symbol at path:line:column across the project using the IDE's semantic index (Kotlin and Java aware, not text search).

Rename the symbol at path:line:column and update all references, like Shift+F6 (classes also rename their file). Saves all files afterwards. If the IDE detects conflicts it shows a dialog in Studio and this call times out; resolve it there.

Run Android Studio's analysis (compiler checks, inspections, on-the-fly lint) over the project or given files/folders without opening them or running Gradle. Errors only by default; faster than a build for checking an edit compiles.

Run 'Sync Project with Gradle Files' in Android Studio and wait for the result (success, or the failure message).

State of the most recent Gradle sync in Android Studio (running / succeeded / failed with error).

Capture Android Studio's window (or just the active editor area) as an image: see Compose previews, the layout editor, tool windows and error balloons as the user does.

Find project files by name using the IDE index: exact name ('MainActivity.kt') or glob ('*ViewModel.kt').