Module codex_peer 

Live stock-Codex session discovery.

Codex does not publish a peer registry or a supported attachment endpoint, but its process keeps every rollout it currently owns open. This module joins that process-owned file descriptor back to the persisted catalog path. The rollout’s last explicit lifecycle event then distinguishes an executing turn from a merely running session. No timing or CPU heuristic is used.

Enums

CodexPeerStatus

Activity proven for a rollout owned by stock Codex.

Functions

holds_session

Whether pid holds the rollout of Codex session session_id open.

live_rollouts

Every Codex rollout currently held open by a stock codex process, with the narrowest activity state its own event stream proves.

rollout_cwd

The working directory a rollout’s conversation runs in, from its first session_meta record.

rollout_session

A rollout’s session id and, for a subagent thread, its parent’s id.

rollout_status

Activity for a discovered catalog path owned by a currently running Codex.

session_of_process

The Codex session a process runs: the root rollout (one with no parent thread) among the files pid holds open, as (session id, rollout path). None when pid holds no Codex rollout.