Marionette CLI — AI Agent Reference

Marionette CLI controls Flutter apps running in debug mode. It supports multiple simultaneous app instances via a named instance registry, or direct URI connections for fully stateless operation.

Workflow

Option A: Named Instances (stateful)

1. Start your Flutter app(s) in debug mode and note VM service URI(s) (printed in console, e.g., ws://127.0.0.1:XXXXX/ws).
2. Register each app: marionette register <name> <uri>
3. Interact using: marionette -i <name> <command> [args]
4. Clean up when done: marionette unregister <name>

Option B: Direct URI (stateless)