fdb
1.15.1, released 4 weeks ago by appflate.io
CLI for AI agents to interact with running Flutter apps on device.
What it does
Provides a terminal CLI for AI coding agents and developers to launch, hot reload, screenshot, inspect the widget tree, filter logs, and interact with running Flutter apps on real devices and simulators.
AI-written summary of version 1.15.1, based on the package's README and metadata. Report an inaccuracy
Use it when
- You want an AI agent to see, run, and test your Flutter app on a real device or simulator via bash commands
- You need to take screenshots, hot reload, and inspect widget trees programmatically from the terminal
Skip it when
- You are looking for code analysis, package management, or static code assistance (use the official Flutter MCP server instead)
Strengths
- Works with any AI agent or environment that can run bash commands
- Requires zero dependencies in the Flutter app itself for basic tasks
- Enables end-to-end device interaction including screenshots, tapping, and hot reloading
Weaknesses
- Some advanced widget-targeted commands require the optional fdb_helper
- Physical iOS and desktop targets have limited or unsupported native interaction features
Setup
- Kind
- FFI (native library)
- Effort
- Low
- Code generation
- No
- Direct dependencies
- 5
Run 'dart pub global activate fdb' and ensure ~/.pub-cache/bin is in your PATH.
fdb launch --device <device_id> --project /path/to/app
fdb screenshot
fdb reloadAlternatives
Packages that do the same job and could replace fdb.
- talker_logger
Lightweight, customizable logger with filters, formatters and log levels
90Compare - flutter_agent_lens
MCP server connecting AI assistants to running Flutter applications for debugging.
64Compare - device_preview_screenshot
A plugin for device_preview that allows taking screenshots.
50Compare - flutter_blackbox
All-in-one Flutter debug overlay and live remote web dashboard for network, logs, and crashes.
60Compare
Works with
Packages commonly used together with fdb: ones it builds on, ones built on it, and its own family.
- vm_servicefdb depends on itA library to communicate with a service implementing the Dart VM service protocol.
- ffifdb depends on itUtilities for working with Foreign Function Interface (FFI) code in Dart.
- argsfdb depends on itLibrary for parsing raw command-line arguments into options and values using GNU and POSIX styles.
- imagefdb depends on itPure Dart library to load, manipulate, encode, and decode various image formats.