Skip to main content

Changelog

The Hamtrax CLI is independently versioned from the Hamtrax web app and the HTTPS API (/v1/). Releases are tagged on GitHub with a changelog entry and an npm publish.

Where to find releases​

  • GitHub: Hamtrax-CLI releases -- changelog + signed source tarballs.
  • npm: hamtrax -- npm view hamtrax versions --json for the full version list.

Versioning policy​

The CLI follows SemVer:

  • Patch (0.1.0 → 0.1.1) -- bug fixes only. Exit codes, JSON shapes, and command surface are unchanged.
  • Minor (0.1.0 → 0.2.0) -- new commands, new flags, or new fields on existing JSON output. Existing fields and commands keep working unchanged.
  • Major (0.x.x → 1.0.0) -- breaking changes. We try hard to avoid these; a major bump usually pairs with a new HTTPS API version (/v1/ → /v2/).

The HTTPS API version (v1) is independent. A CLI minor release does not require an API version bump; an API version bump does not invalidate older CLI keys.

Release notes​

Latest releases are tracked at HammerCreativeLLC/Hamtrax-CLI/releases. Highlights:

0.1.1 -- 2026-05-07​

  • Fixed package.json repository.url casing so npm provenance verification accepts the publish. (0.1.0 was rejected at the provenance step and never landed in the registry.)

0.1.0 -- 2026-05-07​

  • Initial public release on npm. Commands: auth login/set-key/status/logout/panic-revoke, whoami, folders list/show, contacts list/create/delete, activations list/create. --json, --ndjson, --help-json, help --all. Deterministic exit codes 0-8. Keychain-first key storage with 0600 file fallback.