This is a repo for building freshworks apps through AI agents
This repository also configures its own agents. See what fw-dev-tools tells them →
freshworks-developers/fw-dev-tools
Cursor rule Cursor
Requires verified third-party API documentation and secure credential handling (iparams/OAuth) before implementing AI Actions integrations.
freshworks-developers/fw-dev-tools
Cursor rule Cursor
Freshworks Platform 3.0 AI Actions manifest, modules, engines, and serverless app structure when editing actions or platform config.
freshworks-developers/fw-dev-tools
Cursor rule Cursor
README structure and sections for AI Actions marketplace apps (features, auth, setup, action list).
freshworks-developers/fw-dev-tools
Cursor rule Cursor
Cursor rule "ai-actions-requests" from freshworks-developers/fw-dev-tools, covering ai actions request templates, config/requests.json, substitution, rules and config/iparams.json.
freshworks-developers/fw-dev-tools
Cursor rule Cursor
Cursor rule "ai-actions-schemas" from freshworks-developers/fw-dev-tools, covering ai actions schemas (actions.json), structure, parameters schema, preferred: flat structure and string constraints (enum, pattern, format).
freshworks-developers/fw-dev-tools
Cursor rule Cursor
Cursor rule "ai-actions-server" from freshworks-developers/fw-dev-tools, covering ai actions server.js patterns, platform 3.0 pattern, error messages surfaced to users, renderdata signature and rules.
freshworks-developers/fw-dev-tools
Cursor rule Cursor
Each action defined in actions.json must have a corresponding server/testdata/ .json test fixture. A missing server/testdata/ directory or any missing fixture is a blocking issue.
freshworks-developers/fw-dev-tools
Cursor rule Cursor
Run fdk validate after changes; fix blocking errors with limited iterations; ignore style-only noise for AI Actions apps.
freshworks-developers/fw-dev-tools
Cursor rule Cursor
MANDATORY blocking gates - app building and validation MUST NOT complete without passing ALL gates. Zero tolerance for missing files, incomplete structure, or platform errors.
freshworks-developers/fw-dev-tools
Cursor rule Cursor
Platform 3.0 app template selection guide. Use when creating or fixing apps to determine which skeleton template to use based on requirements (frontend-only, serverless, hybrid, or OAuth).
freshworks-developers/fw-dev-tools
Cursor rule Cursor
Fix async/await patterns for FDK validation. Use when fdk validate shows "Async function has no 'await' expression", async scoping issues, or unhandled promise rejections. Covers IIFE pattern, error handling, and race conditions.
freshworks-developers/fw-dev-tools
Cursor rule Cursor
Reduce function complexity to ≤ 7 for FDK validation. Use when fdk validate shows "Function has complexity X. Maximum allowed is 7." Apply lookup objects, guard clauses, functional patterns, and Sets for multiple comparisons.
freshworks-developers/fw-dev-tools
Cursor rule Cursor
Disambiguation guide for ambiguous app development prompts. Covers top 5 common ambiguities - OAuth vs API token, automatic vs manual trigger, frontend vs serverless, event selection, and error handling strategy. Load only when prompt is unclear.
freshworks-developers/fw-dev-tools
Cursor rule Cursor
Platform 3.0 enforcement - ZERO TOLERANCE for Platform 2.x patterns. Immediately reject whitelisted-domains, product structure, plain HTML, and legacy APIs. Reference SKILL.md for detailed patterns.
freshworks-developers/fw-dev-tools
Cursor rule Cursor
Platform 3.0 Modules and Locations Reference - Complete guide for all products.
freshworks-developers/fw-dev-tools
Cursor rule Cursor
Enforce Node.js 24.x + FDK 10.x prerequisites before any fw-app-dev task.
freshworks-developers/fw-dev-tools
Cursor rule Cursor
React Meta framework defaults for Platform 3.0 UI apps — metaConfig, DEW components, React Router, optional Tailwind/vite, custom HTML placement. Use when creating or migrating Meta apps.
freshworks-developers/fw-dev-tools
Cursor rule Cursor
Security enforcement rules for Freshworks Platform 3.0 app development. Apply these rules to EVERY app to prevent vulnerabilities.
freshworks-developers/fw-dev-tools
Cursor rule Cursor
Smart prerequisite check that detects migration scenarios and routes appropriately (replaces basic prerequisites-check.mdc).
freshworks-developers/fw-dev-tools
Cursor rule Cursor
Automatic validation and autofix workflow for Platform 3.0 apps. Runs fdk validate after file creation, fixes platform and lint errors iteratively (up to 6 iterations), and ensures zero errors before completion.
freshworks-developers/fw-dev-tools
Cursor rule Cursor
This skill handles FDK installation and management only. It does NOT create apps.
freshworks-developers/fw-dev-tools
Cursor rule Cursor
Preflight checks before fw-dev-tools skill orchestration (FDK, Node, manifest, publish token).
At most 3 mods per repository are shown here, and a mod shipped inside a plugin is left to that plugin's page — the rest are on their repository pages: