Compatibility
Reinstate Compatibility: Agents, Versions, and Operating Systems
The catalog names eighteen coding agents. Encrypted sync (T5) covers Claude Code, Codex CLI, and OpenCode. Grok Build and Qwen Code are T4 handoff destinations with same-vendor native resume. Gemini CLI and Kimi Code CLI are T2 handoff sources. Four more are T1 read-only, and seven are T0: named, with a reason they are not usable. Native resume stays same-vendor.
- Last verified
- Current release
- v0.6.0-rc.6
- Release status
- v0.6.0-rc.6 candidate · stable remains v0.5.1 · v0.6.0-rc.5 tagged Windows run (plus two same-artifact rechecks) ended FAIL (211/4/0/0 of 215), zero product defects, grok:E1-E3 live-backend-connectivity plus a grok version drift to 1.0.13 and an H7 digest-equality-unmeasurable gap the four PARTIAL rows · this candidate widens the verified Grok Build range to 1.0.13 and refines the H7 live-home check to per-file listing with attribution · native Windows tagged-artifact acceptance pending, macOS deferred
- Owner
- Harjot Singh Rana
Support is a tier, not a yes-or-no flag
T5 is encrypted same-vendor sync. T2 is a handoff source. T0 is a named agent thatrein doctor --agents can explain. A T0 row is not an integration. Native resume stays same-vendor. Cross-agent work is an explicit portable handoff into a new Claude Code or Codex session.
| Agent | Family | T0Known | T1Discover | T2Handoff source | T3Verified resume | T4Handoff destination | T5Encrypted sync | Evidence |
|---|---|---|---|---|---|---|---|---|
| Claude CodeT5 | F1Home tree | Yes | Yes | Yes | Yes | Yes | Current | Evidence |
| OpenAI Codex CLIT5 | F1Home tree | Yes | Yes | Yes | Yes | Yes | Current | Evidence |
| Gemini CLIT2 | F1Home tree | Yes | Yes | Current | — | — | — | Evidence |
| OpenCodeT5 | F3Embedded DB | Yes | Yes | Yes | Yes | Yes | Current | Evidence |
| Grok BuildT4 | F1Home tree | Yes | Yes | Yes | Yes | Current | — | Evidence |
| Kimi Code CLIT2 | F1Home tree | Yes | Yes | Current | — | — | — | Evidence |
| PiT1 | F1Home tree | Yes | Current | — | — | — | — | Evidence |
| Qwen CodeT4 | F1Home tree | Yes | Yes | Yes | Yes | Current | — | Evidence |
| Cursor CLIT1 | F1Home tree | Yes | Current | — | — | — | — | Evidence |
| ClineT1 | F1Home tree | Yes | Current | — | — | — | — | Evidence |
| Roo CodeT0 | F3Embedded DB | layout unverified | — | — | — | — | — | Evidence |
| AiderT0 | F4Project file | layout unverified | — | — | — | — | — | Evidence |
| GitHub Copilot CLIT1 | F1Home tree | Yes | Current | — | — | — | — | Evidence |
| AmpT0 | F5Remote | server-backed history | — | — | — | — | — | Evidence |
| OpenHandsT0 | F5Remote | server-backed history | — | — | — | — | — | Evidence |
| ZCodeT0 | F5Remote | desktop-only distribution | — | — | — | — | — | Evidence |
| MiniMaxT0 | F5Remote | layout unverified | — | — | — | — | — | Evidence |
| Antigravity CLIT0 | F1Home tree | layout unverified | — | — | — | — | — | Evidence |
Machine-readable status was last reviewed on . The same records are available as machine-readable JSON. Fixture evidence is pinned to commitcf6e430f3aa7. T0 rows have no last-tested date: the evidence is the descriptor and storage page, not a probe.
Tested version ranges
| Agent | Tier | Tested stable range | Resume mode | Last tested |
|---|---|---|---|---|
| Claude Code | T5 | 2.1.219–2.1.263 | Claude Code to Claude Code (T5 encrypted sync; T3 same-vendor resume) | Test source |
| OpenAI Codex CLI | T5 | 0.133.0–0.149.0 | Codex to Codex (T5 encrypted sync; T3 same-vendor resume) | Test source |
| Gemini CLI | T2 | 0.55.1–0.55.1 | Handoff source only (T2); no native resume | Test source |
| OpenCode | T5 | 1.18.21–1.18.29 | OpenCode to OpenCode (T5 encrypted sync; T3 same-vendor resume and fork); OpenCode as a structured handoff destination (T4) | Test source |
| Grok Build | T4 | 1.0.5–1.0.13 | Same-vendor native resume via grok --resume <uuid> (T3); handoff destination via grok --session-id <uuid> (T4) | Test source |
| Pi | T1 | 0.73.1–0.73.1 | Not usable (T1 discover only) | Test source |
| Qwen Code | T4 | 0.21.12–0.23.0 | Qwen Code to Qwen Code (T3 same-vendor resume and fork); Qwen Code as a structured handoff destination (T4) | Test source |
Every agent with a fail-closed version range is listed here, whatever its tier — T5 encrypted sync, T4 handoff destination and native resume, T2 handoff source, or T1 discovery. Ranges reflect current source compatibility evidence and deterministic synthetic fixtures; they are not a claim that every platform row has passed physical-device certification. Prereleases and versions outside each inclusive range are UNTESTED. Theagent-version change tracker records when the inclusive ranges and fail-closed behavior changed across releases.
Operating-system matrix
| Environment | Claude Code | Codex CLI | Reinstate status | Evidence |
|---|---|---|---|---|
| macOS native · arm64 | Required | Required | Stable Verified | Evidence and gate |
| macOS native · amd64 | Preview Unverified | Preview Unverified | Preview Unverified | No completed result Evidence and gate |
| Windows 11 native · amd64 | Required | Required | Stable Verified | Evidence and gate |
| Windows 11 WSL2 · amd64 | Preview Unverified | Preview Unverified | Preview Unverified | No completed result Evidence and gate |
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. Unknown layout is exit code 5, never a best-effort parse.
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 Reinstate 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
- 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.
- Encrypted sync for any agent other than Claude Code, Codex CLI, and OpenCode (T5 only).
- Native resume for T2 handoff sources or T0 catalog names.
- Silent translation between vendor-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.