Injects the harness and starts the Flutter app in test mode.

Stops the currently running Flutter app and cleans up.

Performs a hot restart of the currently running app session started by this server.

Lists available Flutter devices. Does NOT require a running app.

Starts recording the screen of the running app's device. Recording begins capturing immediately with no warmup delay — proceed with interactions right away. Supports iOS Simulators (MP4), macOS Desktop (MOV), and Android devices/emulators (MP4, max 180s). Only one recording at a time. Auto-stops if stop_app is called or after 5 minutes.

Stops the current screen recording and finalizes the video file. Returns the file path, format, duration, and file size. Called automatically by stop_app if a recording is active.

Taps, long-presses, or double-taps a widget. Defaults to a normal tap. Use gesture to change.

Enters text into a widget found by the target string. By default, replaces existing text. Set clearFirst to explicitly clear and re-focus the field before typing.

Returns the text content of a widget identified by the target string.

Drags from a source widget to a target widget (or to an offset).

Scrolls or swipes a widget. Use dx/dy for pixel-precise scrolling, or direction/distance for named swipe gestures.

Scrolls a scrollable widget until a target widget is visible.

Pushes a named route using Navigator.pushNamed. NOTE: Does NOT work with GoRouter or other custom routers — use tap() to navigate via on-screen elements instead.

Pops the current route off the Navigator stack (like pressing the back button).

Returns the name of the currently active route on the Navigator stack.

Simulates a keyboard key press (e.g. enter, tab, escape, backspace, arrow keys).

Runs an assertion check on a widget. Use 'check' to specify the type: exists, not_exists, text_equals, text_contains, count, state, visible, or enabled.

Captures a screenshot. Without a target, captures the full app. With a target, captures a specific widget.

Returns a JSON representation of the widget tree.

Returns the accessibility (semantics) tree.

Maps out interactive elements on the screen.

Waits for a widget to appear or disappear. Set gone=true to wait for disappearance (e.g. loading spinners).

Simulates the app going into the background and coming back to the foreground.

Simulates network connectivity changes.

Mocks a network response. Pass null for both to clear.

Reads the last N lines from the app's stdout/stderr.

Execute multiple actions in a single call. Each action is run sequentially with pumpAndSettle between them. Stops on first error. Supported tools: tap, enter_text, scroll, assert, wait_for, press_key, screenshot, get_text, explore_screen.

Pumps frames for a specified duration without waiting for all animations to settle. Useful for hero transitions, page animations, or custom animation controllers where pumpAndSettle would time out.