Command line

The emulabzip command gives you the same data as the desktop app, in a terminal or a script. It is a single static binary with no runtime dependencies besides adb and Xcode.

cargo install --git https://github.com/LuisPeixoto/EmuLabZip emulabzip-cli

Pre-built archives for macOS, Linux and Windows are attached to every release.

Choosing a device#

Every command except devices works on one device. When only one is running it is used automatically. Otherwise pass --device (or set EMULABZIP_DEVICE) with an adb serial, a simulator UDID, a name, or part of a name:

emulabzip --device pixel info
emulabzip -d "iPhone 17" logs

Commands#

emulabzip devices#

PLATFORM  NAME       OS                   STATE   ID
Android   Pixel 9    Android 16 (API 36)  online  emulator-5554
iOS       iPhone 17  iOS 26.2             online  F8CE84C1-04D1-4E33-B52B-02B59E8A09C5

--json prints the list as JSON. The alias emulabzip ls does the same.

emulabzip info#

Prints the same groups as the Overview (device, software, hardware, display, battery, locale). --json prints an object of objects.

emulabzip apps#

Lists user apps with their version and process id. --all adds system apps, --running keeps only running ones.

emulabzip logs#

Follows the device log, coloured by level, until you press Ctrl+C.

emulabzip logs --app com.example.app --level warn
emulabzip logs -g 'skipped \d+ frames' -E
emulabzip logs --json | jq -r 'select(.level == "error") | .message'

emulabzip screenshot#

Saves a PNG of the screen. -o, --output <file> picks the path; by default the file is named after the device and the time.

emulabzip perf#

Prints one line per sample: app and device CPU, app and device memory, frame rate, janky frames and battery.

emulabzip mem <app>#

A memory breakdown: PSS by category on Android, footprint by VM region on iOS. See Memory.

emulabzip heapdump <app>#

Saves an .hprof heap dump (Android, debuggable apps) or a .memgraph memory graph (iOS). -o picks the file. With --analyze it also looks for leaks, see Finding leaks.

emulabzip heap analyze <file>#

Looks for leaks in an .hprof (any platform) or a .memgraph (on a Mac). --json; --top <n> sets how many objects and classes to list; --all-heaps looks beyond the app's own heap. See Finding leaks.

emulabzip startup <app>#

Times how long the app takes to open. -k, --kind cold|warm|hot (default cold), -r, --runs <n> (1 to 50, default 5), --json. See App start time.

emulabzip energy <app>#

Measures the energy the app uses while you use it. -s, --seconds <n> (default 30; Ctrl+C reads what there is), --json. See Energy.

emulabzip files <app> [path]#

Lists a folder of the app. --root picks the storage root (data or external on Android; data, bundle or group:<id> on iOS); by default the first readable one is used. See Storage.

emulabzip pull <app> <path>#

Copies one file to this computer. -o picks the destination.

emulabzip db <app> <path>#

Opens a SQLite database read-only. Without options it lists tables and views; --table prints rows (--limit, --offset); -q, --query runs a read-only statement. All of them accept --json.

emulabzip net#

Runs the proxy, points the device at it and prints each request when it finishes, until Ctrl+C. The device is put back when it stops, also after an error. See Network.

GraphQL operations and gRPC methods and statuses are printed after each request.

emulabzip net import <file> [--har <file>] [--json] [--dns] reads a .pcap or .pcapng capture and prints the requests it holds, with the DNS lookups when asked. See Importing a capture.

emulabzip layout and emulabzip a11y#

layout prints the views on the screen as a tree (--json for all of it, --png <file> to save the screenshot taken with it, --depth <n>, --app <id> to mark an iOS screen with its app's framework). a11y audits the screen and prints the findings; --fail-on note|warning|error exits with 1 when something at least that serious is found. See Layout and accessibility.

emulabzip frameworks <app>#

Lists the UI frameworks the app is built with (Flutter, React Native, Hermes, Jetpack Compose, SwiftUI) and what showed it. --json. See Inside the frameworks.

emulabzip flutter tree|frames|memory <app>#

Looks inside a Flutter debug or profile app through its Dart VM service. --uri <address> gives where it listens when it is not in the log; tree has --depth <n>, frames has -s, --seconds <n> (default 10), memory has --top <n>. All accept --json.

emulabzip rn tree|heap|console|state <app>#

Looks inside a React Native development app through Metro (--metro <port>, default 8081). tree has --depth <n>, console has -s, --seconds <n>. state reads Redux, React Query, contexts and registered stores; --watch follows Redux actions and prints what changed. See React Native state. All accept --json. Metro lets one debugger connect at a time.

emulabzip state save|restore|show|diff#

save <app> -o file.ezstate [--external] writes an app's data to one file. restore <file> --yes replaces the app's data with it, after saving what it replaces. show <file> says what a file holds. diff <a> [b] lists the tables, columns, indexes and keys that changed between two files, or between one and the app now. See App state.

emulabzip edit#

Changes data on the device: cell (-t <table>, --rowid <n> or --pk col=value, --set, --text, --null), insert, delete, pref-set <key> <value> [--as type], pref-remove, plist-set <key/path> <value> [--as type], plist-remove and undo <folder>. Each takes the app and the file, and every one needs --yes. See Changing an app's data.

emulabzip avd, sim and snapshot#

avd and sim have list, options, create <name> --image <id> --model <id>, boot <device> (--headless, --cold, --wipe), shutdown, wipe (erase on sim) and delete. snapshot has list, save, load and delete for the running emulator picked with -d. wipe, delete, boot --wipe, snapshot load and snapshot delete need --yes. emulabzip devices --all also lists devices that are not running. See Devices.

emulabzip audit security <app>#

Looks for secrets and personal data in the log, preferences and databases, plain HTTP and secrets in requests (--har), the debuggable and allowBackup flags, components other apps can reach, App Transport Security exceptions and privacy manifest gaps. --only manifest,logs,storage,traffic, --json, --fail-on <note|warning|error>. Evidence is cut down so a secret is never repeated. See Security audit.

emulabzip size show|diff#

show <file> breaks an .apk, .aab or .ipa down by kind, native ABI and dex file (--top, --json); with --budget it holds the build to the [size] section of emulabzip.toml (--config, --baseline) and exits 1 over a limit. diff <before> <after> says what changed (--fail-on-growth <percent>). See Build size.

emulabzip i18n check|sweep#

check looks for text that is cut off, off screen, clipped or not mirrored on the screen as it is (--rtl, --fail-on). sweep tries it in other languages and text sizes (--locales en-XA,ar-XB, --scales 100,130,200, --app, --fail-on-worse) and puts the device back. See Language, text size and text that does not fit.

emulabzip control locale|reset-locale|font-scale|display|reset-display#

Change the language of an app (Android) or of the simulator (iOS), the text size, and the Android display size. a11y --simulate <kind> [-o file] shows the screen as someone with colour blindness sees it.

emulabzip visual capture|update|compare|list|diff|session#

Baselines of the screen, and what changed since. capture and compare take --status-bar (a clean 9:41 bar), --dir, --threshold; update needs --yes. compare exits 1 over the limit and draws the difference. See Visual regression.

emulabzip analytics#

Runs the proxy and prints the events an app sends to Segment, Amplitude, Mixpanel and Firebase (--service, --port, --no-connect, --json), or with --firebase-log Firebase's debug lines from the device log. See Analytics inspector.

emulabzip session and emulabzip ci#

session record -o run.ezsession [--app <id>] [--network] [--screens <s>] [--duration <s>] [--video [<s>]] [--taps] [--replay <file> [--passthrough] [--timing]] records until Ctrl+C; --video records the screen in pieces (30 s by default, 1 to 180), --taps records touches, and --replay answers the app's requests from a recording meanwhile (it needs --network). session show <file> [--json | --markdown] summarizes a session or the .partial folder of one that was cut short. session timeline <file> [--lane <name>…] [--json] prints touches, requests, log problems, slow frames, garbage collections, crashes, screenshots and video on one time axis, and session video <file> [-o <dir>] writes the pieces of the screen recording out. ci -o run.ezsession [--app <id>] [--network] [--screens <s>] [--fail-on-crash] [--summary <file>] [--video [<s>]] [--taps] [--replay <file> [--fail-on-miss]] -- <command…> records around a command and exits with its code. See Sessions, Timeline and screen video, Replaying a recording and CI mode.

emulabzip compare <a> <b>#

Lists what differs between two devices (--all for what matches too, --json). See Comparing devices.

emulabzip crashes and emulabzip crash <id>#

crashes lists what the device recorded, newest first, with an id for each; -a, --app and -k, --kind crash|native|anr narrow it down. crash shows one with its stack and hints: --all-threads prints every thread, --raw prints the report as the device wrote it, and -m, --mapping <file> reads it with a mapping.txt, a source map or a .dSYM you name, besides the ones kept for its app and version. Both accept --json. See Crashes and Readable stacks.

emulabzip mappings and emulabzip symbolicate#

mappings add <app> <version> <file> keeps a mapping.txt, a source map or a .dSYM for a build (-k, --kind mapping|sourcemap|dsym when it cannot be told from the file), mappings list [app] [--json] shows what is kept, and mappings remove <app> <version> [-k <kind>] forgets it. symbolicate <stack.txt|-> -m <file> reads a stack you pasted, from a file or standard input. See Readable stacks.

emulabzip report#

Writes what a bug report needs into one HTML file: [--session <file>] [-a, --app <id>] [-o <file>] [--title <text>] [--description <text>] [--without screenshot|logs|requests|crashes|video] [--issue github:owner/repo | gitlab:[host/]group/project | jira:site/PROJECTID/ISSUETYPEID] [--open]. With --issue it prints a link that opens the issue with a summary filled in, and --open opens it in the browser. See Bug reports.

emulabzip control#

Changes the device. See Controls.

emulabzip webview#

The pages inside an app's WebView, or in Chrome, on an Android device. See Web pages in apps.

Each takes --app <package>, --socket <name> and --page <id or part of its address> to say which page, and --json.

emulabzip flow#

Records touches into a flow, plays it, and exports it. See Input and flows.

emulabzip link#

Opens a deep link and checks that the domain and the app agree about it. See Deep links.

emulabzip openapi check#

openapi check --spec <file> --har <file> [--json] checks every response in a HAR file against an OpenAPI 3 description, and exits with an error when one does not match. See Network rules.

emulabzip script#

Approves the WebAssembly scripts that rules run. script show <file>, script approve <file>, script revoke <file or hash> and script list. See Rule scripts.

emulabzip plugin#

Runs your own collectors. See Plugins.

emulabzip mcp [--allow-writes [--no-confirm]]#

Serves the devices to an AI assistant over MCP on standard input and output. See MCP server and the MCP reference.

emulabzip trace#

Records and analyzes traces. See Traces. Ctrl+C during a recording stops it early and keeps what was recorded.

summary and query download the trace processor the first time (see Traces).

emulabzip ca install#

Makes the device trust the certificate: the system store on a rootable Android emulator, the keychain on an iOS simulator, and for other Android devices it copies the file and prints the steps. emulabzip ca path prints where the certificate file is.

Environment#