marionette_flutter: drive an app

Marionette lets an AI agent drive a running Flutter app (debug or profile — never release) the way a real user would: read the screen, tap, type, scroll, screenshot, read logs, hot reload. It has two halves:

• marionette_flutter — the package you add to the app. It registers a VM service extension per action (ext.flutter.marionette.*).
• The bridge — either marionette_mcp (MCP tools, e.g. connect, tap, get_interactive_elements) or marionette_cli (shell commands, e.g. marionette tap --key ...). Nearly the same capabilities, different transport — the CLI additionally offers record-video, with no MCP equivalent (see the capability table, below). Prefer the MCP tools when they're in your tool list; fall back to the CLI in restricted environments (enterprise policy, a shell-only agent) — run marionette help-ai once at the start of such a session and follow its reference for exact syntax.