← All ways to use Olef

Olef for android engineers

Give your coding agent eyes, hands, and a debugger for Android.

Olef CLI gives coding agents the tools to run, inspect, debug, and test Android apps on emulators and devices. Connect what happens on screen to the code, runtime state, and network activity behind it.

Install OlefExplore the documentation

Works with Claude CodeCodexCursorGeminiany shell

48%faster than adb + the Android CLI across 21 agent tasks
34%fewer tokens on the same tasks
~65msto read the screen with a warm ui dump, parsed JSON, end to end
~1.5sfrom code edit to pixels with app apply, app state kept

Benchmark: Codex completed the same 21 Android tasks with each setup, all successfully. Median time per task 36 s with Olef vs 69 s with adb and the Android CLI; tokens 4.0M vs 6.1M. Olef 2.0, October 2026.

Give your agent runtime feedback

  • Debug live code. Use breakpoints and inspect runtime state to understand failures.
  • Inspect the UI. Explore layout trees and Compose behavior, connected to relevant source.
  • Trace the network. Inspect requests and responses, and reproduce network conditions.
  • Verify behavior. Let your agent operate the app and check whether each interaction produces the expected result.
  • Capture repeatable tests. Turn a verified flow into a regression test that replays without AI.
  • Get agent-ready answers. Every command returns compact JSON with the next step built in, so your agent spends fewer tokens reading output.

Agentic development, from a change to a verified result

Build and run a change, inspect the running app, fix what failed, and verify the result. Olef connects your coding agent to the device and runtime tools it needs at each step.

For a crash, that means reproducing the failure, inspecting its cause, changing the code, and running the same interaction again to check the fix.

Fit Olef into your workflow

Use the CLI directly or connect it to your coding agent. Work with your local emulator or device, or use a managed environment in Olef Cloud.

Install

One binary. Up in a minute.

Install the CLI, then add it to your agent. On first connect, Olef installs a version-matched, checksum-verified service on the device.

1 Install the CLI

brew install olef-dev/tap/olef

You also need Android platform-tools (adb): Android Studio installs it, or brew install --cask android-platform-tools on macOS, scoop install adb on Windows, your distribution's adb package on Linux.

2 Add it to your agent

Claude Code, Codex, Cursor, Gemini CLI, Antigravity: one command

olef init

Installs the plugin, with the live device viewer, for Claude Code and Codex (it asks first), and the skill for the other agents.

Or add the plugins yourself

Claude Code

/plugin marketplace add olef-dev/olef
/plugin install olef@olef

Codex

codex plugin marketplace add olef-dev/olef
codex plugin add olef@olef

Plugin first? Install the Claude Code or Codex plugin before the CLI and, on the next session, your agent offers the right install command for your OS.

Already installed? olef update prints the command for your install; then olef init updates the plugins. How updating works

quickstart
# list devices and emulators
$ olef devices
# install the device service and verify it
$ olef connect
# read the screen as JSON
$ olef ui dump
# act by selector, prove the outcome
$ olef ui tap --text "Sign in" --expect-text "Welcome"
# when something surprises you
$ olef why
# check the setup, fix what it can
$ olef doctor --fix

Let your agent see what it built.

Connect Olef to your coding agent and try it on your app.

Install Olef