android-cli

Gradle settings plugin wrapping Google's agent-first android CLI.

Plugin ID: zone.clanker.gradle.android-cli Artifact: zone.clanker:android-cli

Target CLI

This plugin targets Google's android CLI as documented at https://developer.android.com/tools/agents/android-cli.

Verified against the following surface:

Usage: android [-hV] [--sdk=PARAM] [COMMAND]
-h, --help Show this help message and exit.
--sdk=PARAM Path to the Android SDK
-V, --version Print version information and exit.
Commands:
create Create a new Android project
describe Analyzes an Android project to generate descriptive metadata.
docs Android documentation commands
emulator Emulator commands
help Shows the help of all commands
info Print environment information (SDK Location, etc.)
init Initializes the environment (eg. skills) for Android CLI.
layout Returns the layout tree of an application
run Deploy an Android Application
screen Commands to view the device
sdk Download and list SDK packages
skills Manage skills
update Update the Android CLI

The plugin wraps a subset of these subcommands as Gradle tasks (see below). Anything the plugin does not model directly is reachable via android-run with -Pzone.clanker.android-cli.args="...".

Usage

// settings.gradle.kts
plugins {
id("zone.clanker.gradle.android-cli") version "<version>"
}
androidCli {
// binary = "android" // override if not on PATH// extraArgs = listOf("--verbose") // appended to every invocation
}

Tasks

Task	What it runs
android-version	android version
android-describe	android describe (-Pzone.clanker.android-cli.json=true for JSON)
android-screen-capture	android screen capture
android-skills-list	android skills list
android-skills-find	android skills find [query] (-Pzone.clanker.android-cli.query=<term>)
android-skills-add	android skills add <name> (-Pzone.clanker.android-cli.skill=<name>)
android-skills-remove	android skills remove <name>
android-run	android <args> (-Pzone.clanker.android-cli.args="a b c")

Each task extends Exec and pre-checks that the android binary is on PATH.