Autoresearch v2.2.2 is a stabilization release focused on truthful platform support, self-contained installs, and release confidence.
Highlights
- Portable Claude Code guardrails now cover native Windows with Git Bash as well as macOS and Linux.
- Sensitive-file operations use the host native permission boundary; the forgeable APPROVED: path-prefix flow is removed.
- Hook failures are visible and redacted, while guardrails remain explicitly documented as defense in depth rather than a security sandbox.
- Remote ssh, tsh, scp, and rsync operands are separated from local path inspection to avoid false denials.
- Runtime helpers are bundled consistently across Claude Code, Codex, and OpenCode distributions.
- Clean installs validate Node.js 18+ before mutation and execute bundled orchestration and regression helpers outside the source checkout.
- Regression scoring fails closed on malformed classification, tier, boolean, dimension, numeric, and truncated TSV data.
- Targeted transforms preserve unrelated host distributions; full transforms remain byte-idempotent.
- Release preparation is PR-first: it validates, pushes a release branch, and opens a PR without merging, tagging, or publishing.
- README, guides, architecture, standards, contribution guidance, manifests, and release notes now reflect the verified 14-command surface and host-specific capabilities.
Versions
- Canonical and Claude package version: 2.2.2
- Skill frontmatter versions across all five distributions: 2.2.2
- Codex plugin manifest: 2.2.2-codex.0
Verification
- Local PrePRGate: 13/13 phases sealed
- Hook suite: 228/228
- Orchestrator and clean-install suite: 195/195
- Regression suite: 65/65
- Maintenance and release-refusal suite: 50/50
- Total local assertions: 538/538
- Exact-head PR checks: 4/4
- Release-readiness matrix: macOS, Ubuntu, and Windows all passed, including the USERPROFILE-aware Windows hook-log path
Upgrade
Claude Code:
/plugin marketplace add uditgoenka/autoresearch
/plugin install autoresearch@autoresearch
Codex:
git clone https://github.com/uditgoenka/autoresearch.git
cd autoresearch
./scripts/install.sh --codex --global
OpenCode:
git clone https://github.com/uditgoenka/autoresearch.git
cd autoresearch
./scripts/install.sh --opencode --global
After upgrading, restart the host session so the updated commands and hook registrations are loaded.
Contributor credit
Thank you to MiaoDX for the runtime-helper packaging work associated with this stabilization line, and to halonke, ilynabwork, and 1954843148 for the detailed guardrail reports that helped harden v2.2.2.