Search Wind UI, Magic, Dusk, Telescope and Artisan documentation. Hosted, public, no auth.
AI coding assistants are powerful, but they don't know your frameworks. They hallucinate widget names, guess at API patterns, and miss conventions.
FlutterSDK AI fixes this. It gives your AI structured knowledge about Wind UI's className system, Magic Framework's Laravel-inspired architecture, and more, so it generates correct code on the first try.
One install, every tool:
| Tool | Integration |
|---|---|
| OpenCode | URL-based skill registry |
| Claude Code | Plugin + Marketplace |
| Cursor | Rules (.mdc) |
| Gemini CLI | Command templates (.toml) |
| VS Code Copilot | Instructions (.md) |
| Codex CLI | MCP config (~/.codex/config.toml) |
| Antigravity CLI | MCP config (~/.gemini/config/mcp_config.json) |
| Cline | MCP config (.mcp.json) |
| Roo Code | MCP config (.mcp.json) |
Five skills are available. See docs/SKILLS.md for full descriptions.
| Skill | Package | Upstream | What it covers |
|---|---|---|---|
wind-ui | fluttersdk_wind | fluttersdk/wind | W-prefix widgets, the className parser pipeline, WindRecipe variants, dark mode, responsive breakpoints, design culture |
magic-framework | magic | fluttersdk/magic | IoC container, 18 facades, Eloquent ORM, GoRouter routing, forms, auth, testing, 5 ecosystem plugins |
fluttersdk-dusk | fluttersdk_dusk | fluttersdk/dusk | E2E driver: dusk_* MCP tools and matching CLI commands to snap, tap, type, and screenshot a running Flutter app |
fluttersdk-telescope | fluttersdk_telescope | fluttersdk/telescope | Runtime inspector: 9 ring buffers for HTTP, logs, exceptions, events, gates, DB queries |
fluttersdk-artisan | fluttersdk_artisan | fluttersdk/artisan | CLI framework + stdio MCP server: substrate artisan_* tools, builtin commands, artisan_tinker |
Each skill mirrors its upstream package's own skills/ directory and arrives here when that package publishes a release. The exact synced version is the version: field in skills/<name>/SKILL.md, and skills/index.json is the machine-readable index; neither is duplicated in this table, so neither can drift from it.
mcp.fluttersdk.com exposes a single search-docs tool via Streamable HTTP.
Public, no auth required. Full client config snippets (Claude Code, Cursor,
OpenCode, Codex CLI, Gemini CLI, VS Code Copilot, and more) are in
docs/MCP.md.
For clients that only support stdio (Claude Desktop, older Codex CLI):
npx @fluttersdk/mcp
The npx bridge proxies stdio to the upstream HTTP server transparently.
npx skills (Recommended)The fastest way. Works with 40+ AI coding agents.
# Install all FlutterSDK skills to all detected agents
npx skills add fluttersdk/ai
# Install a specific skill
npx skills add fluttersdk/ai --skill wind-ui
# Install globally (available across all projects)
npx skills add fluttersdk/ai -g
git clone https://github.com/fluttersdk/ai.git && cd ai
# Preview what would be installed
bash scripts/install.sh --dry-run --global
# Install globally for all detected tools
bash scripts/install.sh --global
# Install globally and register the MCP server for all detected tools
bash scripts/install.sh --global --with-mcp
# Or install into your current Flutter project
bash scripts/install.sh --project
Add the registry URL to your opencode.json:
{
"skills": {
"urls": ["https://fluttersdk.github.io/ai/"]
}
}
Skills are fetched automatically and cached locally.
/plugin marketplace add https://raw.githubusercontent.com/fluttersdk/ai/main/.claude-plugin/marketplace.json
/plugin install fluttersdk@fluttersdk-marketplace
The plugin auto-registers:
/fluttersdk:wind-ui, /fluttersdk:magic-framework, /fluttersdk:fluttersdk-dusk, /fluttersdk:fluttersdk-telescope, /fluttersdk:fluttersdk-artisan)/fluttersdk:flutter-review, a review that runs in a subagent as an independent second pair of eyes and then fixes what it finds, plus /fluttersdk:flutter-testfluttersdk:flutter-reviewer and fluttersdk:flutter-reviewer-deep subagents, invokable directly with @fluttersdk MCP server (HTTP transport to mcp.fluttersdk.com; no manual .mcp.json edit required)mkdir -p .cursor/rules
cp tool-templates/cursor/fluttersdk.mdc .cursor/rules/
Activates automatically for all .dart files.
mkdir -p ~/.gemini/commands
cp tool-templates/gemini/*.toml ~/.gemini/commands/
Use with /flutter-review and /flutter-test commands.
mkdir -p .github
cp .github/copilot-instructions.md .github/
skills/index.json ← OpenCode fetches this from GitHub Pages
→ wind-ui/SKILL.md ← Skill definition + className rules
→ wind-ui/references/*.md ← On-demand widget docs, layout patterns, tokens
→ magic-framework/SKILL.md ← Skill definition + framework laws
→ magic-framework/refs/*.md ← Controllers, ORM, facades, routing, auth, ...
OpenCode: Fetches fluttersdk.github.io/ai/index.json, downloads listed skill files, caches locally.
Claude Code: Plugin manifest (.claude-plugin/plugin.json) makes the repo installable. Skills in skills/ are auto-discovered and namespaced under /fluttersdk:.
Deployment: Push to main → GitHub Actions deploys skills/ to GitHub Pages automatically.
skills/<skill-name>/SKILL.md with YAML frontmatter (name, description)skills/<skill-name>/references/skills/index.json: list every file in the files array.claude-plugin/plugin.json and .claude-plugin/marketplace.jsonmainSee CLAUDE.md for the full specification.
Important: Every file must be listed in
index.json: OpenCode only downloads listed files. Forgetting a file means users get incomplete skills.
MIT. See LICENSE for details.
Source-derived launch command. Check the maintainer’s required arguments and credentials before running:
npx -y @fluttersdk/mcpMerge this template into ~/Library/Application Support/Claude/claude_desktop_config.json. Keep existing servers. Add any arguments, credentials, and permissions required by the maintainer; this template has not been install-tested.
{
"mcpServers": {
"io-github-fluttersdk-ai": {
"command": "npx",
"args": [
"-y",
"@fluttersdk/mcp"
]
}
}
}Restart Claude Desktop completely for changes to take effect. Confirm the server appears connected in the client’s tool list, then try a read-only example from its documentation.
Claude Desktop setup reference@fluttersdk/mcpnpmFlutterSDK Docs works with any MCP-compatible client. Copy the config snippet from the Configuration section above and add it to the file shown for your client, then restart the application.
~/Library/Application Support/Claude/claude_desktop_config.jsonRestart Claude Desktop completely for changes to take effect.~/.cursor/mcp.jsonRestart Cursor for changes to take effect..vscode/mcp.jsonReload VS Code window for changes to take effect.~/.codeium/windsurf/mcp_config.jsonRestart Windsurf for changes to take effect..mcp.jsonSave at the project root, then start Claude Code in that project and review the MCP server approval prompt. Keep real credentials out of shared files.