Upgrading Hydrate
Hydrate is on a fast release cadence during beta. We commit to SemVer (patch / minor / major), no breaking changes within a major, and a release-notes file for every tagged version. To upgrade, re-run your install command.
Upgrade in one command
# macOS / Linux
brew upgrade hydrate
# Windows
# Download the latest Hydrate.msi from the public releases page
# and run it. It replaces the previous install in place.How you'll know an upgrade is available
Once a day, the Claude Code status bar checks GitHub for the latest
release tag. If there's a newer one, the bar shows an amber
↑ vX.Y.Z available segment next to the usual fact
counts. Click nothing; just run brew upgrade hydrate
(or download the new MSI) at a moment that suits you.
The check is cached at ~/.hydrate/update-check.json
with a 24h TTL. A stale cache triggers a synchronous 2-second
fetch on the next status-bar tick; a warm cache is a file read
and adds no latency. To see the last result by hand:
cat ~/.hydrate/update-check.json.
No telemetry leaves your machine. The check hits
api.github.com/repos/getHydrate/hydrate-public/releases/latest
and writes the tag locally. To disable, delete the file and run
Claude Code with the status line off.
Release notes
| Version | Date | Summary | Link |
|---|---|---|---|
| v0.6.2 | 2026-05-29 | Quick-path hydrate setup wizard: runtime auto-detection, single-summary install-hooks output, embedder offered inline, resolved-tier hint at the end. Cross-runtime hook fixes: claude-precompact PreCompact schema fix (silences a schema-validation error on every /compact) + new vibe-session-end shim for the Vibe fork session_end event. | Release notes → |
| v0.6.1 | 2026-05-28 | Intel Mac embedder hotfix: v0.6.0 dropped darwin/amd64 from the embedder build matrix; v0.6.1 restores it via cross-compile from the macos-14 runner. Also adds a Homebrew tap safety gate so prerelease tags cannot force-bump the public formula. | Release notes → |
| v0.6.0 | 2026-05-27 | Handover-first resume (.hydrate/HANDOVER.md and per-session archive), autonomous project wiki via hydrate wiki curate, dashboard /handovers page, Files dashboard (rename of /wiki) with tree-first browser and Reveal-in-Finder. | Release notes → |
| v0.5.1 | 2026-05-21 | Cross-platform build hotfix: v0.5.0 produced no Windows artefacts because the auto-prime spawn used Unix-only syscalls. Install this, not v0.5.0. | Release notes → |
| v0.5.0 | 2026-05-21 | First-run auto-prime from CLAUDE.md, free-tier hydrate dehydrate, deterministic-NLP compression (zero LLM calls), new /chunks and /dehydrate dashboard pages. | Release notes → |
| v0.4.3 | 2026-05-17 | Windows MSI hotfix: bundles hydrate-mcp, fixes PATH, ships real ProductVersion in installer metadata. | Release notes → |
| v0.4.2 | 2026-05-17 | Release pipeline fix: all 20 binaries on every release, Linux blocks in the Brew formula, Apache-2.0 licence on every artefact. | Release notes → |
| v0.4.1 | 2026-05-17 | Licensing endpoint fix: register / activate now talk to license.gethydrate.dev (was licensing.gethydrate.dev, a hostname that never existed). | Release notes → |
| v0.3.1 | 2026-05-08 | Enterprise auth headers: every outbound call now sends X-API-Key + X-App-Reference for self-hosted policy enforcement. | Release notes → |
Full per-release detail lives in docs/release/v*.md in
the hydrate-public repo.
This page is a static snapshot; it ships with every site deploy.
Verify after upgrade
Three commands. Each must pass before you keep using the new version.
hydrate --version # must match the new tag
hydrate doctor # all checks green
brew list hydrate # bin/* should list 20 binaries (Mac / Linux)
If hydrate doctor reports a regression, downgrade
immediately with brew install getHydrate/hydrate/hydrate@<previous-tag>
and file an issue at
github.com/getHydrate/hydrate-public/issues
with the doctor output attached. See /docs/troubleshooting
for known symptoms.