v0.8.0
Changed
- Lowered the supported Node.js floor from
>=24.12to>=24.2. The real requirement was
alwaysimport.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 runrefsas-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.jsonmirror). Neither manifest carried a payload beyond the
refsskill, so installing one produced a second copy that could drift from the one
skills addinstalls — observed in practice: tworefsentries in the Codex skill picker,
and an icon that reached only one of them.refsnow 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@refsplugin-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/refsin Claude Code or$refsin 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.