fw-dev-tools

Contents

What You Can Do

• Set up your development environment — fw-setup installs and manages 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.

Installation

npx @freshworks/fw-dev-tools install

Auto-detects Cursor, Claude Code, and OpenAI Codex. Installs all five skills and configures MCP for publish workflows.

Options:

npx @freshworks/fw-dev-tools install --tools cursor        # specific client
npx @freshworks/fw-dev-tools install --tools cursor,claude # multiple clients
npx @freshworks/fw-dev-tools install --yes                 # non-interactive

After install: restart your IDE and type /fw-setup- — autocomplete confirms the skills are active. For publish workflows, follow the MCP setup step the installer prints once to enable fw-publish.

Keep skills up to date:

npx @freshworks/fw-dev-tools update
npx @freshworks/fw-dev-tools status

Previously installed via npx skills add or manual copy? Run npx @freshworks/fw-dev-tools install — it migrates automatically.

Prerequisites

Available Tools

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

Step-by-Step Workflow

1. Set up your environment — fw-setup

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

2. Build your app — fw-app-dev

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

3. Add AI features — fw-ai-actions-app (optional)

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

4. Review before submitting — fw-review

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

5. Publish — fw-publish

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

One-time setup:

1. Get an API key from developers.freshworks.com/developer/
2. Configure the fw-dev-mcp server in your IDE — see MCP section below

MCP (marketplace publish)

Publishing uses the fw-dev-mcp server. This repo bundles .mcp.json at the repository root (URL + Authorization header). MCP token placement, copy-paste blocks, and tool names are documented in the publish skill under skills/fw-publish/.

MCP boundary: Build, fix, review, and migrate through skills (fw-app-dev, fw-ai-actions-app, fw-review) — not MCP. MCP is for publish workflows and get_developer_docs (primary platform documentation). Legacy build tools (implement_app, get_implementation_plan, idea_to_app, fix_app_errors) are deprecated on the server; see deprecated-mcp-build-tools.md.

Troubleshooting

Having issues with skills installation or usage?

• 📋 TROUBLESHOOTING.md — Covers Cursor, Claude Code, and OpenAI Codex

Common issues:

• Skills not appearing after install → Restart your IDE; for Claude Code check ~/.claude/CLAUDE.md has the routing block
• Commands not working in Cursor → Check ~/.cursor/rules/fw-dev-tools.mdc exists
• fdk or node not found → Run /fw-setup-troubleshoot
• Codex MCP config missing → Re-run npx @freshworks/fw-dev-tools install --tools codex --yes; installer writes ~/.codex/mcp.json

Resources

Support

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

Contributing

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)

License

MIT