Install the Agentic Developer Toolkit with the @freshworks/fw-dev-tools npm package. The installer auto-detects Cursor, Claude Code, and OpenAI Codex, installs all five skills, and configures MCP for publish workflows. Source and plugin manifests live in the fw-dev-tools repo.
Note:Installing skills does not require FDK or a Developer API key. The npm CLI path below needs Node and npm (via npx). Set up FDK and the app toolchain in Set up the environment; configure MCP before publish in Configure the Developer MCP server.
Install with the npm CLI
One command — auto-detects supported assistants and installs all skills:
npx @freshworks/fw-dev-tools installTarget specific clients:
npx @freshworks/fw-dev-tools install --tools cursor
npx @freshworks/fw-dev-tools install --tools cursor,claudeNon-interactive (CI or scripted installs):
npx @freshworks/fw-dev-tools install --yesVerify the install
- Restart your IDE.
- In chat, type /fw-setup- and confirm slash commands autocomplete.
- For publish workflows, complete MCP server configuration using the step the installer prints (Developer API key + fw-dev-mcp).
Keep skills up to date
npx @freshworks/fw-dev-tools update
npx @freshworks/fw-dev-tools statusPreviously installed via npx skills add or manual copy? Run npx @freshworks/fw-dev-tools install — it migrates automatically.
See also:For summaries of each skill and MCP tool, see Skills and MCP tools. Install and runtime issues: Troubleshoot issues and TROUBLESHOOTING.md in the repo.
Common install issues:
- Skills not appearing after install → restart your IDE.
- Commands not working in Cursor → confirm ~/.cursor/rules/fw-dev-tools.mdc exists.
- Codex .mcp.json not written → re-run npx @freshworks/fw-dev-tools install --tools codex from your project root.
See the video below for a walkthrough.