Skip to content
pubscout

fdb

1.15.1, released 4 weeks ago by appflate.io

CLI for AI agents to interact with running Flutter apps on device.

$ flutter pub add fdb
Source repository

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 reload

Alternatives

Packages that do the same job and could replace fdb.

Works with

Packages commonly used together with fdb: ones it builds on, ones built on it, and its own family.