Skip to content

v0.4.0

Choose a tag to compare

@github-actions github-actions released this 11 Jul 12:12
· 12 commits to main since this release

BREAKING: envelope schema v3

JSON envelopes and process exit codes are redesigned around one rule: the output explains itself. Anything consuming the v2 envelope must update. See CHANGELOG for the full list:

  • Success is {"data": ...} (exec adds a top-level exit_code); errors are {"error": {"code", "hint", "action"}}. The ok and schema_version fields are gone.
  • 14 machine-readable error.code values; result_indeterminate marks operations that may have executed and must never be blindly retried.
  • Process exit codes are tri-state: 0 good answer, 1 completed with a bad answer, 2 sshq failed. Remote exit code passthrough is removed.
  • exec data.host is now data.alias; update --check exits 0 when an update is available (reverses v0.3.1).

Upgrading from v0.3.x with sshq update

The binary updates correctly, but the old updater may print skill_error: "new binary reported an unknown skill update error" and exit 2 at the end. This is a false alarm: the old binary cannot parse the new binary's v3 envelope when refreshing skills. Run sshq skill status to confirm — skills are updated. This affects only the one-time jump from v0.3.x.

Also in this release

  • Daemon freshness: ~/.ssh/config hot-reload and a shared shell-profile cache — config and cache changes apply without restarting the daemon; new sshq cache clear.
  • READMEs rewritten in both languages; sudo-free installation.