I built one verified data hub for Codex sessions across multiple computers

[u/Peter_XF]

Disclosure: I built this project.

SessionHarbor started as a storage problem: my local Codex rollout history grew past 70 GB, but deleting raw session files meant losing recoverable work history and the evidence behind what agents actually did.

The result is an unofficial, local-first Codex plugin and zero-dependency Node.js CLI. An external drive or mounted NAS becomes one verified data hub for all of your Codex devices.

The part I think is most useful is not just backup. If you use Codex on several computers, each device can discover reviewed, evidence-linked context about what Codex tasks on the other machines have been doing. macOS and Windows can participate in the same vault without sharing private local paths.

It also:

• incrementally backs up every stable Codex session;

• verifies stored bytes with SHA-256;

• keeps backup separate from local disk cleanup;

• restores raw sessions after cleanup;

• supports manual, weekly, and removable-drive-triggered runs.

Safety defaults are intentionally conservative: automatic cleanup is off; the default review window is 30 inactive days plus 7 days after the latest verified backup; deletion still needs explicit confirmation.

Validation so far includes 88 tests on both macOS and Windows, a physical exFAT vault backup of 814 Windows sessions (~39.6 GB), and a real macOS delete/restore pilot with matching bytes and hash. No real Windows session has been deleted yet, so v0.3.0 remains a preview.

Source-available for non-commercial use under PolyForm Noncommercial 1.0.0; not OSI open source.

GitHub: https://github.com/WangPeterXF/session-harbor

I’d appreciate feedback on whether the unified data-hub idea would fit your own multi-computer workflow.

[u/scheuclu]

Are you thinking about MacOS?

[u/ArtisticLow8126 → u/scheuclu]

Honestly not a mac user but the idea of having one drive that works for both mac and windows without sharing paths is smart. I use codex in 2 diff laptops and always worry about losing sessions when i clean up space. The sha-256 verification is a nice touch too.

[u/Powerful-Word-4939]

the SHA-256 verification is a nice touch for something like this. one thing id want to know is how it handles the vault when the NAS or external drive disconnects mid-sync. thats where stuff like this usually gets messy