Module claude_peer 

Live Claude Code peer sessions: registry discovery and inbound policy.

Claude Code is the one supported harness whose running interactive sessions are addressable. Each live process registers ~/.claude/sessions/<pid>.json and binds the Unix socket named in it. The catalog (supercode_interchange::catalog) is deliberately about persisted state only, so nothing there may claim liveness; this module is the separate, explicitly process-checking half; it feeds session activity and the mail router’s native door, which reach clients as a discovered descriptor’s activity and delivery.

Two rules earn their place here:

1. A registry file is not a live session. These files survive a crash, so every read re-checks the recorded pid with kill(pid, 0) and drops the record when the process is gone.
2. Nothing here writes the socket. The socket path is documented, but its wire frame is not, and a foreign process authenticating to it is not a supported case. Messages reach a live session through a Claude relay (crate::claude_relay), a headless Claude that sends with Claude’s own SendMessage.

Structs

ClaudePeerRefusalError

A refusal paired with the detail that names it.

ClaudePeerSession

One live Claude Code session: a registry record whose pid answered kill(pid, 0) during the read that produced this value.

ClaudePeerSettings

The user-settings portion Supercode can inspect without pretending to know a target process’s complete managed/project/CLI precedence stack.

Enums

ClaudeCrossSessionInbound

User-level policy Claude Code applies to messages from other sessions.

ClaudePeerRefusal

Why a message could not be delivered into a live session.

ClaudePeerSettingsError

Failure to read or safely update Claude Code’s user settings.

ClaudePeerStatus

Activity a live Claude Code session reports for itself.

Functions

read_claude_peer_settings

Inspect only the user-level inbound setting. The report deliberately does not claim to be Claude’s effective value because managed, project, and command-line settings can have higher precedence in a particular target.

read_registry

Read every LIVE session from a Claude registry directory.

registry_dir

Directory holding the live-session registry for the configured Claude home.

resolve_live_session

Resolve session_id to the live Claude session running it.

update_claude_peer_settings

Set or reset Claude Code’s user-level inbound policy. expected_revision prevents an explicit UI action from overwriting settings inspected before another process changed the file.

user_settings_path

Claude Code’s user settings file for the configured Claude home.

write_claude_peer_settings

Explicitly update Claude Code’s user-level inbound policy while preserving every unrelated setting. The write is atomic, refuses symlinks, and aborts when it observes an edit between its initial read and commit.