auto_fix_high AI-First · Skill + MCP

Dusk for AI Coding Assistants

Name: Dusk
Author: FlutterSDK

Skill teaches your agent the 31 MCP tools and the actionability gate. MCP server lets it inspect docs at runtime. One marketplace command in Claude Code wires it all up.

Works with

paste in Claude · other editor ↓

claude · ~/your-flutter-app

connected

verified Skills + MCP server live. Your agent can drive a real Flutter app.

Drive your running app

Local MCP for app-driving tools

Dusk ships a stdio MCP server inside your project. The 31 dusk_* tools (snap, tap, type, observe, screenshot, evaluate) drive the running Flutter app over VM Service extensions. One install command patches main.dart, scaffolds the fastcli wrapper, and registers the plugin.

build 31 dusk_* tools · folder_open Writes .mcp.json · bolt ./bin/fsa fastcli wrapper, ~110ms warm

chevron_right Or paste the canonical .mcp.json by hand JSON

{
  "mcpServers": {
    "fluttersdk": {
      "command": "./bin/fsa",
      "args": ["mcp:serve"],
      "cwd": "."
    }
  }
}

After edit: /mcp reconnect fluttersdk in Claude Code · Cursor auto-reloads · VS Code reload window. If ./bin/fsa is not scaffolded yet, swap the command for dart run fluttersdk_dusk mcp:serve.

Full per-client matrix (Cursor · VS Code · Continue · Windsurf · Claude Desktop) at dusk/mcp/setup.

Three pieces, one outcome.

Skill at edit time. MCP at runtime. llms.txt on demand.

menu_book

01 · Skill

31 MCP tools, the actionability gate, ref/q query handles. Anti-patterns and gesture failure reasons. Loaded into context before the first run.

hub

02 · MCP server

Streamable HTTP at mcp.fluttersdk.com. One search-docs tool. Public, no auth.

description

03 · llms.txt

Static markdown inventory at /dusk/llms.txt. Some agents auto-fetch and cache it on first contact.

Install Dusk for Claude Code, Cursor, and Codex

Three paths. Pick the one closest to your editor.

Claude Code plugin Recommended

Marketplace install. Skills surface as /fluttersdk:fluttersdk-dusk, etc.

/plugin marketplace add fluttersdk/ai

/plugin install fluttersdk@fluttersdk-marketplace

terminal

npx skills

Universal CLI. Works with 40+ AI coding agents via the Vercel Labs skills package.

npx skills add fluttersdk/ai --skill fluttersdk-dusk

npx skills add fluttersdk/ai -g

install_desktop

Universal installer

Auto-detects every supported tool and registers the MCP server in one pass.

git clone https://github.com/fluttersdk/ai.git && cd ai && bash scripts/install.sh --global --with-mcp

Connect the MCP Server at mcp.fluttersdk.com

One Streamable HTTP endpoint at mcp.fluttersdk.com serves every client. Public, no auth.

Claude Code

claude mcp add --transport http fluttersdk https://mcp.fluttersdk.com

chevron_right stdio fallback

claude mcp add --transport stdio fluttersdk npx @@fluttersdk/mcp

Cursor

{
  "mcpServers": {
    "fluttersdk": { "url": "https://mcp.fluttersdk.com" }
  }
}

Save to .cursor/mcp.json

OpenCode

{
  "mcp": {
    "fluttersdk": {
      "type": "remote",
      "url": "https://mcp.fluttersdk.com",
      "enabled": true
    }
  }
}

Save to opencode.json

VS Code Copilot

{
  "servers": {
    "fluttersdk": { "type": "http", "url": "https://mcp.fluttersdk.com" }
  }
}

Save to .vscode/mcp.json

Codex CLI

[mcp_servers.fluttersdk]
url = "https://mcp.fluttersdk.com"

Add to ~/.codex/config.toml

chevron_right stdio fallback

[mcp_servers.fluttersdk]
command = "npx"
args = ["-y", "@@fluttersdk/mcp"]

Antigravity CLI

{
  "mcpServers": {
    "fluttersdk": {
      "url": "https://mcp.fluttersdk.com"
    }
  }
}

Save to ~/.gemini/config/mcp_config.json

Different client? Cline, Gemini CLI, Roo Code configs at fluttersdk/ai · docs/MCP.md.

description

LLM Inventory Files

Some agents auto-fetch llms.txt at the project URL and load it once into context. Complement to the skill+MCP combo.

open_in_new /dusk/llms.txt open_in_new /dusk/llms-full.txt

Frequently Asked

Do I need both the skill and the MCP server? expand_more

The skill teaches your agent the MCP tools surface and the actionability gate at edit time. The MCP server lets it search docs at runtime to verify the tool call it just wrote. They are complementary; install both.

Which AI coding assistants are supported? expand_more

The skill works with 40+ agents via the Vercel Labs skills CLI. The MCP server speaks Streamable HTTP, supported natively by Claude Code, Cursor, OpenCode, VS Code Copilot, and Codex CLI. For stdio-only clients use the npx @fluttersdk/mcp bridge.

Is the MCP server free? expand_more

Yes. mcp.fluttersdk.com is public, no auth, MIT-licensed. The search-docs tool queries the same docs you read at fluttersdk.com.

Where do I report a hallucination? expand_more

Open an issue at github.com/fluttersdk/ai with the prompt, the agent, and the model. The skill ships with anti-pattern reminders that get tightened from real reports.

hub