NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
pub.dev
pub.dev, #2947 most downloaded on pub.dev
Give your AI Agent eyes and hands inside your Flutter app.
Latest stable
0.9.37
Last release 2 months ago
01 Sep 2026
Ships unpredictably
gaps range from 8 days to 5 months
Nearly every release is documented
notes for 60 of the last 60 stable releases
Nothing withdrawn
no release was ever pulled
9 months old
84 releases · first in 2026
Drag across the ruler to compare, or tap a release to open it.
feat: named server registry and --server flag for CLI commands by @vinifig in https://github.com/ai-dashboad/flutter-skill/pull/38
Full Changelog: https://github.com/ai-dashboad/flutter-skill/compare/v0.9.35...v0.9.37
Your coding agent can read these notes before it upgrades. Set up the MCP server →
Ships seven fixes that were merged months ago but never released, plus npm packaging and release-pipeline repairs
The v0.9.24 and v0.9.36 tags were cut from commits that are not on main, so
everything merged since v0.9.35 stayed unreleased. This version delivers it all.
Previously merged but never shipped
ENOEXEC, Unknown system error -8) instead of crashing (#49, #55)tap/enter_text by text or key, so
a pushed screen is no longer bypassed for an identical label on the screen
behind it (#53)hot_reload / hot_restart now drive Flutter Tools' reloadSources and
hotRestart services, so code changes actually apply (#58)press_key passes modifiers through the server, and emits no character while
a modifier is heldscroll_to, scroll direction and batch settle--server flag for CLI commands (#38)Server robustness
npm package
lib/ grew to 100
files, so the fallback ran a v0.2.0 server. They are now regenerated on every
publish, which restores tap by ref and by coordinates (#52)flutter pub get failed instead of swallowing it (#45, #49, #50)Release tooling
release.sh verifies the release is cut from origin/main and pushes
atomically, so a tag can no longer land on a commit that is not on the branchrelease.sh refuses to publish the TODO CHANGELOG placeholder, which ten
previous releases shipped as their entire changelogrelease.sh is now the only release entrypoint; three scripts that bypassed
it were removedFix EACCES: ensure native binary has execute permission before spawn
Fix EACCES: ensure native binary has execute permission before spawn
Fix EACCES: ensure native binary has execute permission before spawn
Fix inspect empty text, Flutter 3.38+ URI detection, MCP stdout pollution, Homebrew arm64 on Intel, Windows flutter command
Fix inspect empty text, Flutter 3.38+ URI detection, MCP stdout pollution, Homebrew arm64 on Intel, Windows flutter command
Fix inspect empty text, Flutter 3.38+ URI detection, MCP stdout pollution, Homebrew arm64 on Intel, Windows flutter command
Full Changelog: https://github.com/ai-dashboad/flutter-skill/compare/v0.9.33...v0.9.34
Full Changelog: https://github.com/ai-dashboad/flutter-skill/compare/v0.9.33...v0.9.34
notifications/tools/list_changed support + idb integration for native iOS automation
Full Changelog: https://github.com/ai-dashboad/flutter-skill/compare/v0.9.32...v0.9.33
Full Changelog: https://github.com/ai-dashboad/flutter-skill/compare/v0.9.32...v0.9.33
fix dart format CI check across all files
Full Changelog: https://github.com/ai-dashboad/flutter-skill/compare/v0.9.31...v0.9.32
Full Changelog: https://github.com/ai-dashboad/flutter-skill/compare/v0.9.31...v0.9.32
Full Changelog: https://github.com/ai-dashboad/flutter-skill/compare/v0.9.30...v0.9.31
Full Changelog: https://github.com/ai-dashboad/flutter-skill/compare/v0.9.30...v0.9.31
fix scroll_to crash on unmounted context (#28), improve setup error messages (#15)
Full Changelog: https://github.com/ai-dashboad/flutter-skill/compare/v0.9.29...v0.9.30
Full Changelog: https://github.com/ai-dashboad/flutter-skill/compare/v0.9.29...v0.9.30
Fix Gemini/Vertex AI "Duplicate function declaration" error (issue #32)
get_network_requests definition — direct root cause of Gemini 400 errorconnectionOnlyTools set and geminiToolLimit constant in ToolRegistrytest/tool_registry_test.dart — 17 unit tests covering tool filtering behaviorFull Changelog: https://github.com/ai-dashboad/flutter-skill/compare/v0.9.28...v0.9.29
Full Changelog: https://github.com/ai-dashboad/flutter-skill/compare/v0.9.28...v0.9.29
Fix: add connect_openclaw_browser and connect_webmcp to tool_registry
connect_openclaw_browser and connect_webmcp in tool_registry.dart so they appear in tools/listFull Changelog: https://github.com/ai-dashboad/flutter-skill/compare/v0.9.27...v0.9.28
Full Changelog: https://github.com/ai-dashboad/flutter-skill/compare/v0.9.27...v0.9.28
Add connect_openclaw_browser and connect_webmcp tools; fix OpenClaw plugin binary path
connect_openclaw_browser tool: instant connection to OpenClaw's built-in Chrome (port 18800, no launch needed)connect_webmcp tool: Chrome 146+ native WebMCP support with auto-detection and CDP fallback~/.pub-cache/bin/flutter_skill instead of volatile /tmp/fs-*Full Changelog: https://github.com/ai-dashboad/flutter-skill/compare/v0.9.26...v0.9.27
Full Changelog: https://github.com/ai-dashboad/flutter-skill/compare/v0.9.26...v0.9.27
fix coordinate filtering, tap(ref) elem_ fix, Windows lock fallback, CLI error improvements
Added --chrome-port=N as an alias for --cdp-port=N
--chrome-port=N as an alias for --cdp-port=N--chrome-port parameter# Connect to existing Chrome (port 18800)
flutter-skill serve https://reddit.com --chrome-port=18800
# Or use --cdp-port (same effect)
flutter-skill serve https://reddit.com --cdp-port=18800
Full changelog: CHANGELOG.md
--chrome-port=N as an alias for --cdp-port=N for better compatibility--chrome-port parameter (previously threw FormatException)Full Changelog: https://github.com/ai-dashboad/flutter-skill/compare/v0.9.23...v0.9.25
Full Changelog: https://github.com/ai-dashboad/flutter-skill/compare/v0.9.23...v0.9.25
fix coordinate system: filter non-active routes, fix tap(ref: elem_NNN), fix off-screen tap detection
Full Changelog: https://github.com/ai-dashboad/flutter-skill/compare/v0.9.23...v0.9.24
Full Changelog: https://github.com/ai-dashboad/flutter-skill/compare/v0.9.23...v0.9.24
fix 6 UX issues: DTD error detection, wider port scan, connect_by_pid, stale session cleanup, screenshot save_to_file default
Full Changelog: https://github.com/ai-dashboad/flutter-skill/compare/v0.9.22...v0.9.23
Full Changelog: https://github.com/ai-dashboad/flutter-skill/compare/v0.9.22...v0.9.23
fix null check crash and stop auto-opening browser on RPC errors from target app
Full Changelog: https://github.com/ai-dashboad/flutter-skill/compare/v0.9.21...v0.9.22
Full Changelog: https://github.com/ai-dashboad/flutter-skill/compare/v0.9.21...v0.9.22
Support Chrome 146 WebMCP: discover and call navigator.modelContextTesting tools
Full Changelog: https://github.com/ai-dashboad/flutter-skill/compare/v0.9.20...v0.9.21
Full Changelog: https://github.com/ai-dashboad/flutter-skill/compare/v0.9.20...v0.9.21
Auto-accept Chrome 146 remote debugging consent dialog
Full Changelog: https://github.com/ai-dashboad/flutter-skill/compare/v0.9.18...v0.9.19
Full Changelog: https://github.com/ai-dashboad/flutter-skill/compare/v0.9.18...v0.9.19
Fix Chrome 146 consent port: skip Origin header in WebSocket upgrade
Full Changelog: https://github.com/ai-dashboad/flutter-skill/compare/v0.9.17...v0.9.18
Full Changelog: https://github.com/ai-dashboad/flutter-skill/compare/v0.9.17...v0.9.18
Support Chrome 146 consent-based remote debugging port
Full Changelog: https://github.com/ai-dashboad/flutter-skill/compare/v0.9.16...v0.9.17
Full Changelog: https://github.com/ai-dashboad/flutter-skill/compare/v0.9.16...v0.9.17
Session-copy profile: preserve user logins when Chrome 145+ blocks default profile debug port
Full Changelog: https://github.com/ai-dashboad/flutter-skill/compare/v0.9.15...v0.9.16
Full Changelog: https://github.com/ai-dashboad/flutter-skill/compare/v0.9.15...v0.9.16
Fix Chrome 145+ silently ignoring --remote-debugging-port on default profile
Full Changelog: https://github.com/ai-dashboad/flutter-skill/compare/v0.9.14...v0.9.15
Full Changelog: https://github.com/ai-dashboad/flutter-skill/compare/v0.9.14...v0.9.15
Remove Chrome for Testing dependency from CDP driver
Full Changelog: https://github.com/ai-dashboad/flutter-skill/compare/v0.9.13...v0.9.14
Full Changelog: https://github.com/ai-dashboad/flutter-skill/compare/v0.9.13...v0.9.14
Fix Page.enable hang on chrome://newtab; auto-enable remote debugging
Full Changelog: https://github.com/ai-dashboad/flutter-skill/compare/v0.9.12...v0.9.13
Full Changelog: https://github.com/ai-dashboad/flutter-skill/compare/v0.9.12...v0.9.13
Auto-tick chrome remote debugging checkbox; no Chrome restart
Full Changelog: https://github.com/ai-dashboad/flutter-skill/compare/v0.9.11...v0.9.12
Full Changelog: https://github.com/ai-dashboad/flutter-skill/compare/v0.9.11...v0.9.12
Restart existing Chrome with debug port; preserve user session
Full Changelog: https://github.com/ai-dashboad/flutter-skill/compare/v0.9.10...v0.9.11
Full Changelog: https://github.com/ai-dashboad/flutter-skill/compare/v0.9.10...v0.9.11
Auto-enable Chrome remote debugging when connecting via CDP
fill was listed in docs but threw Unknown tool: fill at runtime. Now registered and maps to clear + enter_text.
fill tool now worksfill was listed in docs but threw Unknown tool: fill at runtime. Now registered and maps to clear + enter_text.
press_key on iOS/AndroidAdded NativeDriver fallback so press_key works in Flutter VM Service mode on simulators and emulators. The Enter key now triggers iOS search without needing CDP mode.
enter_text without key — better errorInstead of No TextField matching key 'null' found, you now get an actionable hint field:
Call inspect_interactive() to list available TextFields, then pass 'key' or tap the field first.
go_back with count parameter{ "tool": "go_back", "params": { "count": 3 } }
Replaces 3 consecutive go_back() calls. A 300 ms pause between steps lets route transitions complete.
native_screenshot — coordinate hintResponse now includes scale_factor and coordinate_hint:
{
"scale_factor": 3.0,
"coordinate_hint": "Physical: 1206×2622px. Flutter tap() uses logical px — divide by 3. Logical: 402×874px."
}
No more manual pixel ratio guessing.
UX fixes: fill tool, press_key iOS fallback, go_back count, coordinate hint
fill tool registered: fill was documented but threw Unknown tool: fill. Now maps to enter_text (clear + set value). Closes user-reported issue.press_key on iOS/Android: Added NativeDriver fallback so press_key works in Flutter VM Service mode on simulators/emulators (previously returned unsupported error). Enter key now triggers iOS search without needing CDP mode.enter_text without key: When called without key/ref, returns an actionable hint field pointing to inspect_interactive() instead of the confusing No TextField matching key 'null' found error.go_back with count: Accepts a count parameter to pop multiple routes in one call with 300 ms pauses between steps — replaces repeated go_back() chains.native_screenshot coordinate hint: Response now includes scale_factor and a coordinate_hint field that explains the physical→logical pixel conversion, eliminating manual coordinate guessing.C++ Bridge SDK (sdks/cpp/) — Embed a zero-dependency WebSocket bridge in any native C++ app so AI agents can automate it via the flutter-skill protoco
C++ Bridge SDK (sdks/cpp/) — Embed a zero-dependency WebSocket bridge in any native C++ app so AI agents can automate it via the flutter-skill protocol.
| Platform | Input Synthesis | Screenshot | Accessibility |
|---|---|---|---|
| macOS | CGEvent | screencapture | AXUIElement |
| Windows | SendInput | GDI+ | GetForegroundWindow |
| Linux | XTest | XGetImage + libpng | EWMH/Xlib |
#include <flutter_skill/bridge.h>
flutter_skill::FlutterSkillBridge bridge;
bridge.start(); // ws://127.0.0.1:18118
bridge.wait();
cmake -B build && cmake --build build
./build/flutter_skill_bridge
flutter_skill scan_and_connect
ping · initialize · screenshot · tap · enter_text · press_key · scroll · inspect · get_focused_window_title · get_logs · clear_logs
Closes #22.
C++ desktop automation SDK
sdks/cpp/): Cross-platform native C++ automation bridge. Embeds a zero-dependency WebSocket server (RFC 6455) + JSON-RPC 2.0 dispatcher in your C++ app so AI agents can control it via the flutter-skill protocol. Closes #22.
screencapture for screenshots, AXUIElement for accessibility inspectionSendInput + GDI+ (screenshots) + GetForegroundWindowCMakeLists.txt) for all three platformsFull Changelog: https://github.com/ai-dashboad/flutter-skill/compare/v0.9.7...v0.9.8
Full Changelog: https://github.com/ai-dashboad/flutter-skill/compare/v0.9.7...v0.9.8
Multi-flavor app detection, fresh-install UX, Docker/Snap build fixes, CI smoke tests
scan_and_connect now accepts flavor and device_id parameters. When multiple flavors run simultaneously, flutter-skill picks the correct instance instead of connecting randomly.Plugins directory not found warning on clean installs — silently skipped instead.ghcr.io/cirruslabs/flutter:stable so flutter pub get resolves Flutter SDK dependencies correctly.git config --global --add safe.directory /opt/flutter to resolve detected dubious ownership error in snapcraft builds.flutter pub global activate install works end-to-end.Full Changelog: https://github.com/ai-dashboad/flutter-skill/compare/v0.9.6...v0.9.7
Full Changelog: https://github.com/ai-dashboad/flutter-skill/compare/v0.9.6...v0.9.7
press_key for Flutter VM Service, pytest plugin, HarmonyOS SDK, CI smoke tests
press_key now works when connected via VM Service (not just CDP/bridge). Calls the existing ext.flutter.flutter_skill.pressKey extension that was already registered in the target app but never wired from the CLI side. Fixes #21.sdks/python/): pytest plugin for AI-driven Flutter/web app automation. Provides a flutter_skill fixture that starts the MCP server and wraps all tools as Python methods with native pytest assertions (assert_visible, assert_text, assert_not_visible, find_element). Closes #14.sdks/harmonyos/): ArkTS bridge SDK (FlutterSkillAbility.ets) for HarmonyOS apps. Implements screenshot, tap, enter_text, press_key, scroll, go_back, get_current_route, inspect, get_logs over WebSocket on port 18118. Closes #13.dart pub global activate, then verifies --version, MCP initialize, and tools/list work correctly.Full Changelog: https://github.com/ai-dashboad/flutter-skill/compare/v0.9.5...v0.9.6
Full Changelog: https://github.com/ai-dashboad/flutter-skill/compare/v0.9.5...v0.9.6
Shadow DOM deep pierce for tap/snapshot, serve port reuse fix
tap text search now uses _dqAll('*') instead of a hardcoded tag list, so custom elements like Reddit's faceplate-button are found by text matchbutton/[role=button]/[type=submit] elements nested inside shadow rootsserve binds with shared: true (SO_REUSEADDR) to avoid TIME_WAIT "Address already in use" crashes on restartFull Changelog: https://github.com/ai-dashboad/flutter-skill/compare/v0.9.4...v0.9.5
Full Changelog: https://github.com/ai-dashboad/flutter-skill/compare/v0.9.4...v0.9.5
Full Changelog: https://github.com/ai-dashboad/flutter-skill/compare/v0.9.3...v0.9.4
Full Changelog: https://github.com/ai-dashboad/flutter-skill/compare/v0.9.3...v0.9.4
Full Changelog: https://github.com/ai-dashboad/flutter-skill/compare/v0.9.2...v0.9.3
Full Changelog: https://github.com/ai-dashboad/flutter-skill/compare/v0.9.2...v0.9.3
typeText: keyDown+keyUp with execCommand('insertText') fallback for sites where dispatchKeyEvent fails (Google, Chrome 145+)
<a>, <button>, [role=tab] over hidden <kbd>/<span>tap Issues on GitHub now clicks nav tab correctlytype works on Google search textareaConnect to a running flutter-skill serve instance with simple one-line commands:
Connect to a running flutter-skill serve instance with simple one-line commands:
flutter-skill serve https://your-app.com # Start server
flutter-skill nav https://google.com # Navigate
flutter-skill snap # Accessibility snapshot (99% fewer tokens)
flutter-skill screenshot /tmp/ss.jpg # Screenshot
flutter-skill tap "Login" # Tap element
flutter-skill type "hello@example.com" # Type text
flutter-skill eval "document.title" # Run JavaScript
flutter-skill tools # List all tools
Supports --port=N, --host=H flags and FS_PORT/FS_HOST env vars.
Documentation site auto-deploys to GitHub Pages. See docs/site/.
New README section covering all supported AI platforms:
| Platform | Mode | Status |
|---|---|---|
| Cursor | MCP stdio | ✅ |
| Claude Desktop | MCP stdio | ✅ |
| Windsurf | MCP stdio | ✅ |
| VSCode Copilot | MCP stdio | ✅ |
| Cline | MCP stdio | ✅ |
| OpenClaw | HTTP serve | ✅ |
| Continue.dev | MCP stdio | ✅ |
| CLI / CI/CD | HTTP serve | ✅ |
Full Changelog: https://github.com/ai-dashboad/flutter-skill/compare/v0.9.0...v0.9.1
CLI client commands, GitHub Pages docs, comprehensive platform guide
nav, snap, screenshot, tap, type, key, eval, title, text, hover, upload, tools, call, waitdocs/site/ with auto-deploy workflowdocs/CLI_CLIENT.md) with scripting examples and CI/CD patterns6 native P0 tools: native_long_press, native_gesture, native_press_key, native_key_combo, native_button, native_list_simulators
native_long_press, native_gesture, native_press_key, native_key_combo, native_button, native_list_simulatorsnative_video_start / native_video_stop — H.264 MP4 via simctlnative_capture_frames — burst JPEG at configurable FPSget_widget_tree and native_snapshot now auto-fallback to bridge inspect for non-Flutter appsexecute_batch accepts both actions and commands param namesnative_gesture/native_key_combo flexible param types| Platform | Pass | Total | Rate |
|---|---|---|---|
| Web CDP | 128 | 128 | 100% |
| iOS Native | 28 | 29 | 97% |
| iOS Multi-App (7 apps) | 62 | 62 | 100% |
| iOS Cross-Stack | 28 | 28 | 100% |
| iOS Bridge (Flutter) | 62 | 62 | 100% |
| React Native iOS | 41 | 42 | 98% |
# npm (recommended)
npx flutter-skill@latest server
# Dart
dart pub global activate flutter_skill
# Homebrew
brew install anthropic/tap/flutter-skill
iOS native automation + React Native support + bridge reliability
native_long_press, native_gesture, native_press_key, native_key_combo, native_button, native_list_simulatorsnative_video_start / native_video_stop — H.264 MP4 via simctl recordVideonative_capture_frames — burst JPEG at configurable FPSapple_pay and side button support via HID injectionactions and commands param names| Platform | Pass | Total | Rate |
|---|---|---|---|
| Web CDP | 128 | 128 | 100% |
| iOS Native | 28 | 29 | 97% |
| iOS Multi-App | 62 | 62 | 100% |
| iOS Cross-Stack | 28 | 28 | 100% |
| iOS Bridge (Flutter) | 62 | 62 | 100% |
| React Native iOS | 41 | 42 | 98% |
Full Changelog: https://github.com/ai-dashboad/flutter-skill/compare/v0.7.8...v0.8.0
Full Changelog: https://github.com/ai-dashboad/flutter-skill/compare/v0.7.8...v0.8.0
inspect_interactive, semantic refs, press_key, 75-test E2E suite
Full Changelog: https://github.com/ai-dashboad/flutter-skill/compare/v0.7.7...v0.7.8
Full Changelog: https://github.com/ai-dashboad/flutter-skill/compare/v0.7.7...v0.7.8
Release 0.7.8
Full Changelog: https://github.com/ai-dashboad/flutter-skill/compare/v0.7.6...v0.7.7
Full Changelog: https://github.com/ai-dashboad/flutter-skill/compare/v0.7.6...v0.7.7
Release 0.7.7
Full Changelog: https://github.com/ai-dashboad/flutter-skill/compare/v0.7.5...v0.7.6
Full Changelog: https://github.com/ai-dashboad/flutter-skill/compare/v0.7.5...v0.7.6
CI improvements + MCP Registry auto-publish
Full Changelog: https://github.com/ai-dashboad/flutter-skill/compare/v0.7.3...v0.7.4
Full Changelog: https://github.com/ai-dashboad/flutter-skill/compare/v0.7.3...v0.7.4
Multi-framework SDK support — 8 platforms, 181/183 E2E tests passing
flutter-skill init auto-detects platform and patches entry pointsflutter-skill demo: launches a built-in demo Flutter app for instant testingbridge_e2e_test.mjs) covering all 13 bridge protocol actionstest/e2e/Full Changelog: https://github.com/ai-dashboad/flutter-skill/compare/v0.7.2...v0.7.3
Full Changelog: https://github.com/ai-dashboad/flutter-skill/compare/v0.7.2...v0.7.3
Release script fix and cleanup
Full Changelog: https://github.com/ai-dashboad/flutter-skill/compare/v0.7.1...v0.7.2
Full Changelog: https://github.com/ai-dashboad/flutter-skill/compare/v0.7.1...v0.7.2
Fix type cast errors in get_errors and get_network_requests
get_errors crashing with type 'String' is not a subtype of type 'int?' when passing limit/offset parametersget_network_requests with same type cast issue for limit parameterint.tryParse pattern instead of direct as int? cast for JSON-RPC paramsFull Changelog: https://github.com/ai-dashboad/flutter-skill/compare/v0.7.0...v0.7.1
Full Changelog: https://github.com/ai-dashboad/flutter-skill/compare/v0.7.0...v0.7.1
Bug fixes, screenshot reliability, and new features
Navigator.push(). Now captures from the RenderView layer instead of first RepaintBoundary, correctly rendering the current visible pageenter_text(text: "...")assert_text now reads child Text widgets from buttons, labels, and other non-TextField elementsconnect_app, launch_app, and scan_and_connect now always switch the active session to the newly connected appsave_to_file support (saves to temp file like regular screenshot)limit and offset parameters to prevent massive responsescurrent_page_only parameter to filter out elements from old Navigator routesenable_network_monitoring, get_network_requests, clear_network_requests) for tracking HTTP traffic via VM Service profilingscreenshot_region now reuses the same RenderView layer capture, fixing the same stale-page issue as regular screenshotsFull Changelog: https://github.com/ai-dashboad/flutter-skill/compare/v0.6.0...v0.7.0
Full Changelog: https://github.com/ai-dashboad/flutter-skill/compare/v0.6.0...v0.7.0
Enhanced developer experience: install scripts, CLI tips, and doctor command
flutter-skill doctor: New command to check installation and environment health (Flutter/Dart SDK, devices, native tools, IDE config, tool priority rules)--version / -v flag: Quick version check from CLI (flutter-skill --version)flutter-skill-mcp in terminal shows helpful usage guide with examples instead of hanging~/.claude/settings.json) and Cursor (~/.cursor/mcp.json)printf instead of echo -e)--force npm warning during updatesConvertFrom-Json/ConvertTo-Jsonlib/src/cli/doctor.dart - Environment health checkeruninstall.sh - Clean uninstall for macOS/Linuxuninstall.ps1 - Clean uninstall for Windowsscripts/release.sh now auto-syncs Homebrew formula versionFull Changelog: https://github.com/ai-dashboad/flutter-skill/compare/v0.6.0...v0.6.2
Full Changelog: https://github.com/ai-dashboad/flutter-skill/compare/v0.6.0...v0.6.2
Improve pub.dev score
example/example.dart for pub.dev package scoringvm_service dependency to >=14.0.0 <16.0.0 (supports v15)demo_app/ to .pubignoreColor.withValues() with withOpacity() for Flutter 3.24 compatibilityFull Changelog: https://github.com/ai-dashboad/flutter-skill/compare/v0.6.0...v0.6.1
Full Changelog: https://github.com/ai-dashboad/flutter-skill/compare/v0.6.0...v0.6.1
Native platform interaction tools and VM Service reconnection fix
native_screenshot, native_tap, native_input_text, native_swipe) for interacting with native OS views that are invisible to Flutter's VM Service (photo pickers, permission dialogs, share sheets)
LateInitializationError crash when VM Service connection breaks. Client now auto-reconnects and retries failed operations transparentlyFull Changelog: https://github.com/ai-dashboad/flutter-skill/compare/v0.5.5...v0.6.0
Full Changelog: https://github.com/ai-dashboad/flutter-skill/compare/v0.5.5...v0.6.0
Enhanced smart discovery with parallel port checking and priority-based selection
Future.any() to race all port checksps aux and lsof for instant discoverydocs/SMART_DISCOVERY.md - Complete smart discovery documentationdocs/SMART_SELECTION.md - Smart app selection guidedocs/MULTI_APP_SELECTION.md - Multi-app handling documentationFull Changelog: https://github.com/ai-dashboad/flutter-skill/compare/v0.5.4...v0.5.5
Full Changelog: https://github.com/ai-dashboad/flutter-skill/compare/v0.5.4...v0.5.5
Fix Twitter OAuth authentication
nearform-actions/github-action-notify-twitter action for OAuth signingFull Changelog: https://github.com/ai-dashboad/flutter-skill/compare/v0.5.3...v0.5.4
Full Changelog: https://github.com/ai-dashboad/flutter-skill/compare/v0.5.3...v0.5.4
Add automated Twitter/X posting for release announcements
docs/TWITTER_SETUP.md with complete Twitter API configuration guide
Full Changelog: https://github.com/ai-dashboad/flutter-skill/compare/v0.5.2...v0.5.3
Full Changelog: https://github.com/ai-dashboad/flutter-skill/compare/v0.5.2...v0.5.3
Add automated Winget PR submission to release workflow
winget-releaser GitHub Action for automatic PR creationwinget install AIDashboard.FlutterSkillFull Changelog: https://github.com/ai-dashboad/flutter-skill/compare/v0.5.1...v0.5.2
Full Changelog: https://github.com/ai-dashboad/flutter-skill/compare/v0.5.1...v0.5.2
Critical bug fixes for coordinate detection and JSON serialization
🔧 Fixed JSON Serialization Error in find_by_type: Added safeRound() helper to handle NaN/Infinity values
inspect() implementation📍 Improved TextField Coordinate Detection: Added reliability detection for widget coordinates
coordinatesReliable flag on all elementsinspect and find_by_type documentation
coordinatesReliable flag in output formatNo breaking changes. New coordinatesReliable field is optional to check:
// Check coordinate reliability before using coordinates
final elements = await inspect();
for (final element in elements) {
if (element['coordinatesReliable'] == true) {
// Safe to use bounds/center coordinates
tap(x: element['center']['x'], y: element['center']['y']);
} else {
// Fall back to key/text targeting
if (element['key'] != null) {
tap(key: element['key']);
}
}
}
Full Changelog: https://github.com/ai-dashboad/flutter-skill/compare/v0.5.0...v0.5.1
Full Changelog: https://github.com/ai-dashboad/flutter-skill/compare/v0.5.0...v0.5.1
Major usability improvements for screenshots, errors, and logging
📸 Screenshot Optimization: Now saves to file by default instead of returning base64
save_to_file parameter (default: true)save_to_file=false for base64🔌 Improved Connection Error Messages: Detailed, actionable error messages
get_logs(): Returns logs with summary (total_count, message)get_errors(): Returns errors with summary (has_errors, total_count, message)clear_logs(): Returns structured success responseScreenshot:
// New behavior (default)
screenshot() // Returns: {"file_path": "/tmp/...", "size_bytes": 45678}
// Legacy behavior
screenshot(save_to_file: false) // Returns: {"image": "base64..."}
Logs/Errors:
// New response format
get_errors()
// Returns: {
// "errors": [...],
// "summary": {
// "total_count": 3,
// "has_errors": true,
// "message": "3 error(s) found ⚠️"
// }
// }
Full Changelog: https://github.com/ai-dashboad/flutter-skill/compare/v0.4.9...v0.5.0
Full Changelog: https://github.com/ai-dashboad/flutter-skill/compare/v0.4.9...v0.5.0
Add visual test indicators for UI automation
minimal: Small, fast (200ms), no hintsstandard: Medium, normal speed (500ms), 1s hints (default)detailed: Large, slow (800ms), 2s hints + debug infoenable_test_indicators(enabled: true, style: "standard")get_indicator_status()enableIndicators, disableIndicators, getIndicatorStatusTestIndicatorOverlay: Manages overlay entry and indicator lifecycleTestIndicatorWidget: Renders all visual effects with smooth animationsTapIndicator, SwipeIndicator, LongPressIndicator, TextInputIndicator, ActionHint// Enable indicators
await enable_test_indicators(enabled: true, style: "standard");
// All actions now show visual feedback automatically
await tap(text: "Submit"); // Shows tap ripple + "Tapping 'Submit'"
await swipe(direction: "left"); // Shows swipe arrow + "Swiping left"
await long_press(text: "Menu"); // Shows progress circle + "Long pressing 'Menu'"
await enter_text(key: "email", text: "test@example.com"); // Shows glow + "Entering text"
// Disable when done
await enable_test_indicators(enabled: false);
docs/TEST_INDICATORS_DESIGN.mdFull Changelog: https://github.com/ai-dashboad/flutter-skill/compare/v0.4.8...v0.4.9
Full Changelog: https://github.com/ai-dashboad/flutter-skill/compare/v0.4.8...v0.4.9
Fix screenshot_element null handling and add text parameter
screenshot_elementtext parameter support (in addition to key) for finding elements by text contenttext parameter is providedtakeElementScreenshot return valuescreenshot_element now matches behavior of other action tools (tap, long_press, etc.)screenshot_element(key: "button_1") and screenshot_element(text: "Submit")getInteractiveElements() to find matching text when key not provided{"error": "...", "message": "..."} instead of crashing on nullFull Changelog: https://github.com/ai-dashboad/flutter-skill/compare/v0.4.7...v0.4.8
Full Changelog: https://github.com/ai-dashboad/flutter-skill/compare/v0.4.7...v0.4.8
Fix Infinity/NaN crash when inspecting widgets
_findInteractiveElementssafeRound() helper function to handle invalid numeric valuesInfinity and NaN values (returns 0)Positioned.fill, FractionalTranslation, and malformed widget treesvalue.isFinite before calling .round() on position/size values{x: 0, y: 0, width: 0, height: 0} for invalid boundsFull Changelog: https://github.com/ai-dashboad/flutter-skill/compare/v0.4.6...v0.4.7
Full Changelog: https://github.com/ai-dashboad/flutter-skill/compare/v0.4.6...v0.4.7
Auto-update flutter_skill dependency in target projects
setup now automatically updates existing flutter_skill dependency to latest version from pub.devflutter pub upgrade flutter_skill checks when dependency already existsFull Changelog: https://github.com/ai-dashboad/flutter-skill/compare/v0.4.5...v0.4.6
Full Changelog: https://github.com/ai-dashboad/flutter-skill/compare/v0.4.5...v0.4.6
Fix release script to auto-update server.dart version
_currentVersion in lib/src/cli/server.dartFull Changelog: https://github.com/ai-dashboad/flutter-skill/compare/v0.4.4...v0.4.5
Full Changelog: https://github.com/ai-dashboad/flutter-skill/compare/v0.4.4...v0.4.5
Add MCP auto-fix and diagnostics
diagnose_project MCP tool for comprehensive project diagnosticsconnect_app and scan_and_connect toolsproject_path parameter for automatic configurationscripts/diagnose.sh) for manual troubleshootingflutter_skill dependencyFlutterSkillBinding initializationproject_path parameter)One column per month.