Agent skill

Flutter MCP E2E Harness

by Arenukvern in Arenukvern/mcp_flutter

A skill your agent uses when writing or running repeatable E2E scenarios for Flutter apps as checked-in Dart with the fluttermcpharness package (packages/harness) — build/launch the app, attach to…

MITAuto-check passedMobile

Install Flutter MCP E2E Harness

skills CLI
$ npx skills add Arenukvern/mcp_flutter --skill flutter-mcp-e2e-harness -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install Arenukvern/mcp_flutter flutter-mcp-e2e-harness --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/Arenukvern/mcp_flutter.git skills-src && mkdir -p .claude/skills && cp -r skills-src/plugin/skills/flutter-mcp-e2e-harness .claude/skills/flutter-mcp-e2e-harness && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
flutter-mcp-e2e-harness
GitHub stars
386
Token cost
~2.2k tokens
SKILL.md length
769 words
Files
1
Skills in repo
23
Repo updated
First seen
Licence
MIT

At a glance

A skill your agent uses when writing or running repeatable E2E scenarios for Flutter apps as checked-in Dart with the fluttermcpharness package (packages/harness) — build/launch the app, attach to…

  • Attach to its VM service
  • SKILL.md covers Launch paths (pick by ownership), Scenario anatomy, Driving widgets (WidgetDriver) and Showcase launcher…, plus 3 more sections
  • Calls make, flutter and dart
  • Drive widgets (snapshot/tap/enter text) and assert without MCP

What it does

Flutter MCP E2E Harness is an agent skill from Arenukvern/mcp_flutter. Use this skill when writing or running repeatable E2E scenarios for Flutter apps as checked-in Dart with the fluttermcpharness package (packages/harness) — build/launch the app, attach to its VM service, drive widgets (snapshot/tap/enter text) and assert without MCP; also covers the repo showcase launcher (make showcase, --web, --stop) and multi-instance desktop compositions. For interactive assistant-driven debugging through MCP fmt tools, use flutter-mcp instead.

Its SKILL.md is about 2.2k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Mobile, covering Cross-platform mobile apps, End-to-end testing and MCP servers. It works with Model Context Protocol, Flutter and Dart. The repository describes itself as: MCP Toolkit for Flutter AI Agent Driven Development (MCP/CLI + custom client side tools) - via closed feedback loop (visual & semantic snapshot) and high client side… The licence is MIT.

When your agent uses it

  • Attach to its VM service
  • Drive widgets (snapshot/tap/enter text) and assert without MCP
  • Also covers the repo showcase launcher (make showcase
  • --stop) and multi-instance desktop compositions

Example prompts

  • “/flutter-mcp-e2e-harness”

What it can do on your machine

Read from SKILL.md and the folder at commit 62f3ee1. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • make
    • flutter
    • dart

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Flutter MCP E2E Harness loads about 2.2k tokens when it runs. Until then it costs about 128 tokens; SKILL.md has 769 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~128
When it runs · the whole SKILL.md, loaded when a task matches
~2.2k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from Arenukvern/mcp_flutter at commit 62f3ee1, republished under its MIT licence (© Arenukvern). 769 words, ~2,182 tokens.

Download SKILL.mdSave it as .claude/skills/flutter-mcp-e2e-harness/SKILL.md (or your agent's skills folder).
name
flutter-mcp-e2e-harness
description
Use this skill when writing or running repeatable E2E scenarios for Flutter apps as checked-in Dart with the `flutter_mcp_harness` package (`packages/harness`) — build/launch the app, attach to its VM service, drive widgets (snapshot/tap/enter text) and assert without MCP; also covers the repo showcase launcher (`make showcase`, `--web`, `--stop`) and multi-instance desktop compositions. For interactive assistant-driven debugging through MCP `fmt_*` tools, use `flutter-mcp` instead.
<!-- @FMT_MODE_PRELUDE -->

Flutter MCP E2E Harness

Golden path for programmatic E2E over the toolkit: packages/harness (flutter_mcp_harness) owns the whole lifecycle — build the app, launch the process, attach to its Dart VM service, and only then drive/assert. It speaks the same ext.mcp.toolkit.* service extensions as the MCP server, as plain Dart. ADR: decisions/0015_flutter_mcp_harness_extraction.mdx.

The driving layer speaks the universal AutomationDriver contract (ADR-0038, universal_automation_interface): ToolkitDriver exposes the observe/act/verify loop (snapshot → semantic AxNode tree with refs and bounds; perform click/type/key/named-route-navigate/evaluate; screenshot PNG), so the same agent vocabulary drives Flutter apps, browsers (CdpDriver), and OS-native targets. IntentDriverRouter additionally routes an intent's automation hint (transport + verb + locator) onto the bound driver. Frame pipelines are deliberately NOT a harness dependency — they are composition-level (showcase/drivers, which also holds the live end-to-end drives: make drive-flutter / drive-flutter-chrome / drive-web).

App-specific verbs use the invoke tier (ADR-0017): the app's intent registry IS the action catalog — driver.actions() lists it, and InvokeAction(name, args) dispatches to a registered entry with schema-validated arguments (custom IntentAutomationAction.custom hints route the same way). Web surfaces without a VM service (Jaspr, plain JS) compose identically over CdpDriver via the window.__mcpActions page registry.

NeedUse
Repeatable scenario as code, CI-friendly exit codesthis skill (flutter_mcp_harness)
One-off interactive debugging from chat/editorflutter-mcp (MCP fmt_* tools)
Browser/WebMCP dogfood of the web showcaseflutter-mcp-toolkit-maintain-web
Live end-to-end showcase drives (both tiers)showcase/drivers (make drive-flutter / drive-web)

Launch paths (pick by ownership)

The #1 rule: at most one owning session per app. A second flutter run/flutter attach on a session someone else owns is the ADR-0014 failure mode (the second attach can kill the first).

TargetWhenNotes
FlutterRunTargetYou want the flutter tool to own build + hot reload (r/R/q via stdin). The showcase launch path.device (macos, chrome, …), extraArgs, onLine tee for long cold builds; VM URI scraped from the tool's own announcement.
BinaryAppTarget / MacosAppTarget / WindowsAppTargetFresh full flutter build <os> --debug → launch the binary directly. No compile channel afterwards.Pass launch(build: false) to reuse an existing binary. Never opens an owning session.
External runner (e.g. oka dev) owns the appConstruct LaunchedApp directly around the owning process and read the VM URI from the runner-session contract, not stdout.This package never imports the runner; callers wire it (LaunchedApp(name:, process:, stdout:, vmUri:)).

FlutterRunTarget.launch(build:) ignores the flag — flutter run always builds. A failed bring-up reaps the session (SIGTERM → child-reaping pkill → SIGKILL) before rethrowing.

Scenario anatomy

dart
final scenario = Scenario('checkout E2E', steps: [
  ('launch app', (context) async {
    final app = await MacosAppTarget(projectDir: appDir, binaryPath: binary)
        .launch(build: build);
    launched = app;                       // for finally-stop
    await app.stdout.waitFor('app ready'); // no sleeps — wait on logs
    context.bag['app'] = app;             // hand values between steps
  }),
  ('drive + assert', (context) async {
    final driver = WidgetDriver(await context.take<LaunchedApp>('app').vm());
    final ref = await driver.findRef('checkout');
    if (ref == null) return context.report.fail('no checkout button');
    await driver.tap(ref);
    final total = await driver.findValue((v) => v.startsWith(r'$'));
    total != null
        ? context.report.pass('total rendered: $total')
        : context.report.fail('no total in snapshot');
  }),
]);

var passed = false;
try {
  passed = await scenario.run();
  scenario.report.printSummary();
} finally {
  await launched?.stop();                 // cleanup always runs
}
exit(passed ? 0 : 1);
  • Steps run in order; first failure (thrown or report.fail) aborts the rest — cleanup still happens in the caller's finally.
  • HarnessContext.bag passes values between steps; take<T>(key) reads them.
  • retry(action) polls until non-null (for app-side readiness races).
  • Full two-instance composition root: packages/harness/example/desktop_pair.dart.
Show full SKILL.md (342 more words)Show less

Driving widgets (WidgetDriver)

  • snapshot() → (label, ref) pairs; findRef(needle) is case-insensitive substring + retry until timeout.
  • tap(ref), tapUntil(ref, until: …) (re-tap until a predicate fires), enterText(ref, text), scroll(direction:, distance:) — off-screen semantics only exist once scrolled into view.
  • findValue(predicate) reads a node's selectable-text value — the deterministic way to read app-rendered data (clipboards and icon-only copy buttons are not).
  • Cold-attach race: the app may not have registered the toolkit yet when you attach. The driver answers RPC error -32601 with an empty snapshot so findRef's retry loop rides it out instead of aborting — do not treat one empty snapshot as proof the UI is empty.
  • VmClient extras: extensionNames() (discoverability), evaluate(expr), hotReload(). Raw reloadSources cannot compile without an owning flutter run/attach session — treat true as "asked", not "recompiled".

Showcase launcher (packages/harness/tool/showcase.dart)

bash
make showcase        # macOS showcase, interactive foreground (r/R/q relayed)
make web-showcase    # Chrome + WebMCP flags; WEB_PORT/VM_HOST_PORT/FLIGHT… env
make showcase-stop   # kill stray sessions, free VM port 8181 (idempotent)
  • --web --detach (or make-less dart run packages/harness/tool/showcase.dart --web --detach) spawns headless-ish, waits for the ws:// VM URI in .showcase/web_app.log, prints WS_URI=…, exits 0 — the CI-friendly variant.
  • Artifacts under .showcase/: flutter_app.log / web_app.log (teed output) and flutter.pid / web_flutter.pid pid files.
  • IntentCall doors (second terminal, against the running showcase): dart run packages/harness/tool/intentcall_session.dart [demo|serve-link|serve-debug] — resolves the VM service URI from the showcase log (--vm-service-uri pins one) and the IntentCall CLI from INTENTCALL_ROOT, sibling checkouts, or PATH.
  • Interactive mode tees every line to the log (which make exec-sweep greps) and tears the session down on exit or Ctrl-C.
  • WS URI for follow-up calls: grep -Eo 'ws://127\.0\.0\.1:[0-9]+/[A-Za-z0-9_=-]+/ws' .showcase/flutter_app.log | tail -1.

Hard boundaries

  • No new toolkit verbs. ToolkitExtensions mirrors mcp_toolkit/lib/src/toolkits/interaction_toolkit.dart; keep the lists in lockstep — drift is caught by extension calls failing at runtime today (shared-constants follow-up will make it a compile error).
  • No owned compile sessions in BinaryAppTarget — full fresh builds only.
  • No declarative scenario documents (YAML runners) — the external flutter_harness experiment (ADR-0012) is retired (ADR-0017). Composition roots are consuming-project code (see example/).
  • Android/iOS device bring-up is delegated to the owning dev session (oka_harness, ADR-0014) — not this package.

Verify

bash
cd packages/harness && dart test        # unit tests (canned envelopes, fake flutter)
dart run example/desktop_pair.dart --skip-build
  • flutter-mcp — the interactive MCP loop over the same extensions
  • flutter-mcp-automation-chain — cross-tier wiring for your own app (surface picker, oka integration, runner sessions)
  • flutter-mcp-toolkit-maintain-macos / -maintain-web — showcase + platform lanes
  • packages/harness/README.md, ADR-0014 (runner delegation), ADR-0015 (extraction)

© Arenukvern, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in plugin/skills/flutter-mcp-e2e-harness of Arenukvern/mcp_flutter.

Open the folder on GitHubat commit 62f3ee1

Compare with similar skills

Flutter MCP E2E Harness next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Flutter MCP E2E Harness compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Flutter MCP E2E Harness this skillArenukvern/mcp_flutter386—~2.2kAutomated safety check: PassMIT
MCP Dart Clientleehack/mcp_dart116—~1.8kAutomated safety check: PassMIT
Green GateVeryGoodOpenSource/vgv-ai-flutter-plugin170—~4.7kAutomated safety check: NotesMIT
Aaalice Dev SessionsAaalice233/Aaalice_NAI_Launcher188—~902Automated safety check: PassMIT
macOS Desktop QAsesori-ai/sesori_apps_monorepo126—~2.3kAutomated safety check: PassCustom licence
Aaalice Hot ReloadAaalice233/Aaalice_NAI_Launcher188—~531Automated safety check: PassMIT

Similar skills

  • MCP Dart Client

    leehack/mcp_dart

    A skill your agent uses when connecting a Dart or Flutter app to a Model Context Protocol (MCP) server with mcpdart: creating an McpClient, launching a local server over stdio or reaching a remote…

    116 GitHub stars~1.8k tokensUpdated 4 days ago
    Agent WorkflowsAuto-check passed
  • Green Gate

    VeryGoodOpenSource/vgv-ai-flutter-plugin

    Drives a Dart or Flutter package fully green through a verify-fix-rerun loop across four gates: analyze, format, test, coverage.

    170 GitHub stars~4.7k tokensUpdated 3 days ago
    MobileAuto-check: notes
  • Aaalice Dev Sessions

    Aaalice233/Aaalice_NAI_Launcher

    管理 Aaalice NAI Launcher 项目专用的 Windows 与 Android Flutter 开发会话。用户提到 PC热重载、安卓热重载、启动/关闭/重建独立命令行窗口、模拟器启动异常或检查双端会话时使用。

    188 GitHub stars~902 tokensUpdated 4 days ago
    MobileAuto-check passed
  • macOS Desktop QA

    sesori-ai/sesori_apps_monorepo

    Build, launch, inspect, and exercise the Sesori macOS desktop app as a real QA target.

    126 GitHub stars~2.3k tokensUpdated today
    MobileAuto-check passed
  • Aaalice Hot Reload

    Aaalice233/Aaalice_NAI_Launcher

    为 Aaalice NAI Launcher 修改代码后选择并执行 Windows/Android 的 r 热重载、R 热重启或完整重建,并验证结果。已有开发会话运行时,代码修改完成后自动使用;用户要求热重载、热重启、修改后刷新或查看 Flutter 日志时也使用。

    188 GitHub stars~531 tokensUpdated 4 days ago
    MobileAuto-check passed
  • Aaalice Runtime Verify

    Aaalice233/Aaalice_NAI_Launcher

    用户要求自动化运行验收、界面操作、截图检查或双端 UI 测试时,自动启动或复用 Aaalice NAI Launcher 热重载会话,通过项目级 Dart/Flutter MCP 验证应用;Android 系统界面按需使用 ADB。

    188 GitHub stars~963 tokensUpdated 4 days ago
    MobileAuto-check passed

More from Arenukvern/mcp_flutter

All 23 skills in this repo
  • Harness Engineering Lifecycle

    Arenukvern/mcp_flutter

    Design, implement, and integrate generalized validation harnesses across a producer-consumer boundary after a local harness contract exists.

    386 GitHub stars~1.6k tokensUpdated 6 days ago
    Auto-check passed
  • Mixture Of Experts

    Arenukvern/mcp_flutter

    Run a Mixture of Experts (MoE) audit on any topic, plan, codebase, evidence archive, or process.

    386 GitHub stars~2.3k tokensUpdated 6 days ago
    Auto-check passed
  • Multi Agent Handoff

    Arenukvern/mcp_flutter

    Plan and document handoffs, parent lane contracts, and parallel batch contracts between specialized AI agents (foreman, workers, reviewers).

    386 GitHub stars~2.7k tokensUpdated 6 days ago
    Auto-check passed
  • Plugin Marketplace Setup

    Arenukvern/mcp_flutter

    Designs public or private Agent Skill and plugin marketplaces for Cursor, Claude Code, Codex, Zed, Open Plugin, and npx skills—manifest layout, install matrix, and Skill Steward vs product boundaries.

    386 GitHub stars~2.9k tokensUpdated 6 days ago
    Auto-check passed
  • Release Changelog Harness

    Arenukvern/mcp_flutter

    Chooses ecosystem-native release and changelog tooling (Changesets, Melos, release-plz) plus binary distribution (GitHub Release tarballs, install.sh) when the product is an executable.

    386 GitHub stars~2.6k tokensUpdated 6 days ago
    Auto-check passed
  • Repository Governance Lifecycle

    Arenukvern/mcp_flutter

    Master orchestration for repository governance, North Star impact, sub-Star boundaries, and repair-first or evidence-first drift checks.

    386 GitHub stars~1.5k tokensUpdated 6 days ago
    Auto-check passed

Questions about Flutter MCP E2E Harness

What does Flutter MCP E2E Harness do?

A skill your agent uses when writing or running repeatable E2E scenarios for Flutter apps as checked-in Dart with the fluttermcpharness package (packages/harness) — build/launch the app, attach to…. Flutter MCP E2E Harness is an agent skill from Arenukvern/mcp_flutter. Use this skill when writing or running repeatable E2E scenarios for Flutter apps as checked-in Dart with the fluttermcpharness package (packages/harness) — build/launch the app, attach to its VM service, drive widgets (snapshot/tap/enter text) and assert without MCP; also covers the repo showcase launcher (make showcase, --web, --stop) and multi-instance desktop compositions.

When should I use Flutter MCP E2E Harness?

Flutter MCP E2E Harness fits situations like: attach to its VM service; drive widgets (snapshot/tap/enter text) and assert without MCP; also covers the repo showcase launcher (make showcase; --stop) and multi-instance desktop compositions.

How do I install Flutter MCP E2E Harness in Claude Code?

Run `npx skills add Arenukvern/mcp_flutter --skill flutter-mcp-e2e-harness -a claude-code`. Or copy the skill folder (plugin/skills/flutter-mcp-e2e-harness in Arenukvern/mcp_flutter) into .claude/skills/flutter-mcp-e2e-harness in your project. Claude Code loads it when a task matches its description.

How do I install Flutter MCP E2E Harness in Codex?

Run `npx skills add Arenukvern/mcp_flutter --skill flutter-mcp-e2e-harness -a codex`. Or copy the skill folder (plugin/skills/flutter-mcp-e2e-harness in Arenukvern/mcp_flutter) into .agents/skills/flutter-mcp-e2e-harness in your project. Codex loads it when a task matches its description.

Can I use Flutter MCP E2E Harness in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add Arenukvern/mcp_flutter --skill flutter-mcp-e2e-harness -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/flutter-mcp-e2e-harness, .gemini/skills/flutter-mcp-e2e-harness, .github/skills/flutter-mcp-e2e-harness and .opencode/skills/flutter-mcp-e2e-harness in your project.

What does Flutter MCP E2E Harness need to run?

Going by SKILL.md and its folder, Flutter MCP E2E Harness needs the command-line tools its instructions call (make, flutter and dart).

Does Flutter MCP E2E Harness access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Flutter MCP E2E Harness safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Flutter MCP E2E Harness use?

Flutter MCP E2E Harness is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Flutter MCP E2E Harness use?

About 2.2k tokens (SKILL.md is roughly 8.7k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Flutter MCP E2E Harness?

Skills that share tags, products or a category with Flutter MCP E2E Harness: MCP Dart Client (leehack/mcp_dart, 116 stars), Green Gate (VeryGoodOpenSource/vgv-ai-flutter-plugin, 170 stars), Aaalice Dev Sessions (Aaalice233/Aaalice_NAI_Launcher, 188 stars) and macOS Desktop QA (sesori-ai/sesori_apps_monorepo, 126 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Flutter MCP E2E Harness?

Arenukvern (a GitHub user) maintains it in Arenukvern/mcp_flutter, which has 386 GitHub stars. The repository holds 23 skills in this directory. The repository was last updated on October 3, 2026.

Source: Arenukvern/mcp_flutter on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.