session-peers

One script, <this skill's directory>/scripts/peers.py (Python 3 stdlib, macOS and Linux), bridges the two vendors' native primitives: Claude Code's per-session inbox socket and registry, and Codex CLI's codex queue. Read the section for the agent you are.

Terms

• Claude session: one running claude process; it has a name (/rename) and an inbox socket.
• Codex thread: one conversation held open by a codex process; it has a name only after /rename <name> in the Codex TUI.
• Shim: a small process peers.py runs per registered Codex thread. It is what Claude sees as the peer. No shim, no peer.

If you are Claude Code

First time on this machine