Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
24 changes: 14 additions & 10 deletions README.ja.md
Original file line number Diff line number Diff line change
@@ -1,3 +1,5 @@
<div align="center">

# session-peer

[![PyPI](https://img.shields.io/pypi/v/session-peer)](https://pypi.org/project/session-peer/)
Expand All @@ -8,10 +10,12 @@

[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セッションを検索し、メッセージを送れます。**
**1つのコマンドラインツール(CLI)で、ローカルやSSH接続先にあるClaude Code・Codexのセッションを検索し、メッセージを送れます。**

</div>

別のセッションに変更のレビュー、進捗報告、作業の引き継ぎを依頼できます。
標準の受信箱やキューを利用し、応答方法は受信側のエージェントが決定します。
各エージェント固有の受信箱やキューを利用し、応答方法は受信側のエージェントが決定します。

<a id="see-it-in-action"></a>

Expand All @@ -32,7 +36,7 @@ session-peer 1.0.2による実際のローカル通信です。CodexがClaude Co
Python 3.9以上が必要です。基本のローカル・SSH CLIに外部Python依存パッケージはありません。
現在の安定版:**1.0.4**。

2026-10-07付のメンテナンス版の[リリースノート](docs/ja/releases/v1.0.4.md)を参照してください。パッケージ公開と本番配備は別です。
2026-10-07付のメンテナンス版の[リリースノート](docs/ja/releases/v1.0.4.md)を参照してください。パッケージ公開と本番環境への配備は別です。

```bash
pipx install session-peer
Expand All @@ -44,7 +48,7 @@ uvを使う場合は `uv tool install session-peer` を選べます。ネイテ
仮想環境のpip、単独スクリプト・SSHのインストール方法は
[インストールガイド](https://github.com/abruption/session-peer/blob/main/docs/ja/cli-reference.md#install)を参照してください。

SSH検索では、例のホスト `worker` を実際のホストまたはエイリアスに置き換えてください。
SSH経由でセッションを検出するには、例示のホスト `worker` を実際のホストまたはエイリアスに置き換えてください。
その後、架空のセッション名と完全なUUIDを検索結果の接続先に置き換えてください。

```bash
Expand All @@ -53,13 +57,13 @@ session-peer send --to api-worker --message "進捗を教えてください"
session-peer send --host worker --to 'codex:00000000-0000-4000-8000-000000000001' --message "変更をレビューしてください"
```

SSH接続先にはPythonと対象エージェントの標準受信箱・キューが必要ですが、
SSH接続先にはPythonと対象エージェント固有の受信箱・キューが必要ですが、
session-peer CLIのインストールは不要です。独自のCodexホームは検索結果の
`codexHome` を `--codex-home` で指定し、`--dry-run` で送信せずに検証できます。
セッションを所有する接続先アカウントを使ってください(`--host USER@HOST`)。
SSHと受信側の権限が適用されます。
SSHのアクセス権と受信側の権限は引き続き適用されます。

**`posted` / `queued` は受信箱・キューへの提出の確認であり、消費・ACK・作業完了の確認ではありません。**
**`posted` / `queued` は受信箱やキューに受け付けられたことを示すだけで、消費・ACK・作業完了を意味しません。**
必要なら明示的な返信を依頼してください。通常の送信は停止中のCodex接続先をデフォルトで拒否し、
起動もしません。結果が不確かな送信を自動で再試行しないでください。

Expand All @@ -77,8 +81,8 @@ pipx upgrade session-peer
```

ローカルのインストールでは、`session-peer update` は単独スクリプトのランタイムファイルを置き換えます。
パッケージ版には更新方法を案内します。このコマンドはスキルを更新しません。
元のインストールツール(Skills CLI、または同梱コピーの `install.sh`)を使ってください。
パッケージ管理ツールでインストールした場合、このコマンドは更新方法を案内するだけです。このコマンドはスキルを更新しません。
スキルの更新には、インストール時に使用したツール(Skills CLI、または同梱コピーの `install.sh`)を使ってください。
[更新の詳細とリモートでの制約](https://github.com/abruption/session-peer/blob/main/docs/ja/cli-reference.md#updating)を参照してください。

<a id="documentation"></a>
Expand All @@ -96,7 +100,7 @@ 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` の両方の権限が必要です。
`session-peer[mcp]` が必要で、MCP wakeには `send` と `wake` の両方の機能(capability)が必要です。
[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)は実験段階です。
Expand Down
38 changes: 21 additions & 17 deletions README.zh-CN.md
Original file line number Diff line number Diff line change
@@ -1,3 +1,5 @@
<div align="center">

# session-peer

[![PyPI](https://img.shields.io/pypi/v/session-peer)](https://pypi.org/project/session-peer/)
Expand All @@ -8,18 +10,20 @@

[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会话,并向其发送消息。**
**使用一个命令行工具(CLI),即可查找本机或通过SSH连接的远程主机上的Claude Code与Codex会话,并向其发送消息。**

</div>

请另一会话审查改动、汇报进度或接手任务。
session-peer使用代理原生的收件箱和队列,由接收方决定如何响应。
可以请另一个会话审查改动、汇报进度或接手任务。
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发送请求,
这是真实的本地请求与回复,使用session-peer 1.0.2完成:Codex向Claude Code发送请求,
并收到`ACK DEMO-READY`。这段约22秒的动画对CLI输出和消息摘录进行了匿名化与重新绘制,
并非屏幕录像;发送成功本身并不代表收到ACK。

Expand All @@ -32,19 +36,19 @@ session-peer使用代理原生的收件箱和队列,由接收方决定如何
需要Python 3.9或更高版本。核心本地与SSH CLI没有第三方Python依赖。
当前稳定版:**1.0.4**。

请参阅2026-10-07维护版本的[发布说明](docs/zh-CN/releases/v1.0.4.md)。包发布与运营部署是独立操作。
请参阅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、
如果使用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` 替换为实际主机或别名。
通过SSH查找会话时,请将示例主机 `worker` 替换为实际主机或别名。
然后将虚构的会话名称和完整UUID替换为查询结果中的目标:

```bash
Expand All @@ -53,17 +57,17 @@ 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` 在不发送消息的情况下验证。
SSH目标需要Python以及目标智能体自身的收件箱或队列,
但无需安装session-peer CLI。如使用自定义Codex主目录,请通过 `--codex-home`
指定查询结果中的 `codexHome`,并可用 `--dry-run` 在不发送消息的情况下验证。
请使用拥有该会话的目标账户(`--host USER@HOST`)。
SSH访问权限和接收方权限仍然适用。

**`posted` / `queued` 仅确认提交,不代表已消费、ACK或任务完成。**
**`posted` / `queued` 仅表示消息已提交到接收箱或队列,不代表消息已被消费、已收到ACK或任务已完成。**
需要时请明确要求对方回复。普通发送默认拒绝未运行的Codex目标,
也不会启动它们。切勿自动重试结果不确定的发送。

可选的 [代理技能](https://github.com/abruption/session-peer-skill) 与运行时分开安装,
可选的 [智能体技能](https://github.com/abruption/session-peer-skill) 与运行时分开安装,
其Skills CLI命令请参阅安装指南。

### 更新
Expand All @@ -77,8 +81,8 @@ pipx upgrade session-peer
```

在本地安装中,`session-peer update` 会替换独立脚本的运行时文件;
软件包安装版会收到升级指引。此命令不会更新代理技能;
请使用原安装工具(Skills CLI,或同捆副本的 `install.sh`)。
通过软件包管理器安装的版本只会显示升级指引。此命令不会更新智能体技能;
请使用原安装工具(Skills CLI,或随附副本的 `install.sh`)。
请参阅[更新详情与远程限制](https://github.com/abruption/session-peer/blob/main/docs/zh-CN/cli-reference.md#updating)。

<a id="documentation"></a>
Expand All @@ -96,7 +100,7 @@ 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` 权限。
`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)仍处于实验阶段。
Expand All @@ -111,11 +115,11 @@ Unix、Python 3.11以上和 `session-peer[relay]`,并要求固定设备身份
## 支持与安全

错误与功能建议请使用 [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/security/advisories/new) 提交,不要发布到公开议题,
并遵循[安全政策](https://github.com/abruption/session-peer/blob/main/SECURITY.zh-CN.md)。
分享诊断结果前,请隐去敏感信息、对话、会话ID和个人路径。

非公开咨询或替代安全联系方式,请发送邮件至
[support@abruption.dev](mailto:support@abruption.dev),标题注明 `[session-peer]`。
我们会尽力提供支持,但不保证响应时限。邮件由维护者手动审核,不会自动转为公开Issue。
我们会尽力提供支持,但不保证响应时限。邮件由维护者手动审核,不会自动转为公开议题。
欢迎英文与韩文报告。
Loading
Loading