Open Source
Contribute to FAI
Help us build the industry standard for AI primitive unification — together.
830+ primitives · 100 plays · 6 distribution channels · MIT License
The FAI Factory Pipeline
Every contribution flows through 8 steps — from browsing primitives to auto-shipping across all channels.
1
Browse
frootai.dev/primitives or npx frootai list
2
Scaffold
npx frootai scaffold agent/instruction/skill/hook/plugin
3
Edit
Add expertise, WAF alignment, compatible plays
4
Validate
npm run validate:primitives — 2,800+ checks
5
PR
Submit to main branch
6
Review
Maintainer checks WAF + quality
7
Merge
Auto-generate marketplace + website-data
8
Discover
Website, CLI, MCP, VS Code, Python, Docker
Contribute Primitives
8 primitive types, each with a clear path. Expand any card to see file format, scaffold command, quality standards, and example frontmatter.
Dev Environment Setup
Prerequisites and commands to get building in minutes.
Prerequisites
Node.js 22+
Runtime & npm
Git
Version control
VS Code
Recommended editor
Python 3.12+
For Python SDK/MCP
Clone & Install
git clone https://github.com/FrootAI/frootai.git cd frootai npm install
Build & Validate
npm run validate:primitives # 2,800+ schema checks npm run build # Full pipeline: validate → marketplace → website-data npx frootai scaffold agent # Scaffold your first primitive
Repository Structure
The full layout of the FrootAI monorepo.
frootai/ ├── agents/ # 238 AI agent personas (.agent.md) ├── instructions/ # 176 scoped coding standards (.instructions.md) ├── skills/ # 322 reusable procedures (SKILL.md folders) ├── hooks/ # 10 lifecycle automations (hooks.json) ├── plugins/ # 77 themed bundles (plugin.json) ├── workflows/ # 12 agentic CI/CD workflows ├── cookbook/ # 16 step-by-step recipes ├── solution-plays/ # 68 complete AI blueprints (fai-manifest.json) ├── engine/ # FAI Engine runtime ├── schemas/ # 7 JSON validation schemas ├── scripts/ # Build + validate + generate tooling ├── mcp-server/ # MCP Server (npm) — 45 tools ├── vscode-extension/ # VS Code Extension — 21 commands ├── python-sdk/ # Python SDK (pip install frootai) ├── python-mcp/ # Python MCP server └── evaluation/ # Eval framework + quality thresholds
PR Checklist
What reviewers check before merging your contribution.
File naming follows lowercase-hyphen convention— fai-graphql-expert.agent.md
Frontmatter has all required fields per type— description, applyTo, waf[], plays[]
npm run validate:primitives passes (0 errors)— 2,800+ schema + naming checks
No secrets, API keys, or connection strings— CI scans every PR automatically
WAF pillar references use valid values— security, reliability, cost, ops, perf, RAI
If new play: fai-manifest.json exists— context + primitives + guardrails
If new plugin: plugin.json + README.md exist— Marketplace regenerated on merge
Distribution Channels
After merge, your contribution auto-ships to all 6 channels via the FAI Factory pipeline.
frootai.dev
Primitives catalog, play pages, user guides
npx frootai-mcp
MCP Server — 45 tools for AI assistants
VS Code Extension
Sidebar tree views, 21 commands, inline help
npx frootai list
CLI browser for plugins and primitives
pip install frootai
Python SDK for programmatic access
docker pull frootai
Container image for CI/CD pipelines
Community Infrastructure
| Component | Purpose |
|---|---|
| CONTRIBUTING.md | Branching strategy, commit conventions, PR process, primitive guides |
| validate-primitives.yml | PR validation CI — schema + secrets + naming (2,800+ checks) |
| auto-generate.yml | Auto-rebuild marketplace + website-data on merge to main |
| 7 JSON schemas | Formal validation for agent, instruction, skill, hook, plugin, manifest, context |
| scaffold-primitive.js | Interactive CLI for creating new primitives with correct structure |
| marketplace.json | Auto-generated plugin registry — powers website + CLI + MCP |
| MIT License | Open source, no restrictions, free forever |