How to Install Android CLI Plugins for Claude and Codex
Install the official Android CLI plugins in Claude Code and Codex to give agents Compose previews, device streaming, and leak analysis.
Android Dev Summit 2026 made Android CLI more useful for agents that live outside Android Studio. Google released official plugins for Claude Code and OpenAI Codex that add the android-cli skill. Your agent can now create projects, manage devices, render Compose previews, stream real hardware, and analyze memory leaks without switching windows.
This guide shows the exact install commands, what the plugins unlock, and how to use the newest subcommands. It assumes you already have Android CLI installed. If not, see our earlier guide on Android CLI and agent skills.
Why the plugins matter
Android CLI is a thin command-line layer over the Android SDK. The plugins teach Claude Code and Codex how to call it correctly instead of inventing adb or sdkmanager sequences. Google reported that agents finished UI tasks 77 percent faster and used up to three times fewer tokens when they could render Compose previews without launching an emulator.
The same pattern applies to memory leaks. The android profiler leakcanary command analyzes heap dumps on your computer rather than the device. Internal tests with Claude Opus 5.5 showed the process ran almost twice as fast and used about 25 percent fewer tokens.
Install the plugin in Claude Code
You need the Android CLI binary on your PATH first. Then, from a Claude Code session or your terminal:
claude plugin marketplace add android/android-cli-plugin
claude plugin install android-cli@android-cli-plugin
Alternatively, inside an active Claude Code chat:
/plugin marketplace add android/android-cli-plugin
/plugin install android-cli@android-cli-plugin
After installation the android-cli skill becomes available. The agent can discover and run android commands without extra prompting for basic tasks.
Install the plugin in Codex
From your terminal:
codex plugin marketplace add android/android-cli-plugin
codex plugin add android-cli@android-cli-plugin
Note the second command uses add rather than install. Once the plugin is present, Codex gains the same skill and can invoke Android CLI tools.
Official plugin source lives at the android/android-cli-plugin repository under Apache-2.0. The repo contains only the skill and marketplace metadata; you still install the CLI binary separately.
What the plugins unlock
After the skill is loaded, your agent can use these capabilities directly:
- Scaffold projects with
android create - Manage virtual devices and run apps
- Render Jetpack Compose previews without an emulator
- Stream real devices from Firebase device lab
- Capture system traces with Perfetto
- Score app bundles for Play quality signals
- Run
android profiler leakcanaryfor heap analysis on the host machine - List, install, and update Android skills
Antigravity receives deeper UI integrations (inline Compose previews and a Device Hub). Claude Code and Codex receive the command surface today, with more visual features planned.
Step-by-step: render a Compose preview
- Ensure the plugin is installed and the agent session is restarted if required.
- Prompt the agent: “Render the Compose preview for the home screen without starting an emulator.”
- The agent should call the preview command (exposed via the skill) and return the rendered image or layout data.
- Iterate on the composable and re-render. Google’s testing showed this loop is substantially faster and cheaper than full emulator boots.
You can also ask the agent to list available remote devices and stream one for a quick manual check.
Step-by-step: find and fix a memory leak
- Reproduce the suspected leak in a debug build that includes LeakCanary (or let the Profiler inject it).
- Prompt: “Use android profiler leakcanary to analyze the heap dump for this journey and suggest the fix.”
- The command runs the analysis on your desktop. The agent receives the leak trace, explains the retaining reference, and proposes a code change.
- Apply the change, re-run the journey, and confirm the leak is gone.
In the Android Dev Summit keynote demo, Claude Code processed six user journeys in parallel, found multiple leaks, fixed the reference chains, and verified the results—all with lower token cost when using the CLI command.
Tips for reliable results
- Run
android updateandandroid initafter installing the CLI so the base skill is current. - Prefer project-scoped skill installs (
--project) when you work across multiple repositories. - For CI, pass
--no-metricsif your pipeline policy forbids telemetry. - Combine the plugin with official Android skills (for example the adaptive layout or CameraX skills) so the agent follows current guidance rather than older training data.
- After an agent produces a large change, open the same project in Android Studio Rabbit 2 and run Change Review for a themed walkthrough of the diffs. See our AI Change Review guide for the exact steps.
Conclusion
The official Android CLI plugins turn Claude Code and Codex into competent Android agents without forcing you into a single IDE. Install the marketplace, add the plugin, and start prompting for previews, remote device tests, or leak analysis. The measured gains in speed and token use come from giving the agent the right tools instead of letting it guess Android’s moving parts.
Start with the two commands above, confirm android --version works, then give your agent a concrete task on a small sample project.
Sources
Share this story