ai-dashboad/flutter-skill

Give any AI agent eyes and hands inside any running app.
10 platforms. Zero test code. One MCP server.
Demo •
Quick Start •
AI Platforms •
Platforms •
vs Others •
Docs
🚀 Zero config. Zero test code. Just talk to your AI.
If this saves you time, please consider starring the repo ⭐ — it helps others find it!
---
30-Second Demo
https://github.com/user-attachments/assets/d4617c73-043f-424c-9a9a-1a61d4c2d3c6
> **One prompt. 28 AI-driven actions. Zero test code.** The AI explores a TikTok clone, navigates tabs, scrolls feeds, tests search, fills forms — all autonomously.
---
Why This Exists
Writing E2E tests is painful. Maintaining them is worse. **flutter-skill** takes a different approach:
- 🔌 **Connects any AI agent** (Claude, Cursor, Windsurf, Copilot, OpenClaw) directly to your running app via MCP
- 👀 **The agent sees your screen** — taps buttons, types text, scrolls, navigates — like a human tester who never sleeps
- ✅ **Zero test code** — no Page Objects, no XPath, no brittle selectors. Just plain English
- ⚡ **Zero config** — 2 lines of code, works on all 10 platforms
---
Quick Start
**1. Install** (30 seconds)
**2. Add to your AI** (copy-paste into MCP config)
> Works with **Claude Desktop, Cursor, Windsurf, Copilot, Cline, OpenClaw** — any MCP-compatible agent.
**3. Add to your app** (2 lines for Flutter)
**4. Test** — just talk to your AI:
> *"Launch my app, explore every screen, and report any bugs"*
That's it. **Zero configuration. Zero test code. Works in under 60 seconds.**
📦 More install methods (Homebrew, Scoop, Docker, IDE, Agent Skill)
| Method | Command |
|--------|---------|
| npm | npm install -g flutter-skill |
| Homebrew | brew install ai-dashboad/flutter-skill/flutter-skill |
| Scoop | scoop install flutter-skill |
| Docker | docker pull ghcr.io/ai-dashboad/flutter-skill |
| pub.dev | dart pub global activate flutter_skill |
| VSCode | Extensions → "Flutter Skill" |
| JetBrains | Plugins → "Flutter Skill" |
| Agent Skill | npx skills add ai-dashboad/flutter-skill |
| Zero-config | flutter-skill init (auto-detects & patches your app) |
---
Use with AI Platforms
MCP Server Mode (IDE Integration)
Works with any MCP-compatible AI tool. One config line:
| Platform | Config File | Status |
|----------|-------------|--------|
| **Cursor** | .cursor/mcp.json | ✅ |
| **Claude Desktop** | claude_desktop_config.json | ✅ |
| **Windsurf** | ~/.codeium/windsurf/mcp_config.json | ✅ |
| **VSCode Copilot** | .vscode/mcp.json | ✅ |
| **Cline** | VSCode Settings → Cline → MCP | ✅ |
| **OpenClaw** | Skill or MCP config | ✅ |
| **Continue.dev** | .continue/config.json | ✅ |
HTTP Serve Mode (CLI & Automation)
For standalone browser automation, CI/CD pipelines, or remote access:
| Command | Description |
|---------|-------------|
| nav | Navigate to URL |
| snap | Accessibility tree snapshot |
| screenshot [path] | Take screenshot |
| tap | Tap element |
| type | Type via keyboard |
| key [mod] | Press key |
| eval | Execute JavaScript |
| title | Get page title |
| text | Get visible text |
| hover | Hover element |
| upload | Upload file |
| tools | List tools |
| call [json] | Call any tool |
Supports --port=N, --host=H flags and FS_PORT/FS_HOST env vars.
Two Modes Compared
| | server (MCP stdio) | serve (HTTP) |
|---|---|---|
| **Use case** | IDE / AI agent integration | CLI / automation / CI/CD |
| **Protocol** | MCP (JSON-RPC over stdio) | HTTP REST |
| **Tools** | 253 (dynamic per page) | 246 (generic) |
| **Browser** | Auto-launches Chrome | Connects to existing Chrome |
| **Best for** | Cursor, Claude, VSCode | OpenClaw, scripts, pipelines |
> **Full CLI client reference:** docs/CLI_CLIENT.md
---
10 Platforms, One Tool
Most testing tools work on 1-2 platforms. flutter-skill works on **10**.
| Platform | SDK | Test Score |
|----------|-----|:----------:|
| **Flutter** (iOS/Android/Web) | flutter_skill | ✅ 188/195 |
| **React Native** | sdks/react-native | ✅ 75/75 |