1 · Source mapping
macOS device
- Canonical project ID
github.com/acme/acme-app- Configured local root
/Users/alex/Code/acme-app- Recognized field
cwd
Synthetic path-mapping lab
macOS ↔ Windows Coding-Agent Path-Mapping Visualizer
Reinstate maps a recognized structural path by replacing the source device’s configured project root with a portable canonical project token, then expanding that token through the destination device’s mapping. This explainer uses fixed synthetic data only; it does not accept, persist, or transmit a real local path.
- Last verified
- Current release
- v0.1.0-rc.8
- Release status
- pre-1.0 release candidate
- Owner
- Harjot Singh Rana
Explore a synthetic mapping
Choose a direction and current Phase 1 adapter. Every value below is a public fixture invented for this page. There is no free-text field, file access, or clipboard read. No analytics script is rendered, and changing a visualizer selection makes no network request. Selections are never written to cookies, local storage, or session storage; the site's unrelated theme preference may use local storage.
Synthetic-only control: selections update this document in memory and are discarded on navigation.
2 · Portable value
Encrypted snapshot
- Structural token
$${REPO:github.com/acme/acme-app}/src/main.go- Transcript prose
Open /Users/alex/notes.txtunchanged
3 · Destination mapping
Windows device
- Configured local root
C:\src\acme-app- Expanded value
C:\src\acme-app\src\main.go
Recognized record trace
Before export
{"cwd":"/Users/alex/Code/acme-app/src/main.go"}Inside adapter archive
{"cwd":"${REPO:github.com/acme/acme-app}/src/main.go"}After restore
{"cwd":"C:\src\acme-app\src\main.go"}Native session locator
Claude Code restore recomputes its destination project-directory key fromC:\src\acme-app; it does not reuse the macOS directory key.
Recognized structural fields
| Adapter | Allow-listed keys in RC8 | Additional native-layout rule |
|---|---|---|
| Claude Code | cwd, path, file,filename, filePath, file_path,projectPath, project_path,workingDirectory, workdir | Recompute the destination project-directory key from the mapped checkout root. |
| Codex CLI | cwd, path, workdir,workingDirectory, filePath, file_path | Keep the native date-partitioned rollout path and remap structural values. |
A value is considered path-like only when it is absolute, already portable, or uses a recognized Windows drive-path shape. Unknown keys remain untouched even when their text looks like a path.
What the mapper does not change
- Free-form prompt, response, reasoning, or terminal-output prose.
- Unknown JSON keys or relative strings that do not meet the structural rule.
- Git branch, commit, uncommitted changes, runtime, shell, MCP, skill, or plugin state.
- Claude Code sessions into Codex sessions, or Codex sessions into Claude Code sessions.
- A project with no configured canonical mapping when mappings are required.
Operational boundary
This visualizer explains deterministic source behavior; it does not execute Reinstate or validate a private checkout. Use rein setup check and a pull dry-run on each real device. RC8 source checks and synthetic fixtures do not replace the remaining physical Windows, macOS amd64, WSL2, and two-device acceptance gates.
Do not paste a real private path into a website.
The current visualizer intentionally offers no such input. A future local diagnostic would need a separate threat model, reviewed client-only implementation, redaction rules, and tests proving that input never leaves the device.