{"id":18380,"library":"fusionauth-cli","title":"@fusionauth/cli","description":"@fusionauth/cli (v1.2.4) is a command-line tool for interacting with FusionAuth, an OIDC/OAuth authentication server. It enables downloading, uploading, and managing email templates, lambdas, and themes. This fork specifically fixes compatibility with Node.js 22, as the original package broke under that version. It is written in TypeScript and distributed as an npm package. Maintenance appears minimal (rare releases). Differentiators include watch functionality for live theme/email updates and environment variable support for API key and host.","status":"maintenance","version":"1.2.4","language":"javascript","source_language":"en","source_url":"https://github.com/FusionAuth/fusionauth-node-cli","tags":["javascript","fusionauth","oidc","oauth","themes"],"install":[{"cmd":"npm install fusionauth-cli","lang":"bash","label":"npm"},{"cmd":"yarn add fusionauth-cli","lang":"bash","label":"yarn"},{"cmd":"pnpm add fusionauth-cli","lang":"bash","label":"pnpm"}],"dependencies":[],"imports":[{"note":"This is a CLI tool, not a library. Use npx to run directly.","wrong":"npm i @fusionauth/cli && node node_modules/@fusionauth/cli/bin/index.js","symbol":"default","correct":"npx @fusionauth/cli"},{"note":"Global install is required to use the 'fusionauth' command without npx, but is discouraged due to potential conflicts.","wrong":"npm i @fusionauth/cli && fusionauth --help","symbol":"global command","correct":"npm i -g @fusionauth/cli && fusionauth --help"}],"quickstart":{"code":"export FUSIONAUTH_HOST='http://localhost:9011'\nexport FUSIONAUTH_API_KEY='your-api-key'\nnpm i @fusionauth/cli\nnpx fusionauth email:download -t all","lang":"typescript","description":"Shows how to set environment variables and download all email templates using npx."},"warnings":[{"fix":"Update Node.js to v19 or later (tested on 19 and 22).","message":"Node.js versions below 19 not supported","severity":"breaking","affected_versions":"<1.0.0?"},{"fix":"Use npx @fusionauth/cli instead of global install.","message":"Global install can cause conflicts with other global packages","severity":"gotcha","affected_versions":"all"},{"fix":"Check the documentation for the latest command list.","message":"Some commands may be renamed or removed in future versions","severity":"deprecated","affected_versions":"all"},{"fix":"Set the environment variables before running commands.","message":"Environment variables FUSIONAUTH_HOST and FUSIONAUTH_API_KEY must be set or passed via -h and -k flags","severity":"gotcha","affected_versions":"all"},{"fix":"Use the original FusionAuth CLI if you need the official version; this fork only fixes Node 22 compatibility.","message":"Forked from original FusionAuth CLI; may diverge in features","severity":"gotcha","affected_versions":"all"}],"env_vars":null,"last_verified":"2026-04-25T00:00:00.000Z","next_check":"2026-07-24T00:00:00.000Z","problems":[{"fix":"Run 'npm install' in the project directory or use npx to auto-install.","cause":"Missing dependencies due to npm install issues or incorrect Node version.","error":"Error: Cannot find module '@oclif/core'"},{"fix":"Set FUSIONAUTH_API_KEY environment variable or use -k option.","cause":"FUSIONAUTH_API_KEY environment variable not set or -k flag not provided.","error":"Error: Failed to authenticate: API key is missing"},{"fix":"Ensure FusionAuth is running and FUSIONAUTH_HOST is correctly set.","cause":"FusionAuth server is not running on the specified host/port.","error":"Error: Connection refused to http://localhost:9011"}],"ecosystem":"npm","meta_description":null,"install_score":null,"install_tag":null,"quickstart_score":null,"quickstart_tag":null}