Troubleshooting

Install / binary not found

which rein reinstate
echo "$PATH"
# rebuild from source
make build && ./bin/rein version

`pull` does not make `claude --resume` see sessions

Usually a path remap issue:

Confirm project root mapping in config (path_map)
Check that munged Claude project dirs were rewritten for this OS
Run rein status and rein diff
Verify session files landed under the expected ~/.claude/projects/...

Open an issue with OS pair (e.g. Windows 11 → macOS 15), agent version, and redacted paths.

Passphrase verification failed on second device

You must use the exact same passphrase as device 1. There is no recovery from a wrong phrase against existing ciphertext.

Conflicts after using both machines the same day

Expected if both sides modified the same session. Reinstate should create a .conflict fork rather than overwrite. Pick the winner manually; delete or archive the other.

Huge Codex history / slow sync

Large ~/.codex/sessions trees need delta/CAS sync (roadmap). Until then:

Use --scope filters / retention policies when available
Exclude very old rollouts via config globs

Accidentally almost synced credentials

Defaults block common credential paths. If you overrode excludes:

Rotate any exposed keys immediately
Remove objects from the remote bucket if uploaded
Restore excludes to secure defaults

Agent was running during pull

Close the agent (or wait for idle), then re-pull. Mid-write interleaving can corrupt append-only JSONL.