fdb 1.1.5

Flutter Debug Bridge - CLI for AI agents to interact with running Flutter apps on device. Launch, reload, screenshot, inspect widget tree, filter logs.

1.1.5

Fixes

• Fix CI publish: fdb 1.1.4 was published but fdb_helper was not due to missing CHANGELOG entry

1.1.4

Improvements

• Renamed skill from interacting-with-flutter-apps to using-fdb for better discoverability on skills.sh

1.1.3

Improvements

• fdb_helper is now published to pub.dev — add it as fdb_helper: ^1.1.3 instead of a git path reference

1.1.2

New commands

• fdb shared-prefs get|get-all|set|remove|clear — read/write/clear SharedPreferences from the CLI via a VM service extension in fdb_helper

Fixes

• fdb deeplink now uses the session device ID to detect platform instead of probing all connected devices — fixes misrouting to Android when both Android and iOS are connected but the session is on iOS

Improvements

• Smoke test extended with test:clean and test:shared-prefs tasks covering all sub-commands

1.1.1

Improvements

• fdb_helper install instructions now reference pub.dev (fdb_helper: ^X.Y.Z) instead of a git path reference
• Releasing skill updated to track all 9 version-bearing files

1.1.0

Fixes

• Fix developer.log() output not appearing in fdb logs — flutter run never forwards developer.log() to stdout; a background log collector now subscribes to the VM service Logging stream and appends events directly to the log file

Improvements

• Session state moved from /tmp/fdb_*.txt to <project>/.fdb/ — multiple projects can run simultaneously without interfering with each other
• .fdb/ is automatically added to the project's .gitignore on first launch
• FVM support: launch auto-detects .fvm/flutter_sdk/bin/flutter; override with --flutter-sdk <path>
• --project flag on launch is now optional — defaults to CWD (agents running from the project directory need not pass it)
• Log collector self-cleans on SIGTERM, SIGINT, and when flutter run exits

1.0.1

Fixes

• Fix dartdoc angle bracket warnings in describe.dart and vm_service.dart
• Fix deeplink smoke test — register fdbtest:// URL scheme in test app Info.plist
• Fix back smoke test — restart app to reset UI state before navigation test

Improvements

• Add example/example.md for pub.dev Example tab
• Replace mermaid code block with pre-rendered SVG diagram (renders on pub.dev)
• Add dart pub global activate fdb install option to README
• Add release skill and CI publish workflow

1.0.0

New commands

• fdb back — navigate back via Navigator.maybePop(), handles dialogs and root detection
• fdb longpress — long-press widgets, reuses tap infrastructure with configurable duration
• fdb swipe — swipe gestures for PageView/Dismissible with widget targeting and smart defaults
• fdb describe — compact screen snapshot with interactive element refs (@1, @2...) for agent navigation
• fdb devices — list connected devices
• fdb deeplink — open deep link URLs on device
• fdb skill — print SKILL.md for AI agent consumption

Describe command

• Shows only hittable, topmost-layer widgets (filters obscured/background route elements)
• Gesture info on GestureDetector/InkWell: (tap), (tap,horizontalDrag), (tap,longPress)
• Extracts text from all children, tooltips, and icon semantic labels
• Filters framework widgets and Unicode PUA icon codepoints
• Ref-based tapping: fdb tap @3 taps the 3rd interactive element from last describe
• Shows deepest route name and Scaffold title

Fixes

• Error propagation: specific error messages instead of "Server error"
• --text tap: walks to hittable ancestor when Text widget itself isn't in hit-test path
• --index ordering: user widgets before framework widgets (Overlay, IndexedStack, _Theater)
• --key tap: ancestor walk for KeyMatcher/TypeMatcher, not just TextMatcher
• --help / -h: prints to stdout with exit 0, no "ERROR:" prefix
• Swipe velocity: process-relative Stopwatch timestamps for VelocityTracker fling detection
• Screenshot: defaults to 1x logical resolution (~180KB vs ~1MB), --full for native
• Screenshot: supports --output=path equals syntax, fixes Android shell escaping
• Skill command: resolves SKILL.md via package URI for global installs

0.1.0

• Initial release
• CLI commands: launch, status, reload, restart, kill, logs, tree, screenshot, select, selected, tap, input, scroll
• fdb_helper package for Flutter app integration