session-peer skill

한국어 · 日本語 · 简体中文

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.

Demo

The runtime demonstration shows Claude Code and Codex messaging; the skill provides agent instructions.

Quick Start

Basic Python CLI commands require session-peer 0.9.1 or newer; the full set of Python CLI features documented in the skill requires session-peer 1.0.1 or newer. 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

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 --json

The Skills CLI creates Claude Code and shared Codex/Antigravity copies. Open a new agent session if the skill catalog is cached.

Update

pipx upgrade session-peer
npx -y skills@latest update session-peer --global --yes

The 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.2.0 supports the npm TypeScript runtime; runtime 0.3.3 accepts its metadata profile. See the TypeScript setup guide for an explicit agent, project/global scope, and reviewed commit installation.

Docs

• 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)

License

MIT

Support and security

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.