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; npm registry publication is reported separately below.

Where to find releases​

  • GitHub: Hamtrax-CLI releases -- release notes, source archives, and uploaded CLI assets.
  • 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.3.0 -- 2026-10-12​

  • Released on GitHub with the hamtrax-0.3.0.tgz package; npm registry publication is pending.
  • Adds --limit and --cursor to activations list. Follow the cursor even when an in-progress page is empty; see pagination.
  • Supplies the same privacy-safe MCP result JSON to assistants that consume text results, and uses the existing tool titles in annotations. Tool schemas and permissions are unchanged.

0.2.1​

  • Released on GitHub with the hamtrax-0.2.1.tgz package; npm registry publication is pending.
  • Clarifies descriptive MCP tool capabilities, approval prerequisites, and side effects for directory review. Tools, schemas, and permissions are unchanged.

0.2.0 -- 2026-10-09​

  • Released on GitHub with the hamtrax-0.2.0.tgz package. npm registry publication is pending; see Install for the available package command.
  • Adds the local MCP server, four read tools, and optional creation and confirmed deletion tools. Every MCP write requires an idempotency key and creation requires explicit timestamps. See MCP.
  • Adds --idempotency-key to terminal contact creation, contact deletion, and activation creation for safe retries with identical fields and timestamps.

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 planned release. This version was rejected at the npm provenance step and never landed in the registry. Command surface: 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.