Local-first Codex session management

SessionHarbor

Back up every stable Codex session, reclaim local disk space only after verified safety gates, restore raw conversations, and review evidence-linked work from other devices.

View on GitHub Install with Codex Agent index
SessionHarbor connects multiple Codex devices to one verified data hub for backup, cleanup, restore, and reviewed context.

Three outcomes, one verified vault

Back up every session

Incremental, content-addressed backup to an external drive or mounted NAS with immutable device-owned snapshots.

Free space without blind deletion

Backup and cleanup stay separate. Old local originals become eligible only after inactivity, backup-age, open-file, and fresh hash gates.

Bridge device context

macOS and Windows devices can inspect verified peer inventories and stage only reviewed, evidence-linked context.

Start from a new Codex task

Set up SessionHarbor from https://github.com/WangPeterXF/session-harbor using the pinned v0.3.1 English bootstrap prompt. Verify the owner, tag, license, and plugin before installing. Start with the read-only dashboard and do not mutate any real session or drive without a separate explicit approval.

Copy-ready prompts are available in English and 简体中文.

Preview evidence

814/814Windows vault objects independently verified on macOS
93tests passed on both Windows and macOS for v0.3.1
SHA-256read-back verification before publication and cleanup
0automatic cleanup by default

v0.3.1 remains a public preview. A real macOS deletion-and-restore pilot matched bytes and hash; real Windows session deletion has not been tested.

For agents and AI search

Compact routing

llms.txt points agents to the smallest authoritative source for each task.

Combined context

llms-full.txt is generated from reviewed repository documentation and checked for drift in CI.

Repository rules

AGENTS.md gives coding agents exact safety invariants, source routes, and validation commands.

License and privacy

SessionHarbor is source-available for noncommercial use under PolyForm Noncommercial 1.0.0. Commercial use requires a separate written license. The tool has no developer-hosted service or telemetry and never sends session data to the developer. See the privacy policy, terms, and support guidance.