Skip to main content
Introducing packages.sweber.dev
Documentation menuCLI

CLI

Create key pairs, issue, verify and inspect licenses from the terminal.

npx integral keygen                 # prints INTEGRAL_PUBLIC_KEY and INTEGRAL_PRIVATE_KEY
npx integral keygen --out ./keys    # writes two files, the private one with mode 600
npx integral keygen --alg es256     # ECDSA P-256 instead of Ed25519 (for KMS/HSM keys)
npx integral migrate <license>...   # re-signs int1 licenses as int2, one per line on stdout
npx integral issue --product my-app --plan pro \
  --feature beta --limit projects=100 --limit seats=unlimited \
  --email kunde@example.ch --name "Kunde AG" \
  --updates-until 2027-10-05
OptionMeaning
--private-key, --private-key-fileSigning key. Default: INTEGRAL_PRIVATE_KEY
--featureExtra feature, repeatable
--limit key=nLimit override, unlimited for no limit, repeatable
--seatsNumber of seats
--email, --name, --customer-idCustomer
--expiresHard expiry
--updates-untilEnd of updates
--machineBind to one device (id from machineId())
--trialMark as trial license
--id, --kidLicense id, key id
npx integral verify <license> --public-key <key> --product my-app   # exit code 0 or 1
npx integral inspect <license>                                       # shows the content, unchecked
echo "$LICENSE" | npx integral verify - --public-key "$INTEGRAL_PUBLIC_KEY"
npx integral revoke lic_123 lic_456 --product my-app > revoked.txt   # signed revocation list
npx integral verify <license> --public-key <key> --revocations revoked.txt --machine <id>
npx integral request <license> --machine <id> --label "Workshop PC" > activation.txt
npx integral activate - --product my-app < activation.txt

request packs a license and a device id for offline activation. activate checks the license with your private key's public key and prints a copy bound to the device. It exits with 1 and the reason if the license is invalid or bound to another device.