Compatibility
Reinstate Compatibility: Agents, Versions, and Operating Systems
Reinstate RC8 supports same-vendor session sync for tested Claude Code and Codex CLI versions, with macOS and native Windows as the primary Phase 1 platforms. Stable v0.1 certification still depends on the remaining native-device and two-device release gates.
- Last verified
- Current release
- v0.1.0-rc.8
- Release status
- pre-1.0 release candidate
- Owner
- Harjot Singh Rana
Agent and version matrix
| Agent | Phase 1 session status | Tested stable range | Resume mode | Last tested |
|---|---|---|---|---|
| Claude Code | Primary Release Target | 2.1.219–2.1.220 | Claude Code to Claude Code | Test source |
| OpenAI Codex CLI | Primary Release Target | 0.133.0–0.145.0 | Codex to Codex | Test source |
| Gemini CLI | Not in Phase 1 | None | Not supported | Not tested |
| OpenCode, Cursor, Grok Build | Not in Phase 1 | None | Not supported | Not tested |
These ranges represent current source compatibility evidence on macOS arm64 and deterministic synthetic fixtures at commit 4a7ccac3bf9b. They are not a claim that every platform row has passed physical-device certification. Prereleases and versions outside each inclusive range are UNTESTED. The same reviewed records are available as machine-readable JSON. The agent-version change tracker records when the inclusive ranges and fail-closed behavior changed across release candidates.
Operating-system matrix
| Environment | Claude Code | Codex CLI | RC8 status | Evidence |
|---|---|---|---|---|
| macOS native · arm64 | Required | Required | Local Verification Green | Evidence and gate |
| macOS native · amd64 | Required Before Stable | Required Before Stable | Release Gate Open | No completed result Evidence and gate |
| Windows 11 native · amd64 | Required | Required | Release Gate Open | Evidence and gate |
| Windows 11 WSL2 · amd64 | Documented Smoke Target | Documented Smoke Target | Release Gate Open | No completed result Evidence and gate |
Machine-readable status was last reviewed on . Open gates use an explicit null last-tested value rather than a guessed freshness date.
What the compatibility states mean
- Supported
- Exact layout and version range has release evidence; discovery, push, and pull proceed.
- Untested
- Recognizable but unverified; discovery is read-only and writes fail closed.
- Unsupported
- Known-incompatible layout, version, environment, or agent; the operation stops.
- Not installed
- No local installation or session root found; reported as informational.
rein setup check returns compatibility exit code 5 when an installed adapter is UNTESTED or UNSUPPORTED. Phase 1 has no unsafe compatibility override.
How cross-platform path compatibility works
Reinstate rewrites known structural paths to portable tokens such as$${HOME} and $${REPO:<id>}. The destination device expands those tokens using its own configured paths. The internal mapper's work-alias primitive is not wired into RC8 configuration or adapters. Free-form transcript prose and unknown fields are left unchanged.
Native Windows and WSL2 are separate devices.
Do not point both environments at one shared agent-state directory. Their path semantics and vendor layouts differ, so each must have its own Reinstate device identity and mappings.
Explicitly unsupported in Phase 1
- WSL1.
- Treating native Windows and WSL as one Reinstate device.
- Automatically sharing one agent-state directory between Windows and WSL.
- Exporting or restoring an untested agent layout.
- Agents other than Claude Code and Codex CLI.
- Silent translation between Claude Code and Codex native transcripts.
- Syncing vendor credentials, raw secrets, MCP settings, skills, or plugins.
Verify your own device
Run rein setup check before pushing real sessions. Treat its state as authoritative for the installed version and local layout, and review the repository's compatibility evidence when a vendor ships a new version.