curseforge-upload-cli

Command-line CurseForge publishing, localization, retrieval, packaging, and Studios/Core lookup workflows. Requires Node.js 22 or newer.

npm install --global curseforge-upload-cli

Minimal upload

Set CURSEFORGE_API_TOKEN, then run:

curseforge-upload file upload \
  --project-id 123456 \
  --file build/libs/example.jar \
  --game-version-names 1.21.1,NeoForge \
  --release-type release \
  --changelog-file CHANGELOG.md

Use --token-stdin when an environment variable is unsuitable. Normal token arguments are not accepted because process arguments may be observable. Optional Core commands read the separate CURSEFORGE_CORE_API_KEY credential.

Command groups are file, game, localization, maven, packaging, and core. Add --dry-run to upload, update, localization import, or packaging trigger to validate without a remote request. Add --json for one stable JSON value on standard output. Success exits 0, remote/network errors exit 1, and local input/configuration errors exit 2.

Read the repository and complete CLI documentation, endpoint reference, and security guide. Source is hosted at https://github.com/AlmanaX-21/curseforge-upload; the npm package is not published yet.

MIT licensed. See LICENSE.