An agent skill for finding and messaging Claude Code, Codex, and live registered Antigravity sessions with session-peer. You can use session-peer locally, over SSH, or through the optional paired-device transport.
The runtime demonstration shows Claude Code and Codex messaging; the skill provides agent instructions.
Basic Python CLI commands require session-peer 0.9.1 or newer. The published Python CLI coverage reference is session-peer 1.3.0. Paired-device transport is optional and needs session-peer[relay] on Unix with Python 3.11+.
For the v1.0.3 security fixes, use Python runtime 1.0.3 or newer. The compatibility versions above are CLI feature thresholds, not security recommendations.
Install the runtime and skill separately:
pipx install session-peer
session-peer --version
npx -y skills@latest add abruption/session-peer-skill \
--skill session-peer --global \
--agent claude-code --agent codex --agent antigravity \
--copy --yes
npx -y skills@latest list --global --jsonThe Skills CLI creates Claude Code and shared Codex/Antigravity copies. Open a new agent session if the skill catalog is cached.
pipx upgrade session-peer
npx -y skills@latest update session-peer --global --yesThe runtime command above is for pipx installations; keep using your existing runtime package manager. Runtime upgrades do not update the skill. See the usage guide for other installation methods and pinned versions.
A queued or submitted status does not confirm that the recipient consumed the message. Do not automatically resend after an uncertain submission; see the usage guide for Codex reply waiting.
The separate session-peer-ts skill 0.3.0 profile (minimum runtime 0.1.0, feature coverage reference 0.4.0) is recognized by published npm runtime 0.4.0. Basic commands still require the resolved TypeScript runtime’s actual version/help checks; optional features also require their platform, private-storage, permission, and writer guards. See the limited opt-in handoff guide for correlation, bounded waiting, and explicit operator-confirmed receipts; queueing or injection is not an automatic acknowledgment. Select a separately approved, published immutable skill release and verify its recorded source commit and content hash. Runtime publication does not publish, install, or authorize installation of the skill. See the TypeScript setup guide for an explicit agent, project/global scope, and reviewed commit installation.
Optional Python 1.3.0 workflows and their requirements are described in the usage guide.
- TypeScript skill setup, pinned updates, and removal
- Installation variants, pinned versions, compatibility, and reply waiting
- Published agent instructions
- Development and release procedure
- Runtime CLI reference (v1.0.4)
For skill documentation and installation issues, open an issue. For CLI and transport issues, use the runtime issue tracker.
Report vulnerabilities privately through the maintainer’s security policy, including its email fallback. Do not post secrets, conversation text, or session identifiers in public issues.