Skip to content

v0.8.0

Choose a tag to compare

@boriskaiser boriskaiser released this 10 Aug 13:23
· 153 commits to main since this release

Changed

  • Lowered the supported Node.js floor from >=24.12 to >=24.2. The real requirement was
    always import.meta.main (used by the CLI's entry-point check), which Node added in 24.2.0 —
    the higher number had no other reason behind it. Users on Node 24.2 through 24.11 were
    previously blocked for no reason and can now run refs as-is.

Fixed

  • The agent skill's citation contract now binds every source reference, not only
    worker-relayed ones. An inline investigation (no worker dispatched, per the step 3
    dosing rule) previously fell outside the contract and could emit bare absolute paths
    instead of clickable relative-text links.

Removed

  • The Claude Code and Codex plugin packaging (.claude-plugin/, .codex-plugin/, and the
    .agents/plugins/marketplace.json mirror). Neither manifest carried a payload beyond the
    refs skill, so installing one produced a second copy that could drift from the one
    skills add installs — observed in practice: two refs entries in the Codex skill picker,
    and an icon that reached only one of them. refs now ships exactly two ways: the CLI from
    npm (@kaisers-io/refs) and the skill from git (skills add).

    If you installed the plugin, uninstall it (Claude Code: /plugin; Codex CLI: /plugins)
    and install the skill instead — see the install section in the README, which covers the
    repository still being private. The @refs plugin-mention gap in Codex (codex-cli 0.146.0,
    openai/codex#22078) no longer applies: there
    is no plugin to mention. Invoke the skill with /refs in Claude Code or $refs in Codex.


Published retroactively on 2026-08-10, the day this repository became public. The text above is this version's CHANGELOG.md entry, unedited — including anything it said while the repository was still private.