Skip to content

Releases: buildwithzach/shopify-changelog

Shopify Changelog v0.2.0 — project checks and automatic context

Choose a tag to compare

@buildwithzach buildwithzach released this 06 Sep 23:06
b99aacd

Shopify Changelog now connects announcements to the project being developed and can supply that evidence automatically through agent hooks.

New

  • inspect: bounded local discovery of Shopify packages, selected source identifiers, extension targets, and scoped API version evidence, with file/line locations.
  • check: task-focused release candidates with source links, publication dates, release conditions, and cautious version comparisons. Webhook versions are kept separate from API client versions. Identifier matches are prioritized over surface-only fallback results.
  • check --offline: cached checks with explicit freshness and coverage. Incomplete evidence exits with code 2; it is not reported as a clean compatibility result.
  • setup.py --hooks: optional offline SessionStart and UserPromptSubmit hooks for Codex and Claude Code, preserving unrelated hooks/settings. Hooks are quiet for unrelated prompts and non-Shopify projects and never block prompts.
  • doctor: runtime and hook configuration diagnostics.
  • Shared-install detection avoids duplicate Codex skill entries when using the Skills CLI.

Install

git clone https://github.com/buildwithzach/shopify-changelog.git
cd shopify-changelog
python3 install.py --agent both --auto-reference --hooks
~/.local/bin/shopify-updates sync

Or install just the skill:

npx skills add buildwithzach/shopify-changelog --skill shopify-changelog -g -a codex claude-code

For existing clone installs, pull the update and rerun setup with the desired options. For Skills CLI installs, update the skill and ask your agent to enable its optional hooks. New Codex hooks require review/trust through /hooks; this release does not bypass trust or disabled-hook policies.

Validation and limits

35 automated tests pass. A fresh install from the public repository passed project matching, version-scope, and hook-contract smoke tests against the live archive. Configured hook commands completed successfully in direct tests. Codex CLI 0.144.5 reports hook support enabled; Claude Code 2.1.211 launches successfully. Native host-driven hook execution after trust/restart is not claimed.

Matching is a bounded lexical heuristic, not a compatibility certification or an accuracy benchmark across production projects. Hooks are offline and ask the agent to refresh stale data before relying on it. They do not upload project code, log prompts, or execute repository scripts. See the README and engineering notes for scanning and feed-history limits.

Shopify Changelog v0.1.0

Choose a tag to compare

@buildwithzach buildwithzach released this 06 Sep 22:29

First public release of Shopify Changelog: a skill and local CLI that gives Codex and Claude Code searchable Shopify announcements alongside official documentation.

  • Import official merchant and developer feeds without API keys or store credentials.
  • Search complete entries, filter recent changes, and cite original sources.
  • Preserve edited versions and keep cached data available when downloads fail.
  • Install for Codex, Claude Code, or both; optionally enable standing automatic-reference instructions.
  • Store new archives outside installed skill files so skill updates do not replace the database.

Install with automatic referencing

git clone https://github.com/buildwithzach/shopify-changelog.git
cd shopify-changelog
python3 install.py --agent both --auto-reference
~/.local/bin/shopify-updates sync

Install just the skill

npx skills add buildwithzach/shopify-changelog --skill shopify-changelog -g -a codex claude-code

The skill-only command does not modify global instruction files or install the terminal command. See the README for optional setup, requirements, updates, and uninstall instructions.

Validation: 15 automated tests pass on macOS, including isolated installation, archive persistence, search, history, and failure recovery. The Skills CLI successfully discovers the packaged skill.

Archives contain the history each feed exposes; all-time completeness is not guaranteed. Automatic referencing is agent guidance, not a hook on every message. No background schedule is installed.