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 --versionSign in
hedlo loginThe 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 whoamishows the account and publisher the token belongs to. -
hedlo logoutdeletes 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
| Command | What it does |
|---|---|
hedlo init | Creates hedlo.json in the current folder, asking for the id, kind and product |
hedlo validate | Checks the manifest, files and size limits without uploading anything |
hedlo pack | Builds the package archive and prints its SHA-256 |
hedlo publish | Validates, 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 whoami | Shows the signed-in account and publisher |
hedlo logout | Signs 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 andnode_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