FrootAI — VS Code Extension

From the Roots to the Fruits. It's connected, it's simply Frootful.
The UniFAIng Glue for GenAI Ecosystem

Solution plays · AI primitives · MCP tools · Knowledge Modules · Comprehensive Glossary

🟢 v6.1.0 — Federation GA (2026-06-20) — One MCP connection, every Tier-1 area (Azure, GitHub, Playwright, MarkItDown, MS Learn, Context7). Trust-gated. Operational — Stable. Read the launch post →

📦 What's Inside

The extension adds a FrootAI icon to your activity bar with 7 sidebar sections:

Works standalone — no need to clone the FrootAI repo. Install the extension and go.

🏠 Welcome & Agent FAI

The Welcome panel is your starting point — quick-start actions, feature overview, and ecosystem links all in one place. Open it anytime with Ctrl+Shift+F11.

Agent FAI is your AI-powered assistant that knows the entire FrootAI ecosystem. Ask about solution plays, architecture patterns, Azure best practices, primitives — anything. Responses stream in real-time with full context awareness.

🎯 Solution Plays

The Solution Configurator walks you through 5 questions to recommend the best play for your scenario — industry, complexity, team size, and more.

Browse All Plays gives you a searchable, filterable catalog of all solution plays. Click any play for a rich detail panel with WAF checklist, Azure services grid, tuning parameters, and cost breakdown.

Each play ships as a 4-kit structure:

solution-play/
├── .github/           DevKit — agents, instructions, skills, hooks, prompts
├── config/            TuneKit — AI parameters, guardrails, model routing
├── evaluation/        eval.py + test sets + quality scoring
├── infra/             Bicep IaC (Azure plays) or Docker Compose
└── spec/              SpecKit — architecture spec + WAF alignment

Play actions — Init DevKit · Init TuneKit · Init SpecKit · Estimate Cost · Run Evaluation · User Guide

🧩 Primitives Catalog

Browse AI primitives across 5 tabs with search, WAF pillar filters, and domain filters:

One-click install for any primitive — agents use the vscode://github.copilot-chat/createAgent protocol.

📚 Learning Hub

Explore the FROOT Framework — knowledge modules across 5 layers:

Also includes:

• FAI Ecosystem — 6-tab explorer: Factory · Packages · Toolkit · Engine · Protocol · Layer
• AI Glossary — Comprehensive glossary with definitions and context
• Learning Center — 15 guided learning pages on frootai.dev
• Quiz & Assessment — 25 questions to test your knowledge

📡 Packages & Distribution

Set up the FAI ecosystem in your preferred format:

All channels ship the same 101 plays, 800+ primitives, and 25 MCP tools.

🚀 Installation

Option 1 — VS Code Marketplace (recommended):

Ctrl+Shift+X → Search "FrootAI" → Install

Option 2 — Terminal:

code --install-extension frootai.frootai-vscode

⚡ Quick Start

1. Install   →  Ctrl+Shift+X → "FrootAI" → Install
2. Setup MCP →  Sidebar → FAI Packages → Setup MCP Server
3. Build     →  Sidebar → Solution Configurator → pick a play → Scaffold

That's it — you're ready to build AI solutions with FrootAI.

⌨️ Keyboard Shortcuts

🔬 FAI Ecosystem Architecture

Flow: Factory → Packages → Toolkit → Engine → Protocol → Layer

🌱 Federation Surface (GA in 6.1.0)

The FrootAI Federation surface is GA in v6.1.0 — the bundled MCP kernel attaches external MCP areas ("areas") and routes tool calls under <area>.<tool> prefixes. One MCP connection from your client, every Tier-1 area available, trust gated by a single manifest you control.

Federation Explorer at a glance

FrootAI Federation
├─ Attached
│  ├─ azure         · first-party-ms · 47 tools
│  ├─ github        · first-party-ms · 31 tools
│  └─ playwright    · first-party-ms · 18 tools
├─ Marketplace (auto-attachable)
│  ├─ markitdown    · first-party-ms
│  ├─ ms-learn      · first-party-ms
│  ├─ context7      · verified-publisher
│  └─ chrome-devtools · verified-publisher
└─ Trust posture
   └─ Active overrides: 0

Lockstep launch (v6 across all 5 surfaces)

Backward compatibility: v5.1.x users auto-upgrade on update. v5 behavior is preserved with FROOTAI_FEDERATION=off for any consumer that needs the legacy single-tool surface.

See CHANGELOG.md for the full v6.1.0 ship inventory.

🔌 MCP Server Definition Providers

This extension contributes two MCP server-definition providers other VS Code MCP consumers can discover and connect to:

The frootai-federated provider returns the live federated tool list from the running federation kernel. When no federation kernel is currently running (no areas attached, federation disabled, or extension just activated), the provider returns an empty list — other MCP consumers should treat that as "no federated tools available right now" rather than an error.

🧪 Cross-Platform Smoke Matrix

Every push that touches the federation surface runs the vscode-federation-cross-platform.yml GitHub Actions matrix:

The fail-fast: false strategy guarantees one OS failure doesn't mask the others — the M5.26 row literal mandates "all three" succeed, so the report shows precisely which platform broke. The smoke target is playwright per the row literal; when M5.22+ wires real kernel spawn, this matrix automatically picks up the end-to-end playwright attach without workflow edits.

�️ Visual Regression — Federation Explorer

Per M5.27, every PR touching webview-ui/src/panels/FederationExplorer.tsx triggers the vscode-federation-visual-regression.yml workflow. The canonical golden roster lives at webview-ui/__screenshots__/federation-explorer/manifest.json:

The workflow today validates the manifest shape (canonical roster + resolution + theme variants) and confirms the webview builds. The full pixel-diff baseline lands once the Playwright Component Testing harness ships — at which point baseline PNGs commit alongside manifest.json as <id>.<theme>.png (5 states × 2 themes = 10 files), and the diff step augments the workflow without changing the path-filter trigger.

�🔗 Links

From the Roots to the Fruits.
It's connected, it's simply Frootful.

_{MIT License · © 2026 FrootAI}