beacon_bridge

• Shorten the package description to pub.dev's recommended 60–180 characters.
• Add an example/ directory walking through a full session.
• Set the formatter's page width to 120 to match the codebase, and format accordingly.

• Add IDE setup instructions for Android Studio / IntelliJ and VS Code, covering both halves of the setup: passing --vmservice-out-file to your app's run configuration, and running the bridge alongside it (a Shell Script run configuration, or a tasks.json task).
• Document that ~/.pub-cache/bin must be on your PATH after dart pub global activate.

• Point documentation at the Flutter package's published name, beacon_widget. The 0.1.0 release referred to it as beacon, a name pub.dev rejected as too similar to the existing beacons package.

Initial release.

• Attaches to a flutter run you started yourself — it never spawns or wraps flutter run, so it works with whatever flavor, device or run configuration you already use.
• Discovers the Dart VM Service by watching the file flutter run writes with --vmservice-out-file, and reconnects automatically across hot restarts and app relaunches.
• Writes .ref/sel-<id>.json plus a cropped .png for every selection, and copies a compact, paste-ready [ref] ... line to your clipboard.
• --format=multiline for terminal agents that handle newlines; the default is single-line, since many chat inputs treat a newline as "send".
• Handles combined multi-widget selections from beacon_widget's selection stack.
• Housekeeping: prunes .ref/sel-* older than an hour, on startup and periodically while running; warns once if .ref/ looks missing from your .gitignore.

Pairs with the beacon_widget Flutter package, which provides the on-device half.