Initial commit

Author: ClankerGuru

.gitignore

@@ -0,0 +1,7 @@
+.gradle/
+.kotlin/
+build/
+local.properties
+.idea/
+*.iml
+.DS_Store

LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 ClankerGuru
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

README.md

@@ -0,0 +1,67 @@
+# 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
+
+```kotlin
+// 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`.