session-peer 0.9.2__tar.gz → 1.0.0__tar.gz

session_peer-1.0.0/.gitattributes

@@ -0,0 +1,3 @@
+/session_peer.py text eol=lf
+/session_peer_core/*.py text eol=lf
+/tools/generate_session_peer.py text eol=lf

{session_peer-0.9.2 → session_peer-1.0.0}/PKG-INFO

@@ -1,7 +1,7 @@
 Metadata-Version: 2.5
 Name: session-peer
-Version: 0.9.2
-Summary: Message coding agent sessions locally and over SSH
+Version: 1.0.0
+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
@@ -28,13 +28,15 @@ 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; (python_version >= '3.11') and 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)
 
@@ -43,8 +45,40 @@ Description-Content-Type: text/markdown
 **Find and message Claude Code and Codex sessions, locally or over SSH, from one CLI.**
 
 Ask a session on another machine to review a change, report progress, or pick up
-a task. session-peer uses native agent inboxes and queues; the receiving agent
-controls how incoming messages are handled.
+a task. For example, ask `api-worker` on SSH host `worker` to review a change.
+session-peer uses native agent inboxes and queues; the receiving agent controls
+how incoming messages are handled.
+
+## See it in action
+
+This 26-second recording uses live Codex and Claude Code sessions over the local
+transport—there is no mocked output.
+
+1. Codex discovers the exact Claude Code session.
+2. Codex posts a review request to the session's native inbox.
+3. Claude Code follows the structured reply address and sends a response.
+4. Codex receives the explicit reply in its own session.
+
+```mermaid
+sequenceDiagram
+    participant C as Codex session
+    participant P as session-peer CLI
+    participant I as Claude Code native inbox
+    participant H as Claude Code session
+    C->>P: Discover exact session
+    P-->>C: Return host and session ID
+    C->>P: Send request and reply address
+    P->>I: Write via local or SSH transport
+    I-->>H: Deliver request
+    H->>P: Send explicit reply
+    P-->>C: Deliver to Codex native inbox
+```
+
+![Live Codex-to-Claude Code messaging demo](docs/assets/session-peer-live-codex-claude.gif)
+
+26-second looping demo: Codex sends a request to Claude Code and receives an explicit reply.
+A successful post confirms only the inbox write. The explicit reply at the end
+confirms that the receiving session consumed the request and responded.
 
 ## Quick start
 
@@ -56,13 +90,21 @@ pipx install session-peer
 
 session-peer list
 session-peer list --host worker
+```
+
+## Send your first message
+
+The names and UUID below are fictional examples. Discover your destination first,
+then replace them with a session from its listing.
+
+```bash
 session-peer send --to api-worker --message "Report progress"
-session-peer send --host worker --to 'codex:<full-thread-uuid>' --message "Review the change"
+session-peer send --host worker --to 'codex:00000000-0000-4000-8000-000000000001' --message "Review the change"
 ```
 
 Replace `worker` with your SSH host or alias, `api-worker` with a discovered
-session name, and `<full-thread-uuid>` with the full ID from the destination's
-listing. The destination needs Python and the target agent's inbox or queue;
+session name, and the example UUID with the full ID from the destination's listing.
+The destination needs Python and the target agent's inbox or queue;
 session-peer itself need not be installed there for SSH list/send.
 
 **`posted` / `queued` means submitted, not read or completed.** Saved Codex
@@ -82,57 +124,56 @@ threads may be inactive. Ask for an explicit reply when completion matters.
 
 ## Installation options
 
-Install the Python CLI with `pipx` or `uv`, or run
-`python -m pip install session-peer` in an activated virtual environment.
-Install the agent skill separately for Claude Code, Codex, and Antigravity:
+Install the runtime with `pipx` or `uv`, or run `python -m pip install session-peer`
+in an activated virtual environment. Install the agent skill separately from its
+[dedicated repository](https://github.com/abruption/session-peer-skill):
 
 ```bash
-npx -y skills@latest add abruption/session-peer \
+npx -y skills@latest add abruption/session-peer-skill \
   --skill session-peer --global \
-  --agent claude-code --agent codex --agent antigravity --copy --yes
+  --agent claude-code --agent codex --agent antigravity \
+  --copy --yes
 ```
 
-This writes `SKILL.md` to `~/.claude/skills/session-peer/` and the shared
-`~/.agents/skills/session-peer/` path used for Codex and Antigravity. Update it
-independently with
-`npx -y skills@latest update session-peer --global --yes`. The currently
-verified `skills@1.7.0` requires Node.js 22.20 or newer.
-
-For a standalone POSIX installation without the skills CLI:
+For air-gapped or SSH deployment, the POSIX `./install.sh [--host worker]` path
+continues to bundle a compatibility copy of the skill. On native Windows use a
+Python package manager for the runtime. Optional MCP tools require Python 3.10+
+and `session-peer[mcp]`. See [installation details](https://github.com/abruption/session-peer/blob/main/docs/cli-reference.md#install).
 
-```bash
-git clone https://github.com/abruption/session-peer
-cd session-peer
-./install.sh
-# Remote installation: ./install.sh --host worker
-```
+## Let an AI assistant help
 
-The shell installer requires POSIX; on native Windows use a Python package
-manager. Optional MCP tools require Python 3.10+ and `session-peer[mcp]`.
-See [installation details](https://github.com/abruption/session-peer/blob/main/docs/cli-reference.md#install).
+If you would rather describe the goal than work through every document, give your
+coding agent the [AI-assisted setup and operation guide](https://github.com/abruption/session-peer/blob/main/docs/ai-assistant-guide.md).
+It provides a reusable request, approval and secret-handling boundaries,
+validation steps, and a completion-report format. You remain in control of
+account changes, public exposure, payments, reboots, merges, releases, and
+publication.
 
-## Optional v0.9 features
+## Optional v1.0 features
 
-The v0.9 candidate adds [Antigravity](https://github.com/abruption/session-peer/blob/main/docs/antigravity.md) through a bridge explicitly started inside an existing TUI; unfiltered `list` also includes live registered bridges.
-[Paired devices / encrypted relay](https://github.com/abruption/session-peer/blob/main/docs/paired-devices.md) require Unix, Python 3.11+ and the `[relay]` extra. Device identities are pinned and targets need explicit operator authorization. The self-hosted WSS relay cannot decrypt application messages; no NAT traversal or hosted public service is provided.
-These features are not in PyPI v0.8.0: use a reviewed candidate wheel as described in the guides until published. Ordinary local/SSH commands remain dependency-free.
+The stable `1.0.0` package includes authenticated public relay support and keeps the [Antigravity](https://github.com/abruption/session-peer/blob/main/docs/antigravity.md) bridge experimental. Unfiltered `list` also includes live registered bridges.
+[Paired devices / encrypted relay](https://github.com/abruption/session-peer/blob/main/docs/paired-devices.md) require Unix, Python 3.11+ and the `[relay]` extra. Device identities are pinned and targets need explicit authorization on the receiving endpoint. The blind WSS relay cannot decrypt application messages; hosted-service availability remains separate from the package.
+Install the stable release with `pipx install 'session-peer[relay]==1.0.0'`; package-managed upgrades may now select v1.0.0. Start with the [session-peer project page](https://abruption.dev/projects/session-peer/) and the paired-device guide above. Package publication does not guarantee hosted-service availability. Ordinary local/SSH commands remain dependency-free.
 
 ## Before you send
 
-- Use the correct destination account and agent home. SSH access and receiver permissions still apply.
-- Plain sends do not activate inactive sessions. Explicit wake can start a turn and consume usage.
+- Use the correct destination account and agent home; for custom Codex homes, pass the listed `codexHome` path with `--codex-home`. SSH access and receiver permissions still apply.
+- Plain sends do not activate inactive sessions. Explicit wake can start a turn and consume usage; MCP requires separate wake permission.
 - Redact secrets, conversation text, session IDs, and personal paths before sharing diagnostics.
 
 ## Documentation
 
+- [Project site](https://abruption.dev/projects/session-peer/): a curated overview, quick start, and documentation entry point.
+- [Repository documentation map](https://github.com/abruption/session-peer/blob/main/docs/README.md): user, integration, operator, development, and historical references.
 - [CLI reference](https://github.com/abruption/session-peer/blob/main/docs/cli-reference.md): commands, JSON, environment variables, updates, limits, and validation history.
 - [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)
 - [Moving from cc-peer](https://github.com/abruption/session-peer/blob/main/docs/cli-reference.md#moving-from-cc-peer) · [Releases](https://github.com/abruption/session-peer/releases)
 - [Adapter development](https://github.com/abruption/session-peer/blob/main/docs/agent-adapters.md) · [Release process](https://github.com/abruption/session-peer/blob/main/RELEASING.md)
 
-The four README editions cover the same quick start. Detailed docs are currently
-in English. Keep translated commands, requirements, and behavior aligned with
-the English README. These translations do not change the CLI output language.
+The README and detailed documentation are available in English, Korean, Japanese,
+and Simplified Chinese. English is canonical; CI checks that translated files,
+commands, requirements, and behavior stay aligned. These translations do not
+change the CLI output language.
 
 ## Support and security
 

session_peer-1.0.0/README.ja.md

@@ -0,0 +1,148 @@
+# 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セッションを検索し、メッセージを送信できます。**
+
+別のマシンのセッションに変更のレビュー、進捗報告、作業の引き継ぎを依頼できます。
+例えば、SSHホスト`worker`の`api-worker`セッションに変更のレビューを依頼します。
+各エージェントの標準の受信箱やキューを使い、受信したメッセージの扱いは受信側が決定します。
+
+## 実際の動作を見る
+
+この26秒の動画は、ローカル転送を使う実際のCodexとClaude Codeのセッションを
+収録したもので、出力の模擬表示はありません。
+
+1. Codexが対象のClaude Codeセッションを正確に見つけます。
+2. Codexがそのセッションの標準受信箱にレビュー依頼を投稿します。
+3. Claude Codeが構造化された返信先を使って応答を送ります。
+4. Codexが自分のセッションで明示的な返信を受け取ります。
+
+```mermaid
+sequenceDiagram
+    participant C as Codexセッション
+    participant P as session-peer CLI
+    participant I as Claude Code標準受信箱
+    participant H as Claude Codeセッション
+    C->>P: 対象セッションを特定
+    P-->>C: ホストとセッションIDを返す
+    C->>P: 依頼と返信先を送信
+    P->>I: ローカルまたはSSH転送で書き込み
+    I-->>H: 依頼を配信
+    H->>P: 明示的な返信を送信
+    P-->>C: Codex標準受信箱へ配信
+```
+
+![CodexからClaude Codeへ実際にメッセージを送るデモ](docs/assets/session-peer-live-codex-claude.gif)
+
+26秒のループデモ：CodexがClaude Codeにリクエストを送り、明示的な返信を受け取ります。
+投稿成功で確認できるのは受信箱への書き込みまでです。最後の明示的な返信により、
+受信セッションが依頼を処理して応答したことを確認できます。
+
+## クイックスタート
+
+Python 3.9以上が必要です。基本CLIにサードパーティーのPython依存パッケージはありません。
+
+```bash
+pipx install session-peer
+# 別の方法: uv tool install session-peer
+
+session-peer list
+session-peer list --host worker
+```
+
+## 最初のメッセージを送る
+
+以下の名前とUUIDは架空の例です。まず接続先を検索し、実際のセッションに置き換えてください。
+
+```bash
+session-peer send --to api-worker --message "進捗を教えてください"
+session-peer send --host worker --to 'codex:00000000-0000-4000-8000-000000000001' --message "変更をレビューしてください"
+```
+
+`worker`をSSHホストまたはエイリアス、`api-worker`を取得したセッション名に置き換えてください。
+例のUUIDは接続先で取得した完全なスレッドIDに置き換えてください。
+接続先にはPythonと対象エージェントの受信箱・キューが必要ですが、SSH経由の検索・送信のために
+session-peer自体をインストールする必要はありません。
+
+**`posted` / `queued`は送信処理の成功を表し、既読や作業完了を意味しません。**
+保存されたCodexスレッドは停止中の場合もあります。完了確認が必要なら、明示的に返信を依頼してください。
+
+## よく使う機能
+
+| 操作 | コマンド / ガイド |
+|---|---|
+| エージェントで絞り込む | `session-peer list --agent codex` |
+| 接続・設定を診断する | `session-peer doctor --host worker` |
+| 送信せずに宛先を確認する | `session-peer send --to api-worker --dry-run -m "hello"` |
+| JSONで結果を取得する | `session-peer list --output-format json` |
+| ファイルからメッセージを読む | `session-peer send --to api-worker -m - < message.txt` |
+| オプションのMCPツール / Codexプラグイン | [MCP設定](https://github.com/abruption/session-peer/blob/main/docs/ja/mcp.md) |
+| キューに送信したCodexセッションを起動する | [明示的なwake](https://github.com/abruption/session-peer/blob/main/docs/ja/wake.md) |
+
+## インストール方法
+
+ランタイムは`pipx`や`uv`、または有効化した仮想環境の`python -m pip install session-peer`で
+インストールします。エージェントスキルは[専用リポジトリ](https://github.com/abruption/session-peer-skill)から
+別途インストールします。
+
+```bash
+npx -y skills@latest add abruption/session-peer-skill \
+  --skill session-peer --global \
+  --agent claude-code --agent codex --agent antigravity \
+  --copy --yes
+```
+
+エアギャップ環境またはSSH配布では、POSIXの`./install.sh [--host worker]`が移行期間向けの
+スキルコピーを引き続き同梱します。ネイティブWindowsのランタイムにはPythonパッケージ
+マネージャーを使用してください。オプションのMCPツールにはPython 3.10以上と
+`session-peer[mcp]`が必要です。[詳細な手順](https://github.com/abruption/session-peer/blob/main/docs/ja/cli-reference.md#install)を参照してください。
+
+## AIアシスタントに作業を依頼する
+
+すべての文書を自分で確認する代わりに目標を伝えたい場合は、コーディングエージェントに
+[AIを利用したセットアップと運用ガイド](https://github.com/abruption/session-peer/blob/main/docs/ja/ai-assistant-guide.md)を渡してください。
+再利用できる依頼文、承認と秘密情報の境界、検証手順、完了報告の形式を提供します。
+アカウント変更、公開、支払い、再起動、マージ、リリース、公開作業はユーザーが引き続き管理します。
+
+## オプションの v1.0 機能
+
+安定版 `1.0.0` は認証付き公開リレーを含み、[Antigravity](https://github.com/abruption/session-peer/blob/main/docs/ja/antigravity.md) ブリッジは実験段階のままです。フィルターなしの `list` には稼働中の登録済みブリッジも表示されます。
+[デバイスのペアリング・暗号化リレー](https://github.com/abruption/session-peer/blob/main/docs/ja/paired-devices.md)にはUnix、Python 3.11以上、`[relay]`が必要です。デバイスの識別情報を固定し、受信側の端末で接続対象を明示的に許可します。ブラインドWSSリレーはメッセージを復号できず、ホスト型サービスの可用性はパッケージとは別に運用されます。
+安定版は `pipx install 'session-peer[relay]==1.0.0'` でインストールしてください。通常のパッケージ更新でも v1.0.0 が選択され得ます。[session-peerプロジェクトページ](https://abruption.dev/projects/session-peer/)と上記のデバイスペアリング文書から始めてください。パッケージ公開はホスト型サービスの可用性を保証せず、通常のローカル・SSHコマンドは外部依存なしで使えます。
+
+## 送信前の確認
+
+- 正しい接続先アカウントとエージェントのホームを指定してください。独自のCodexホームには検索結果の`codexHome`パスを`--codex-home`で指定します。SSHと受信側の権限が適用されます。
+- 通常の送信は停止中のセッションを起動しません。明示的なwakeはエージェントを実行し、利用枠を消費する場合があります。MCPでは別のwake権限が必要です。
+- 診断結果を共有する前に、秘密情報・会話・セッションID・個人のパスを伏せてください。
+
+## ドキュメント
+
+- [プロジェクトガイドサイト](https://abruption.dev/projects/session-peer/): 概要、クイックスタート、ドキュメントへの入口
+- [リポジトリ文書マップ](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)
+- [cc-peerからの移行](https://github.com/abruption/session-peer/blob/main/docs/ja/cli-reference.md#moving-from-cc-peer) · [リリース](https://github.com/abruption/session-peer/releases)
+- [アダプター開発](https://github.com/abruption/session-peer/blob/main/docs/ja/agent-adapters.md) · [リリース手順](https://github.com/abruption/session-peer/blob/main/RELEASING.ja.md)
+
+READMEと詳細文書は英語、韓国語、日本語、簡体字中国語で提供しています。
+英語文書を正本とし、CIで翻訳ファイル、コマンド、要件、動作の整合性を確認します。
+翻訳によってCLIの出力言語が変わることはありません。
+
+## サポートとセキュリティ
+
+バグや機能の提案は[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.ja.md)もご確認ください。
+非公開のご質問や代替の脆弱性報告窓口は、件名に`[session-peer]`を付けて
+[support@abruption.dev](mailto:support@abruption.dev)へご連絡ください。
+対応期限は保証していません。メールは手動で確認し、公開Issueへ自動変換しません。報告は英語・韓国語で受け付けています。
+
+[MITライセンス](https://github.com/abruption/session-peer/blob/main/LICENSE)。

session_peer-1.0.0/README.ko.md

@@ -0,0 +1,148 @@
+# 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 세션을 찾고 메시지를 보내세요.**
+
+다른 머신의 세션에 변경 검토, 진행 상황 보고, 작업 인계를 요청할 수 있어요.
+예를 들어 SSH 호스트 `worker`의 `api-worker` 세션에 변경 검토를 요청해요.
+각 에이전트의 기본 수신함과 큐를 사용하며, 메시지 처리 방식은 수신 에이전트가 결정해요.
+
+## 실제 동작 보기
+
+이 26초 영상은 로컬 전송을 사용하는 실제 Codex·Claude Code 세션을 녹화했으며,
+연출된 출력은 없어요.
+
+1. Codex가 정확한 Claude Code 세션을 찾아요.
+2. Codex가 해당 세션의 기본 수신함에 검토 요청을 게시해요.
+3. Claude Code가 구조화된 회신 주소를 따라 응답을 보내요.
+4. Codex가 자신의 세션에서 명시적인 회신을 받아요.
+
+```mermaid
+sequenceDiagram
+    participant C as Codex 세션
+    participant P as session-peer CLI
+    participant I as Claude Code 기본 수신함
+    participant H as Claude Code 세션
+    C->>P: 정확한 세션 탐색
+    P-->>C: 호스트와 세션 ID 반환
+    C->>P: 요청과 회신 주소 전송
+    P->>I: 로컬 또는 SSH 전송으로 기록
+    I-->>H: 요청 전달
+    H->>P: 명시적 회신 전송
+    P-->>C: Codex 기본 수신함으로 전달
+```
+
+![실제 Codex에서 Claude Code로 메시지를 보내는 데모](docs/assets/session-peer-live-codex-claude.gif)
+
+26초 반복 데모: Codex가 Claude Code에 요청을 보내고 명시적인 회신을 받아요.
+게시 성공으로 확인되는 것은 수신함 기록뿐이에요. 마지막의 명시적인 회신으로 수신 세션이
+요청을 처리하고 응답을 보냈음을 확인할 수 있어요.
+
+## 빠른 시작
+
+Python 3.9 이상이 필요해요. 기본 CLI는 외부 Python 패키지에 의존하지 않아요.
+
+```bash
+pipx install session-peer
+# 다른 방법: uv tool install session-peer
+
+session-peer list
+session-peer list --host worker
+```
+
+## 첫 메시지 보내기
+
+아래 이름과 UUID는 가상 예시예요. 먼저 목적지를 조회한 뒤 실제 세션으로 바꿔주세요.
+
+```bash
+session-peer send --to api-worker --message "진행 상황을 알려주세요"
+session-peer send --host worker --to 'codex:00000000-0000-4000-8000-000000000001' --message "변경 사항을 검토해주세요"
+```
+
+`worker`는 SSH 호스트 또는 별칭, `api-worker`는 조회한 세션 이름으로 바꿔주세요.
+예시 UUID는 목적지에서 조회한 전체 스레드 ID로 바꿔주세요.
+목적지에는 Python과 대상 에이전트의 수신함·큐가 필요하지만, SSH 조회·전송을 위해
+session-peer를 별도로 설치할 필요는 없어요.
+
+**`posted` / `queued`는 제출 결과이며 읽음·작업 완료를 뜻하지 않아요.**
+저장된 Codex 스레드가 실행 중이라는 보장도 없어요. 완료 확인이 필요하면 명시적으로 회신을 요청하세요.
+
+## 자주 쓰는 기능
+
+| 작업 | 명령 / 안내 |
+|---|---|
+| 에이전트별 조회 | `session-peer list --agent codex` |
+| 연결·에이전트 설정 진단 | `session-peer doctor --host worker` |
+| 전송 없이 대상 확인 | `session-peer send --to api-worker --dry-run -m "hello"` |
+| JSON 결과 출력 | `session-peer list --output-format json` |
+| 파일에서 메시지 읽기 | `session-peer send --to api-worker -m - < message.txt` |
+| 선택형 MCP 도구 / Codex 플러그인 | [MCP 설정](https://github.com/abruption/session-peer/blob/main/docs/ko/mcp.md) |
+| 큐에 제출한 Codex 세션 활성화 | [명시적 wake](https://github.com/abruption/session-peer/blob/main/docs/ko/wake.md) |
+
+## 설치 방법
+
+실행 프로그램은 `pipx`·`uv` 또는 활성화된 가상 환경의 `python -m pip install session-peer`로
+설치하세요. 에이전트 스킬은 [전용 저장소](https://github.com/abruption/session-peer-skill)에서
+별도로 설치합니다.
+
+```bash
+npx -y skills@latest add abruption/session-peer-skill \
+  --skill session-peer --global \
+  --agent claude-code --agent codex --agent antigravity \
+  --copy --yes
+```
+
+에어갭 또는 SSH 배포에서는 POSIX `./install.sh [--host worker]`가 전환 기간용 스킬
+사본을 계속 함께 설치합니다. 네이티브 Windows의 실행 프로그램은 Python 패키지 관리자를
+사용하세요. 선택형 MCP 도구는 Python 3.10 이상과 `session-peer[mcp]`가 필요해요.
+[설치 상세](https://github.com/abruption/session-peer/blob/main/docs/ko/cli-reference.md#install)를 참고하세요.
+
+## AI에게 작업 맡기기
+
+모든 문서를 직접 살피는 대신 목표를 설명하고 싶다면 코딩 에이전트에게
+[AI 지원 설치·운영 가이드](https://github.com/abruption/session-peer/blob/main/docs/ko/ai-assistant-guide.md)를 전달하세요.
+재사용 가능한 요청문, 승인·비밀정보 경계, 검증 단계와 완료 보고 형식을 제공해요.
+계정 변경, 공개 노출, 결제, 재부팅, 병합, 릴리스와 게시는 사용자가 계속 통제해요.
+
+## 선택형 v1.0 기능
+
+안정판 `1.0.0`에는 인증된 공개 릴레이 지원이 포함되며, [Antigravity](https://github.com/abruption/session-peer/blob/main/docs/ko/antigravity.md) 브리지는 실험 상태로 유지돼요. 필터 없는 `list`에는 실행 중인 등록 브리지도 표시돼요.
+[기기 페어링·암호화 릴레이](https://github.com/abruption/session-peer/blob/main/docs/ko/paired-devices.md)는 Unix·Python 3.11 이상·`[relay]` 확장이 필요해요. 기기 신원을 고정하며 수신 기기에서 대상을 명시적으로 허용해야 해요. 블라인드 WSS 릴레이는 메시지를 복호화할 수 없으며 호스팅 서비스의 가용성은 패키지와 별도로 운영돼요.
+안정판은 `pipx install 'session-peer[relay]==1.0.0'`으로 설치하세요. 패키지 관리자의 일반 업그레이드도 v1.0.0을 선택할 수 있어요. [session-peer 프로젝트 페이지](https://abruption.dev/projects/session-peer/)와 위의 기기 페어링 문서부터 확인하세요. 패키지 발행은 호스팅 서비스 가용성을 보장하지 않으며 일반 로컬·SSH 명령은 외부 의존성 없이 유지돼요.
+
+## 전송 전 확인
+
+- 올바른 목적지 계정과 에이전트 홈을 사용하세요. 사용자 지정 Codex 홈은 조회 결과의 `codexHome` 경로를 `--codex-home`으로 지정해요. SSH 접근 권한과 수신 세션의 권한이 적용돼요.
+- 일반 전송은 비활성 세션을 깨우지 않아요. 명시적 wake는 에이전트 실행과 사용량 소비를 일으킬 수 있으며, MCP에서는 별도 wake 권한이 필요해요.
+- 진단 결과를 공유하기 전에 비밀정보·대화·세션 ID·개인 경로를 가려주세요.
+
+## 문서
+
+- [프로젝트 안내 사이트](https://abruption.dev/projects/session-peer/): 핵심 소개, 빠른 시작과 문서 진입점
+- [저장소 문서 지도](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)
+- [cc-peer에서 전환](https://github.com/abruption/session-peer/blob/main/docs/ko/cli-reference.md#moving-from-cc-peer) · [릴리스](https://github.com/abruption/session-peer/releases)
+- [어댑터 개발](https://github.com/abruption/session-peer/blob/main/docs/ko/agent-adapters.md) · [릴리스 절차](https://github.com/abruption/session-peer/blob/main/RELEASING.ko.md)
+
+README와 상세 문서는 영어, 한국어, 일본어, 중국어 간체로 제공해요. 영어 문서가
+정본이며 CI가 번역 파일, 명령, 요구 사항, 동작의 정합성을 검사해요. 이 번역은 CLI
+출력 언어를 바꾸지 않아요.
+
+## 문의·보안 제보
+
+버그·기능 요청은 [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)도 확인해주세요.
+비공개 문의 또는 대체 보안 제보는 제목에 `[session-peer]`를 넣어
+[support@abruption.dev](mailto:support@abruption.dev)로 보내주세요.
+응답 기한은 보장하지 않으며 메일은 수동 검토하고 공개 Issue로 자동 전환하지 않아요. 영어·한국어 제보를 받아요.
+
+[MIT 라이선스](https://github.com/abruption/session-peer/blob/main/LICENSE).