session-peer 1.0.2__tar.gz → 1.0.4__tar.gz

session_peer-1.0.4/PKG-INFO

@@ -0,0 +1,155 @@
+Metadata-Version: 2.5
+Name: session-peer
+Version: 1.0.4
+Summary: Discover and message Claude Code, Codex, and Antigravity sessions locally, over SSH, through MCP, or via an optional end-to-end encrypted relay.
+Project-URL: Homepage, https://github.com/abruption/session-peer
+Project-URL: Repository, https://github.com/abruption/session-peer
+Project-URL: Issues, https://github.com/abruption/session-peer/issues
+Author-email: YEONGUK LEE <hashcode@kakao.com>
+License-Expression: MIT
+License-File: LICENSE
+Keywords: claude-code,cli,codex,cross-session,messaging,ssh
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: MacOS
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Software Development
+Classifier: Topic :: System :: Networking
+Classifier: Topic :: Utilities
+Requires-Python: >=3.9
+Provides-Extra: mcp
+Requires-Dist: mcp<2,>=1.12; (python_version >= '3.10') and extra == 'mcp'
+Provides-Extra: relay
+Requires-Dist: cryptography<51,>=50.0.1; (python_version >= '3.11') and extra == 'relay'
+Requires-Dist: websockets<18,>=17.1; (python_version >= '3.11') and extra == 'relay'
+Description-Content-Type: text/markdown
+
+# session-peer
+
+[![PyPI](https://img.shields.io/pypi/v/session-peer)](https://pypi.org/project/session-peer/)
+[![PyPI downloads per week](https://api.pepy.tech/badge/session-peer/week)](https://pepy.tech/projects/session-peer)
+[![PyPI downloads per month](https://api.pepy.tech/badge/session-peer/month)](https://pepy.tech/projects/session-peer)
+[![CI](https://github.com/abruption/session-peer/actions/workflows/ci.yml/badge.svg)](https://github.com/abruption/session-peer/actions/workflows/ci.yml)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://github.com/abruption/session-peer/blob/main/LICENSE)
+
+**English** · [한국어](https://github.com/abruption/session-peer/blob/main/README.ko.md) · [日本語](https://github.com/abruption/session-peer/blob/main/README.ja.md) · [简体中文](https://github.com/abruption/session-peer/blob/main/README.zh-CN.md)
+
+**Find and message Claude Code and Codex sessions from one CLI, locally or over SSH.**
+
+Ask another session to review a change, report progress, or pick up a task.
+session-peer uses native agent inboxes and queues; the receiving agent decides how to respond.
+
+<a id="see-it-in-action"></a>
+
+## Demo
+
+![Codex sends a request to Claude Code and receives an explicit ACK](https://raw.githubusercontent.com/abruption/session-peer/main/docs/assets/session-peer-live-codex-claude.gif)
+
+A real local request and reply using session-peer 1.0.2: Codex contacts Claude Code
+and receives `ACK DEMO-READY`. CLI and message excerpts are anonymized and re-rendered
+in this ~22-second animation, not a screen recording; send success alone is not an ACK.
+
+## Quick Start
+
+<a id="installation-options"></a>
+
+### Install
+
+Python 3.9+. The core local/SSH CLI has no third-party Python dependencies.
+Current stable release: **1.0.4**.
+
+Maintenance release dated 2026-10-07; see the [release notes](docs/releases/v1.0.4.md). Package publication and operational deployment are separate.
+
+```bash
+pipx install session-peer
+session-peer --version
+session-peer list
+```
+
+Use `uv tool install session-peer` instead if you prefer uv. Native Windows,
+virtual-environment pip, and standalone/SSH installation variants are in the
+[installation guide](https://github.com/abruption/session-peer/blob/main/docs/cli-reference.md#install).
+
+For SSH discovery, replace the example host `worker` with your host or alias.
+Then replace the fictional session name and full UUID with the listed destination:
+
+```bash
+session-peer list --host worker
+session-peer send --to api-worker --message "Report progress"
+session-peer send --host worker --to 'codex:00000000-0000-4000-8000-000000000001' --message "Review the change"
+```
+
+The SSH destination needs Python and the target agent's native inbox or queue,
+but not an installed session-peer CLI. For a custom Codex home, pass the listed
+`codexHome` with `--codex-home`; use `--dry-run` to validate without sending.
+Use the destination account that owns the session (`--host USER@HOST`).
+SSH access and receiver permissions still apply.
+
+**`posted` / `queued` confirms submission, not consumption, ACK, or completion.**
+Ask for an explicit reply when needed. Ordinary sends refuse inactive Codex destinations
+by default and do not start them. Never automatically retry an uncertain send.
+
+The optional [agent skill](https://github.com/abruption/session-peer-skill) is installed separately
+from the runtime; see the installation guide for its Skills CLI command.
+
+### Update
+
+Use the same manager that installed the runtime:
+
+```bash
+pipx upgrade session-peer
+# or: uv tool upgrade session-peer
+# or, in its virtual environment: python -m pip install --upgrade session-peer
+```
+
+For local installations, `session-peer update` replaces standalone runtime files;
+package-managed installs receive upgrade guidance instead. It never updates agent skills:
+use their original installer (Skills CLI, or `install.sh` for its bundled copy).
+See [update details and remote limitations](https://github.com/abruption/session-peer/blob/main/docs/cli-reference.md#updating).
+
+<a id="documentation"></a>
+
+## Docs
+
+- [Documentation map](https://github.com/abruption/session-peer/blob/main/docs/README.md): user, integration, operator, and development guides.
+- [CLI reference](https://github.com/abruption/session-peer/blob/main/docs/cli-reference.md): options, JSON, installation variants, and migration.
+- [Diagnostics and replies](https://github.com/abruption/session-peer/blob/main/docs/diagnostics.md) · [Multiple Codex homes](https://github.com/abruption/session-peer/blob/main/docs/multi-home-list.md).
+- [AI-assisted setup](https://github.com/abruption/session-peer/blob/main/docs/ai-assistant-guide.md) · [Project site](https://abruption.dev/projects/session-peer/) · [Release notes](https://github.com/abruption/session-peer/releases).
+- [Release process](https://github.com/abruption/session-peer/blob/main/RELEASING.md).
+
+[Paired devices / encrypted Relay](https://github.com/abruption/session-peer/blob/main/docs/paired-devices.md)
+require Unix, Python 3.11+, and `session-peer[relay]`, with pinned identities and
+explicit receiver policy. Package publication does not guarantee hosted-service availability.
+The blind Relay cannot decrypt application message content.
+[MCP / Codex plugin](https://github.com/abruption/session-peer/blob/main/docs/mcp.md) requires Python 3.10+
+and `session-peer[mcp]`; MCP wake requires both `send` and `wake` capabilities.
+[Wake](https://github.com/abruption/session-peer/blob/main/docs/wake.md) runs only when explicitly requested
+and can start a turn, consume usage, and change project files.
+The [Antigravity bridge](https://github.com/abruption/session-peer/blob/main/docs/antigravity.md) remains experimental.
+
+English is canonical; Korean, Japanese, and Simplified Chinese guides are kept aligned.
+Translations do not change the CLI output language.
+
+## License
+
+[MIT](https://github.com/abruption/session-peer/blob/main/LICENSE).
+
+## Support and security
+
+Use [GitHub Issues](https://github.com/abruption/session-peer/issues/new/choose) for bugs and features.
+Report vulnerabilities [privately](https://github.com/abruption/session-peer/security/advisories/new)
+under the [security policy](https://github.com/abruption/session-peer/blob/main/SECURITY.md), not in public issues.
+Redact secrets, conversation text, session IDs, and personal paths from shared diagnostics.
+
+For private questions or an alternative security contact, email
+[support@abruption.dev](mailto:support@abruption.dev) with `[session-peer]` in the subject.
+Support is best effort, with no guaranteed response time. Emails are reviewed manually, never automatically published as issues.
+English and Korean reports are welcome.

session_peer-1.0.4/README.ja.md

@@ -0,0 +1,121 @@
+# session-peer
+
+[![PyPI](https://img.shields.io/pypi/v/session-peer)](https://pypi.org/project/session-peer/)
+[![PyPIの週間ダウンロード](https://api.pepy.tech/badge/session-peer/week)](https://pepy.tech/projects/session-peer)
+[![PyPIの月間ダウンロード](https://api.pepy.tech/badge/session-peer/month)](https://pepy.tech/projects/session-peer)
+[![CI](https://github.com/abruption/session-peer/actions/workflows/ci.yml/badge.svg)](https://github.com/abruption/session-peer/actions/workflows/ci.yml)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://github.com/abruption/session-peer/blob/main/LICENSE)
+
+[English](https://github.com/abruption/session-peer/blob/main/README.md) · [한국어](https://github.com/abruption/session-peer/blob/main/README.ko.md) · **日本語** · [简体中文](https://github.com/abruption/session-peer/blob/main/README.zh-CN.md)
+
+**ひとつのCLIでローカルやSSH接続先のClaude Code・Codexセッションを検索し、メッセージを送れます。**
+
+別のセッションに変更のレビュー、進捗報告、作業の引き継ぎを依頼できます。
+標準の受信箱やキューを利用し、応答方法は受信側のエージェントが決定します。
+
+<a id="see-it-in-action"></a>
+
+## デモ
+
+![CodexがClaude Codeに依頼を送り、明示的なACKを受け取るデモ](https://raw.githubusercontent.com/abruption/session-peer/main/docs/assets/session-peer-live-codex-claude.gif)
+
+session-peer 1.0.2による実際のローカル通信です。CodexがClaude Codeに依頼を送り、
+`ACK DEMO-READY`を受け取ります。CLI出力とメッセージの抜粋を匿名化して再描画した
+約22秒のアニメーションで、画面録画ではありません。送信成功だけではACKを意味しません。
+
+## クイックスタート
+
+<a id="installation-options"></a>
+
+### インストール
+
+Python 3.9以上が必要です。基本のローカル・SSH CLIに外部Python依存パッケージはありません。
+現在の安定版：**1.0.4**。
+
+2026-10-07付のメンテナンス版の[リリースノート](docs/ja/releases/v1.0.4.md)を参照してください。パッケージ公開と本番配備は別です。
+
+```bash
+pipx install session-peer
+session-peer --version
+session-peer list
+```
+
+uvを使う場合は `uv tool install session-peer` を選べます。ネイティブWindows、
+仮想環境のpip、単独スクリプト・SSHのインストール方法は
+[インストールガイド](https://github.com/abruption/session-peer/blob/main/docs/ja/cli-reference.md#install)を参照してください。
+
+SSH検索では、例のホスト `worker` を実際のホストまたはエイリアスに置き換えてください。
+その後、架空のセッション名と完全なUUIDを検索結果の接続先に置き換えてください。
+
+```bash
+session-peer list --host worker
+session-peer send --to api-worker --message "進捗を教えてください"
+session-peer send --host worker --to 'codex:00000000-0000-4000-8000-000000000001' --message "変更をレビューしてください"
+```
+
+SSH接続先にはPythonと対象エージェントの標準受信箱・キューが必要ですが、
+session-peer CLIのインストールは不要です。独自のCodexホームは検索結果の
+`codexHome` を `--codex-home` で指定し、`--dry-run` で送信せずに検証できます。
+セッションを所有する接続先アカウントを使ってください（`--host USER@HOST`）。
+SSHと受信側の権限が適用されます。
+
+**`posted` / `queued` は受信箱・キューへの提出の確認であり、消費・ACK・作業完了の確認ではありません。**
+必要なら明示的な返信を依頼してください。通常の送信は停止中のCodex接続先をデフォルトで拒否し、
+起動もしません。結果が不確かな送信を自動で再試行しないでください。
+
+オプションの [エージェントスキル](https://github.com/abruption/session-peer-skill) はランタイムとは
+別にインストールします。Skills CLIのコマンドはインストールガイドを参照してください。
+
+### 更新
+
+ランタイムをインストールした管理ツールで更新してください。
+
+```bash
+pipx upgrade session-peer
+# または: uv tool upgrade session-peer
+# または、対象の仮想環境内で: python -m pip install --upgrade session-peer
+```
+
+ローカルのインストールでは、`session-peer update` は単独スクリプトのランタイムファイルを置き換えます。
+パッケージ版には更新方法を案内します。このコマンドはスキルを更新しません。
+元のインストールツール（Skills CLI、または同梱コピーの `install.sh`）を使ってください。
+[更新の詳細とリモートでの制約](https://github.com/abruption/session-peer/blob/main/docs/ja/cli-reference.md#updating)を参照してください。
+
+<a id="documentation"></a>
+
+## ドキュメント
+
+- [文書マップ](https://github.com/abruption/session-peer/blob/main/docs/ja/README.md)：ユーザー、統合、運用、開発ガイド
+- [CLIリファレンス](https://github.com/abruption/session-peer/blob/main/docs/ja/cli-reference.md)：オプション、JSON、インストール方法、移行
+- [診断と返信](https://github.com/abruption/session-peer/blob/main/docs/ja/diagnostics.md) · [複数のCodexホーム](https://github.com/abruption/session-peer/blob/main/docs/ja/multi-home-list.md)
+- [AIを利用したセットアップ](https://github.com/abruption/session-peer/blob/main/docs/ja/ai-assistant-guide.md) · [プロジェクトサイト](https://abruption.dev/projects/session-peer/) · [リリースノート](https://github.com/abruption/session-peer/releases)
+- [リリース手順](https://github.com/abruption/session-peer/blob/main/RELEASING.ja.md)
+
+[デバイスのペアリング・暗号化Relay](https://github.com/abruption/session-peer/blob/main/docs/ja/paired-devices.md)には
+Unix、Python 3.11以上、`session-peer[relay]`、固定した識別情報と明示的な受信ポリシーが必要です。
+パッケージの公開はホスト型サービスの可用性を保証しません。
+ブラインドRelayはアプリケーションのメッセージ内容を復号できません。
+[MCP・Codexプラグイン](https://github.com/abruption/session-peer/blob/main/docs/ja/mcp.md)にはPython 3.10以上と
+`session-peer[mcp]` が必要で、MCP wakeには `send` と `wake` の両方の権限が必要です。
+[Wake](https://github.com/abruption/session-peer/blob/main/docs/ja/wake.md)は明示的に依頼した場合だけ実行し、
+ターンの開始、利用枠の消費、プロジェクトファイルの変更を伴う場合があります。
+[Antigravityブリッジ](https://github.com/abruption/session-peer/blob/main/docs/ja/antigravity.md)は実験段階です。
+
+英語が正本で、韓国語、日本語、簡体字中国語のガイドとの整合性を保ちます。
+翻訳はCLIの出力言語を変更しません。
+
+## ライセンス
+
+[MIT](https://github.com/abruption/session-peer/blob/main/LICENSE)。
+
+## サポートとセキュリティ
+
+バグや機能の提案は [GitHub Issues](https://github.com/abruption/session-peer/issues/new/choose) をご利用ください。
+脆弱性は公開Issueではなく [非公開の報告フォーム](https://github.com/abruption/session-peer/security/advisories/new) から報告し、
+[セキュリティポリシー](https://github.com/abruption/session-peer/blob/main/SECURITY.ja.md)に従ってください。
+共有する診断結果から秘密情報、会話、セッションID、個人のパスを伏せてください。
+
+非公開のご質問や代替のセキュリティ窓口には、件名に `[session-peer]` を付けて
+[support@abruption.dev](mailto:support@abruption.dev)へご連絡ください。
+できる限り対応しますが、対応期限は保証しません。メールは手動で確認し、公開Issueへ自動投稿しません。
+英語・韓国語での報告を受け付けています。

session_peer-1.0.4/README.ko.md

@@ -0,0 +1,121 @@
+# session-peer
+
+[![PyPI](https://img.shields.io/pypi/v/session-peer)](https://pypi.org/project/session-peer/)
+[![PyPI 주간 다운로드](https://api.pepy.tech/badge/session-peer/week)](https://pepy.tech/projects/session-peer)
+[![PyPI 월간 다운로드](https://api.pepy.tech/badge/session-peer/month)](https://pepy.tech/projects/session-peer)
+[![CI](https://github.com/abruption/session-peer/actions/workflows/ci.yml/badge.svg)](https://github.com/abruption/session-peer/actions/workflows/ci.yml)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://github.com/abruption/session-peer/blob/main/LICENSE)
+
+[English](https://github.com/abruption/session-peer/blob/main/README.md) · **한국어** · [日本語](https://github.com/abruption/session-peer/blob/main/README.ja.md) · [简体中文](https://github.com/abruption/session-peer/blob/main/README.zh-CN.md)
+
+**하나의 CLI로 로컬 또는 SSH 원격의 Claude Code·Codex 세션을 찾고 메시지를 보내세요.**
+
+다른 세션에 변경 검토, 진행 상황 보고, 작업 인계를 요청할 수 있어요.
+각 에이전트의 기본 수신함과 큐를 사용하며, 응답 방식은 수신 에이전트가 결정해요.
+
+<a id="see-it-in-action"></a>
+
+## 데모
+
+![Codex가 Claude Code에 요청을 보내고 명시적인 ACK를 받는 데모](https://raw.githubusercontent.com/abruption/session-peer/main/docs/assets/session-peer-live-codex-claude.gif)
+
+session-peer 1.0.2로 실제 로컬 요청과 회신을 주고받았어요. Codex가 Claude Code에
+요청을 보내고 `ACK DEMO-READY`를 받아요. CLI 출력과 메시지 발췌를 익명화해 다시 그린
+약 22초 애니메이션이며 화면 녹화는 아니에요. 전송 성공만으로 ACK를 뜻하지는 않아요.
+
+## 빠른 시작
+
+<a id="installation-options"></a>
+
+### 설치
+
+Python 3.9 이상이 필요해요. 기본 로컬·SSH CLI는 외부 Python 패키지에 의존하지 않아요.
+현재 안정판: **1.0.4**.
+
+2026-10-07 유지보수 릴리스의 [릴리스 노트](docs/ko/releases/v1.0.4.md)를 참고하세요. 패키지 공개와 운영 배포는 별개입니다.
+
+```bash
+pipx install session-peer
+session-peer --version
+session-peer list
+```
+
+uv를 선호하면 `uv tool install session-peer`를 사용하세요. 네이티브 Windows,
+가상 환경의 pip, 독립 스크립트·SSH 설치 방법은
+[설치 가이드](https://github.com/abruption/session-peer/blob/main/docs/ko/cli-reference.md#install)에 있어요.
+
+SSH 조회의 예시 호스트 `worker`를 실제 호스트 또는 별칭으로 바꿔주세요.
+그런 다음 가상 세션 이름과 전체 UUID를 조회한 목적지로 바꿔주세요.
+
+```bash
+session-peer list --host worker
+session-peer send --to api-worker --message "진행 상황을 알려주세요"
+session-peer send --host worker --to 'codex:00000000-0000-4000-8000-000000000001' --message "변경 사항을 검토해주세요"
+```
+
+SSH 목적지에는 Python과 대상 에이전트의 기본 수신함·큐가 필요하지만,
+session-peer CLI를 설치할 필요는 없어요. 사용자 지정 Codex 홈은 조회 결과의
+`codexHome`을 `--codex-home`으로 지정하고, `--dry-run`으로 전송 없이 검증하세요.
+세션을 소유한 목적지 계정을 사용하세요(`--host USER@HOST`).
+SSH 접근 권한과 수신 세션의 권한이 적용돼요.
+
+**`posted` / `queued`는 제출 확인이며 소비·ACK·작업 완료를 뜻하지 않아요.**
+필요하면 명시적으로 회신을 요청하세요. 일반 전송은 비활성 Codex 목적지를 기본적으로 거부하고,
+해당 세션을 시작하지 않아요. 결과가 불확실한 전송은 자동 재시도하지 마세요.
+
+선택형 [에이전트 스킬](https://github.com/abruption/session-peer-skill)은 실행 프로그램과
+별도로 설치해요. Skills CLI 명령은 설치 가이드를 참고하세요.
+
+### 업데이트
+
+실행 프로그램을 설치했던 관리자를 그대로 사용하세요.
+
+```bash
+pipx upgrade session-peer
+# 또는: uv tool upgrade session-peer
+# 또는, 해당 가상 환경에서: python -m pip install --upgrade session-peer
+```
+
+로컬 설치에서 `session-peer update`는 독립 스크립트 실행 파일을 교체하며,
+패키지 설치본에는 업그레이드 안내를 제공해요. 이 명령은 스킬을 갱신하지 않아요.
+스킬에는 원래 설치 도구(Skills CLI 또는 동봉 사본의 `install.sh`)를 사용하세요.
+[업데이트 상세와 원격 제약](https://github.com/abruption/session-peer/blob/main/docs/ko/cli-reference.md#updating)을 참고하세요.
+
+<a id="documentation"></a>
+
+## 문서
+
+- [문서 지도](https://github.com/abruption/session-peer/blob/main/docs/ko/README.md): 사용자·통합·운영·개발 가이드
+- [CLI 참조](https://github.com/abruption/session-peer/blob/main/docs/ko/cli-reference.md): 옵션·JSON·설치 변형·마이그레이션
+- [진단과 회신](https://github.com/abruption/session-peer/blob/main/docs/ko/diagnostics.md) · [여러 Codex 홈](https://github.com/abruption/session-peer/blob/main/docs/ko/multi-home-list.md)
+- [AI 지원 설치](https://github.com/abruption/session-peer/blob/main/docs/ko/ai-assistant-guide.md) · [프로젝트 사이트](https://abruption.dev/projects/session-peer/) · [릴리스 노트](https://github.com/abruption/session-peer/releases)
+- [릴리스 절차](https://github.com/abruption/session-peer/blob/main/RELEASING.ko.md)
+
+[기기 페어링·암호화 Relay](https://github.com/abruption/session-peer/blob/main/docs/ko/paired-devices.md)는
+Unix·Python 3.11 이상·`session-peer[relay]`와 고정된 기기 신원·명시적 수신 정책이 필요해요.
+패키지 발행이 호스팅 서비스 가용성을 보장하지는 않아요.
+블라인드 Relay는 애플리케이션 메시지 내용을 복호화할 수 없어요.
+[MCP·Codex 플러그인](https://github.com/abruption/session-peer/blob/main/docs/ko/mcp.md)은 Python 3.10 이상과
+`session-peer[mcp]`가 필요하며, MCP wake에는 `send`와 `wake` 권한이 모두 필요해요.
+[Wake](https://github.com/abruption/session-peer/blob/main/docs/ko/wake.md)는 명시적으로 요청할 때만 실행되며,
+턴을 시작하고 사용량을 소비하거나 프로젝트 파일을 바꿀 수 있어요.
+[Antigravity 브리지](https://github.com/abruption/session-peer/blob/main/docs/ko/antigravity.md)는 실험 상태예요.
+
+영어가 정본이며 한국어·일본어·중국어 간체 가이드의 정합성을 유지해요.
+번역은 CLI의 출력 언어를 바꾸지 않아요.
+
+## 라이선스
+
+[MIT](https://github.com/abruption/session-peer/blob/main/LICENSE).
+
+## 지원 및 보안
+
+버그·기능 제안은 [GitHub Issues](https://github.com/abruption/session-peer/issues/new/choose)를 사용하세요.
+보안 취약점은 공개 이슈가 아닌 [비공개 보고](https://github.com/abruption/session-peer/security/advisories/new)로 제출하고,
+[보안 정책](https://github.com/abruption/session-peer/blob/main/SECURITY.ko.md)을 따라주세요.
+공유할 진단 결과에서 비밀정보·대화·세션 ID·개인 경로를 가려주세요.
+
+비공개 문의나 대체 보안 연락처는 제목에 `[session-peer]`를 넣어
+[support@abruption.dev](mailto:support@abruption.dev)로 이메일을 보내주세요.
+지원은 최선을 다하되 응답 시한을 보장하지 않아요. 이메일은 수동 검토하며 공개 이슈로 자동 게시하지 않아요.
+영어·한국어 보고를 환영해요.

session_peer-1.0.4/README.md

@@ -0,0 +1,121 @@
+# session-peer
+
+[![PyPI](https://img.shields.io/pypi/v/session-peer)](https://pypi.org/project/session-peer/)
+[![PyPI downloads per week](https://api.pepy.tech/badge/session-peer/week)](https://pepy.tech/projects/session-peer)
+[![PyPI downloads per month](https://api.pepy.tech/badge/session-peer/month)](https://pepy.tech/projects/session-peer)
+[![CI](https://github.com/abruption/session-peer/actions/workflows/ci.yml/badge.svg)](https://github.com/abruption/session-peer/actions/workflows/ci.yml)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://github.com/abruption/session-peer/blob/main/LICENSE)
+
+**English** · [한국어](https://github.com/abruption/session-peer/blob/main/README.ko.md) · [日本語](https://github.com/abruption/session-peer/blob/main/README.ja.md) · [简体中文](https://github.com/abruption/session-peer/blob/main/README.zh-CN.md)
+
+**Find and message Claude Code and Codex sessions from one CLI, locally or over SSH.**
+
+Ask another session to review a change, report progress, or pick up a task.
+session-peer uses native agent inboxes and queues; the receiving agent decides how to respond.
+
+<a id="see-it-in-action"></a>
+
+## Demo
+
+![Codex sends a request to Claude Code and receives an explicit ACK](https://raw.githubusercontent.com/abruption/session-peer/main/docs/assets/session-peer-live-codex-claude.gif)
+
+A real local request and reply using session-peer 1.0.2: Codex contacts Claude Code
+and receives `ACK DEMO-READY`. CLI and message excerpts are anonymized and re-rendered
+in this ~22-second animation, not a screen recording; send success alone is not an ACK.
+
+## Quick Start
+
+<a id="installation-options"></a>
+
+### Install
+
+Python 3.9+. The core local/SSH CLI has no third-party Python dependencies.
+Current stable release: **1.0.4**.
+
+Maintenance release dated 2026-10-07; see the [release notes](docs/releases/v1.0.4.md). Package publication and operational deployment are separate.
+
+```bash
+pipx install session-peer
+session-peer --version
+session-peer list
+```
+
+Use `uv tool install session-peer` instead if you prefer uv. Native Windows,
+virtual-environment pip, and standalone/SSH installation variants are in the
+[installation guide](https://github.com/abruption/session-peer/blob/main/docs/cli-reference.md#install).
+
+For SSH discovery, replace the example host `worker` with your host or alias.
+Then replace the fictional session name and full UUID with the listed destination:
+
+```bash
+session-peer list --host worker
+session-peer send --to api-worker --message "Report progress"
+session-peer send --host worker --to 'codex:00000000-0000-4000-8000-000000000001' --message "Review the change"
+```
+
+The SSH destination needs Python and the target agent's native inbox or queue,
+but not an installed session-peer CLI. For a custom Codex home, pass the listed
+`codexHome` with `--codex-home`; use `--dry-run` to validate without sending.
+Use the destination account that owns the session (`--host USER@HOST`).
+SSH access and receiver permissions still apply.
+
+**`posted` / `queued` confirms submission, not consumption, ACK, or completion.**
+Ask for an explicit reply when needed. Ordinary sends refuse inactive Codex destinations
+by default and do not start them. Never automatically retry an uncertain send.
+
+The optional [agent skill](https://github.com/abruption/session-peer-skill) is installed separately
+from the runtime; see the installation guide for its Skills CLI command.
+
+### Update
+
+Use the same manager that installed the runtime:
+
+```bash
+pipx upgrade session-peer
+# or: uv tool upgrade session-peer
+# or, in its virtual environment: python -m pip install --upgrade session-peer
+```
+
+For local installations, `session-peer update` replaces standalone runtime files;
+package-managed installs receive upgrade guidance instead. It never updates agent skills:
+use their original installer (Skills CLI, or `install.sh` for its bundled copy).
+See [update details and remote limitations](https://github.com/abruption/session-peer/blob/main/docs/cli-reference.md#updating).
+
+<a id="documentation"></a>
+
+## Docs
+
+- [Documentation map](https://github.com/abruption/session-peer/blob/main/docs/README.md): user, integration, operator, and development guides.
+- [CLI reference](https://github.com/abruption/session-peer/blob/main/docs/cli-reference.md): options, JSON, installation variants, and migration.
+- [Diagnostics and replies](https://github.com/abruption/session-peer/blob/main/docs/diagnostics.md) · [Multiple Codex homes](https://github.com/abruption/session-peer/blob/main/docs/multi-home-list.md).
+- [AI-assisted setup](https://github.com/abruption/session-peer/blob/main/docs/ai-assistant-guide.md) · [Project site](https://abruption.dev/projects/session-peer/) · [Release notes](https://github.com/abruption/session-peer/releases).
+- [Release process](https://github.com/abruption/session-peer/blob/main/RELEASING.md).
+
+[Paired devices / encrypted Relay](https://github.com/abruption/session-peer/blob/main/docs/paired-devices.md)
+require Unix, Python 3.11+, and `session-peer[relay]`, with pinned identities and
+explicit receiver policy. Package publication does not guarantee hosted-service availability.
+The blind Relay cannot decrypt application message content.
+[MCP / Codex plugin](https://github.com/abruption/session-peer/blob/main/docs/mcp.md) requires Python 3.10+
+and `session-peer[mcp]`; MCP wake requires both `send` and `wake` capabilities.
+[Wake](https://github.com/abruption/session-peer/blob/main/docs/wake.md) runs only when explicitly requested
+and can start a turn, consume usage, and change project files.
+The [Antigravity bridge](https://github.com/abruption/session-peer/blob/main/docs/antigravity.md) remains experimental.
+
+English is canonical; Korean, Japanese, and Simplified Chinese guides are kept aligned.
+Translations do not change the CLI output language.
+
+## License
+
+[MIT](https://github.com/abruption/session-peer/blob/main/LICENSE).
+
+## Support and security
+
+Use [GitHub Issues](https://github.com/abruption/session-peer/issues/new/choose) for bugs and features.
+Report vulnerabilities [privately](https://github.com/abruption/session-peer/security/advisories/new)
+under the [security policy](https://github.com/abruption/session-peer/blob/main/SECURITY.md), not in public issues.
+Redact secrets, conversation text, session IDs, and personal paths from shared diagnostics.
+
+For private questions or an alternative security contact, email
+[support@abruption.dev](mailto:support@abruption.dev) with `[session-peer]` in the subject.
+Support is best effort, with no guaranteed response time. Emails are reviewed manually, never automatically published as issues.
+English and Korean reports are welcome.

session_peer-1.0.4/README.zh-CN.md

@@ -0,0 +1,121 @@
+# session-peer
+
+[![PyPI](https://img.shields.io/pypi/v/session-peer)](https://pypi.org/project/session-peer/)
+[![PyPI每周下载量](https://api.pepy.tech/badge/session-peer/week)](https://pepy.tech/projects/session-peer)
+[![PyPI每月下载量](https://api.pepy.tech/badge/session-peer/month)](https://pepy.tech/projects/session-peer)
+[![CI](https://github.com/abruption/session-peer/actions/workflows/ci.yml/badge.svg)](https://github.com/abruption/session-peer/actions/workflows/ci.yml)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://github.com/abruption/session-peer/blob/main/LICENSE)
+
+[English](https://github.com/abruption/session-peer/blob/main/README.md) · [한국어](https://github.com/abruption/session-peer/blob/main/README.ko.md) · [日本語](https://github.com/abruption/session-peer/blob/main/README.ja.md) · **简体中文**
+
+**通过一个CLI查找本机或SSH远程主机上的Claude Code与Codex会话，并向其发送消息。**
+
+请另一会话审查改动、汇报进度或接手任务。
+session-peer使用代理原生的收件箱和队列，由接收方决定如何响应。
+
+<a id="see-it-in-action"></a>
+
+## 演示
+
+![Codex向Claude Code发送请求并收到明确ACK的演示](https://raw.githubusercontent.com/abruption/session-peer/main/docs/assets/session-peer-live-codex-claude.gif)
+
+使用session-peer 1.0.2进行了真实的本地请求与回复：Codex向Claude Code发送请求，
+并收到`ACK DEMO-READY`。这段约22秒的动画对CLI输出和消息摘录进行了匿名化与重新绘制，
+并非屏幕录像；发送成功本身并不代表收到ACK。
+
+## 快速开始
+
+<a id="installation-options"></a>
+
+### 安装
+
+需要Python 3.9或更高版本。核心本地与SSH CLI没有第三方Python依赖。
+当前稳定版：**1.0.4**。
+
+请参阅2026-10-07维护版本的[发布说明](docs/zh-CN/releases/v1.0.4.md)。包发布与运营部署是独立操作。
+
+```bash
+pipx install session-peer
+session-peer --version
+session-peer list
+```
+
+偏好uv时可使用 `uv tool install session-peer`。原生Windows、
+虚拟环境pip、独立脚本与SSH安装方式请参阅
+[安装指南](https://github.com/abruption/session-peer/blob/main/docs/zh-CN/cli-reference.md#install)。
+
+SSH查询时，请将示例主机 `worker` 替换为实际主机或别名。
+然后将虚构的会话名称和完整UUID替换为查询结果中的目标：
+
+```bash
+session-peer list --host worker
+session-peer send --to api-worker --message "请汇报进度"
+session-peer send --host worker --to 'codex:00000000-0000-4000-8000-000000000001' --message "请审查改动"
+```
+
+SSH目标需要Python以及目标代理的原生收件箱或队列，
+但无需安装session-peer CLI。自定义Codex主目录请将查询结果中的
+`codexHome` 用 `--codex-home` 指定，可用 `--dry-run` 在不发送消息的情况下验证。
+请使用拥有该会话的目标账户（`--host USER@HOST`）。
+SSH访问权限和接收方权限仍然适用。
+
+**`posted` / `queued` 仅确认提交，不代表已消费、ACK或任务完成。**
+需要时请明确要求对方回复。普通发送默认拒绝未运行的Codex目标，
+也不会启动它们。切勿自动重试结果不确定的发送。
+
+可选的 [代理技能](https://github.com/abruption/session-peer-skill) 与运行时分开安装，
+其Skills CLI命令请参阅安装指南。
+
+### 更新
+
+请使用安装运行时的同一管理工具更新：
+
+```bash
+pipx upgrade session-peer
+# 或者: uv tool upgrade session-peer
+# 或者，在其虚拟环境中: python -m pip install --upgrade session-peer
+```
+
+在本地安装中，`session-peer update` 会替换独立脚本的运行时文件；
+软件包安装版会收到升级指引。此命令不会更新代理技能；
+请使用原安装工具（Skills CLI，或同捆副本的 `install.sh`）。
+请参阅[更新详情与远程限制](https://github.com/abruption/session-peer/blob/main/docs/zh-CN/cli-reference.md#updating)。
+
+<a id="documentation"></a>
+
+## 文档
+
+- [文档导航](https://github.com/abruption/session-peer/blob/main/docs/zh-CN/README.md)：用户、集成、运维和开发指南
+- [CLI参考](https://github.com/abruption/session-peer/blob/main/docs/zh-CN/cli-reference.md)：选项、JSON、安装变体与迁移
+- [诊断与回复](https://github.com/abruption/session-peer/blob/main/docs/zh-CN/diagnostics.md) · [多个Codex主目录](https://github.com/abruption/session-peer/blob/main/docs/zh-CN/multi-home-list.md)
+- [AI辅助安装](https://github.com/abruption/session-peer/blob/main/docs/zh-CN/ai-assistant-guide.md) · [项目网站](https://abruption.dev/projects/session-peer/) · [发行说明](https://github.com/abruption/session-peer/releases)
+- [发布流程](https://github.com/abruption/session-peer/blob/main/RELEASING.zh-CN.md)
+
+[设备配对与加密Relay](https://github.com/abruption/session-peer/blob/main/docs/zh-CN/paired-devices.md)需要
+Unix、Python 3.11以上和 `session-peer[relay]`，并要求固定设备身份及显式接收策略。
+软件包发布不保证托管服务可用性。
+盲转发Relay无法解密应用消息的内容。
+[MCP与Codex插件](https://github.com/abruption/session-peer/blob/main/docs/zh-CN/mcp.md)需要Python 3.10以上及
+`session-peer[mcp]`；MCP wake需要同时具备 `send` 和 `wake` 权限。
+[Wake](https://github.com/abruption/session-peer/blob/main/docs/zh-CN/wake.md)仅在显式请求时运行，
+可能启动一轮任务、消耗使用额度或修改项目文件。
+[Antigravity桥接](https://github.com/abruption/session-peer/blob/main/docs/zh-CN/antigravity.md)仍处于实验阶段。
+
+英文为正本，韩文、日文和简体中文指南保持同步。
+翻译不会改变CLI的输出语言。
+
+## 许可证
+
+[MIT](https://github.com/abruption/session-peer/blob/main/LICENSE)。
+
+## 支持与安全
+
+错误与功能建议请使用 [GitHub Issues](https://github.com/abruption/session-peer/issues/new/choose)。
+安全漏洞请通过 [私密报告](https://github.com/abruption/session-peer/security/advisories/new) 提交，不要发布到公开Issue，
+并遵循[安全政策](https://github.com/abruption/session-peer/blob/main/SECURITY.zh-CN.md)。
+分享诊断结果前，请隐去敏感信息、对话、会话ID和个人路径。
+
+非公开咨询或替代安全联系方式，请发送邮件至
+[support@abruption.dev](mailto:support@abruption.dev)，标题注明 `[session-peer]`。
+我们会尽力提供支持，但不保证响应时限。邮件由维护者手动审核，不会自动转为公开Issue。
+欢迎英文与韩文报告。