Skip to content

Marketplace

The Hedlo CLI

The hedlo command checks, packs and publishes marketplace packages. It has no dependencies besides Node.js 22 or newer.

Install

npm install --global @hedlo/cli
hedlo --version

Sign in

hedlo login

The CLI shows a short code and opens the marketplace in your browser. Sign in there, check that the code matches and approve the request. The CLI then receives a token that can only publish and read your own packages.

  • The token is stored in your user configuration folder, readable only by you.

  • hedlo whoami shows the account and publisher the token belongs to.

  • hedlo logout deletes the token locally and revokes it on the marketplace.

  • Review and revoke every CLI sign-in from Account → Sessions on the marketplace.

For CI, create a publish token in the publisher dashboard under API tokens and set it as HEDLO_TOKEN. Tokens can be limited to single packages and expire after the time you choose.

Commands

CommandWhat it does
hedlo initCreates hedlo.json in the current folder, asking for the id, kind and product
hedlo validateChecks the manifest, files and size limits without uploading anything
hedlo packBuilds the package archive and prints its SHA-256
hedlo publishValidates, packs and uploads the package, then submits it for review
hedlo status [id]Shows the review state of your latest versions
hedlo versions <id>Lists every version of a package with its state
hedlo whoamiShows the signed-in account and publisher
hedlo logoutSigns out and revokes the token

Every command accepts --json for machine-readable output. hedlo publish --notes CHANGELOG.md attaches release notes for the reviewer.

Files in a package

  • The archive holds everything in the package folder except files listed in .hedloignore, version control folders and node_modules.

  • Archives are limited to 25 MB and 2,000 files. Symbolic links and files outside the folder are refused.

  • Never put secrets in a package. The automated review rejects archives that contain private keys or tokens.

Example

cd acme-backups
hedlo validate
hedlo publish --notes CHANGELOG.md
hedlo status acme.backups