Codex Session Sync

Codex Session Sync is a Codex plugin marketplace for syncing one selected Codex conversation session to another Mac. Codex is the only supported Agent runtime.

What You Type

After setup, use it inside any Codex conversation:

sync session mini
sync session `Business review` to mini
sync session to mini 019e3ada

Equivalent wording works too:

同步当前会话到 mini
把 `业务会话标题` 同步到 mini
把这个 session 发到 mini

mini is the target name you choose during setup. If you provide a session title, id, or id prefix, Codex Session Sync syncs that single matching session instead of the conversation where you type the sync command.

Quick Setup

Copy this prompt into Codex:

I want to install and configure Codex Session Sync for Codex.

Marketplace repository:
https://github.com/loocor/codex-session-sync

Please help me complete the setup in Codex:
1. Add this repository as a Codex plugin marketplace if it is not already added. Prefer codex plugin marketplace add loocor/codex-session-sync.
2. Refresh plugin discovery and install the Codex Session Sync plugin.
3. Ask me for the target alias I want to use, such as mini.
4. Ask me for the SSH host for that target, such as codex-mini or user@MacMini.local.
5. Diagnose DNS, port 22, known_hosts, and non-interactive SSH access.
6. If SSH requires first-time trust or authentication, give me exactly one Terminal command to run, then wait for me to type done.
7. After I type done, re-check SSH and configure Codex Session Sync for that target.
8. Verify the target configuration.

Do not ask me to run package installation commands. If you need information from
me, ask one question at a time. Do not silently change SSH config, known_hosts,
authorized_keys, or SSH keys; ask before making each change.

Run the same setup on each Mac that needs to send sessions.

Uninstall

Copy this prompt into Codex when you want to remove Codex Session Sync:

I want to fully uninstall Codex Session Sync from Codex.

Marketplace repository:
https://github.com/loocor/codex-session-sync

Please help me remove Codex Session Sync safely:
1. Use codex plugin marketplace remove codex-session-sync when the Codex Session Sync marketplace is registered.
2. Verify the Codex Session Sync plugin, skill, prompts, and marketplace no longer appear in Codex.
3. Check whether ~/.codex/session-sync.json exists.
4. Ask me before deleting ~/.codex/session-sync.json.
5. Remove only Codex Session Sync-owned temporary marketplace files.
6. Ask me before changing SSH config or deleting SSH keys.
7. If the built-in marketplace remove command fails, report the exact error before trying manual cleanup.

Do not remove unrelated Codex plugins, marketplaces, sessions, auth files,
memories, caches, or project files. If anything is ambiguous, ask one question
before acting.

Manual Marketplace Path

If you prefer the Codex Desktop UI:

1. Open Codex plugin settings.
2. Add this repository as a marketplace:

https://github.com/loocor/codex-session-sync

3. Refresh plugin discovery.
4. Install Codex Session Sync.
5. In a Codex conversation, ask:

set up Codex Session Sync for mini

Codex will ask for the SSH host and finish the configuration.

Codex may show the installed marketplace path under ~/.codex/.tmp/marketplaces/codex-session-sync/. That path is only Codex's local marketplace cache. When the marketplace is added from GitHub, Codex records the Git source in ~/.codex/config.toml and uses that source for marketplace upgrades.

More Details

The marketplace catalog lives at .agents/plugins/marketplace.json. The root .codex-plugin/plugin.json provides Codex marketplace metadata, and the actual plugin package lives at plugins/codex-session-sync/.