AI-powered toolkit for building Freshworks apps in Claude Code, Cursor, and OpenAI Codex

Build Freshworks marketplace apps faster with AI assistance.
Supports Platform 3.0 with modern best practices.

Platform 3.0 · Cursor Plugins · Crayons · Request Templates · OAuth · fdk validate

Pins & runbooks: docs/engine-matrix.md (FDK / Node), docs/network-requirements.md (firewall).

• Set up your development environment - fw-setup Install and manage the Freshworks Development Kit (FDK) and Node.js.
• Scaffold a Platform 3.0 app — /fdk-fix and /fdk-migrate get you from a blank folder or a legacy 2.x app to a passing fdk validate output
• Connect third-party APIs — fw-ai-actions-app generates actions.json, SMI handlers, and OAuth request templates for services like Slack or Google
• Catch issues before review — fw-review runs the same checks marketplace reviewers use and outputs a structured report you can act on
• Publish without leaving your IDE — fw-publish guides you through fdk validate → pack → upload → submit via MCP, no browser required

Skills are packaged for Cursor, Claude Code, and OpenAI Codex. How you attach them differs slightly by client.

Claude Code:

claude plugin marketplace add freshworks-developers/fw-dev-tools
claude plugin install fw-setup@freshworks-dev-tools
claude plugin install fw-app-dev@freshworks-dev-tools
claude plugin install fw-ai-actions-app@freshworks-dev-tools
claude plugin install fw-review@freshworks-dev-tools
claude plugin install fw-publish@freshworks-dev-tools

Cursor — Skills CLI:

npx skills add https://github.com/freshworks-developers/fw-dev-tools --skill fw-setup
npx skills add https://github.com/freshworks-developers/fw-dev-tools --skill fw-app-dev
npx skills add https://github.com/freshworks-developers/fw-dev-tools --skill fw-ai-actions-app
npx skills add https://github.com/freshworks-developers/fw-dev-tools --skill fw-review
npx skills add https://github.com/freshworks-developers/fw-dev-tools --skill fw-publish

OpenAI Codex:

codex plugin marketplace add freshworks-developers/fw-dev-tools

After install: restart your IDE, then type /fw-setup- in chat — autocomplete should list available commands. For publish workflows: configure the fw-dev-mcp JWT first — see AGENTS.md.

Helpful links:

Each tool helps with a specific part of app development. Use them in order for a complete workflow:

Installs FDK 10.x + Node.js 24.x via nvm. Run this first — other skills require it.

Scaffold and develop a Platform 3.0 app with Crayons UI, OAuth, and serverless functions.

Validation order: fw-setup first (when Node/FDK is wrong) → /fdk-migrate (legacy apps) → fdk validate

Connect to external APIs (Slack, Google, etc.) and add AI Actions using actions.json, SMI handlers, and request templates.

Runs the same checks marketplace reviewers use: manifest, iparams, frontend, and security. Outputs a structured report with blocking vs non-blocking findings.

Guides you through fdk validate → pack → upload → submit via MCP without leaving your IDE.

One-time setup:

1. API key from developers.freshworks.com/developer/ - API key for Freddy AI Copilot for VS Code plugin & Agentic Developer Toolkit. or Connect to Developer MCP server (For MCP configuration)
2. Configure the fw-dev-mcp server in your IDE — see MCP section below

Publishing uses the fw-dev-mcp server. This repo bundles .mcp.json at the repository root (URL + Authorization header). Cursor, Claude Code, and Codex MCP token placement (where applicable), copy-paste blocks, and tool names are documented in AGENTS.md (MCP section) and the publish skill's own files under skills/fw-publish/—not duplicated here.

Having issues with skills installation or usage?

• 📋 TROUBLESHOOTING.md - Issues for Cursor, Claude Code, and OpenAI Codex (where applicable)

Common issues:

• Skills not recognized → Check SKILL.md and plugin.json structure
• Commands not working → Verify rulesDirectory and commandsDirectory in plugin.json
• Rules not applying → Ensure rules are in skills/{skill}/rules/ (not .cursor/rules/)

• Report Issues
• Freshworks Developer Docs
• Community standards: CODE_OF_CONDUCT.MD

Contributions welcome — new commands, rule fixes, reference docs, and new skills. See CONTRIBUTING.md for:

• Skill and rule file structure
• How to keep AGENTS.md and plugin manifests in sync
• PR process and docs hygiene scripts
• Marketplace listing kit (canonical strings, logos, blurbs)

MIT