abruption · Sep 27, 2026 · Sep 27, 2026 · Sep 27, 2026 · Sep 27, 2026 · Sep 27, 2026
diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml
@@ -50,15 +50,32 @@ jobs:
       - name: Exercise release packaging without publishing or credentials
         run: node scripts/release.mjs pack && node scripts/release.mjs artifact
       - run: npm audit
+  windows-native:
+    runs-on: windows-latest
+    timeout-minutes: 10
+    strategy:
+      fail-fast: false
+      matrix:
+        node: ['22', '24']
+    steps:
+      - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
+      - uses: actions/setup-node@820762786026740c76f36085b0efc47a31fe5020 # v7.0.0
+        with:
+          node-version: ${{ matrix.node }}
+          cache: npm
+      - run: npm ci --ignore-scripts
+      - run: npm run test:windows
+      - run: npm audit
   release-gate:
     name: release gate
     if: always()
-    needs: [repository-policy, contract]
+    needs: [repository-policy, contract, windows-native]
     runs-on: ubuntu-latest
     timeout-minutes: 5
     steps:
       - name: Require every validation job
         env:
           POLICY: ${{ needs.repository-policy.result }}
           CONTRACT: ${{ needs.contract.result }}
-        run: test "$POLICY" = success && test "$CONTRACT" = success
+          WINDOWS: ${{ needs.windows-native.result }}
+        run: test "$POLICY" = success && test "$CONTRACT" = success && test "$WINDOWS" = success
diff --git a/README.ja.md b/README.ja.md
@@ -15,11 +15,11 @@
 - インストール済みの同じクライアントへの SSH 接続、構造化 Reply-To URI、JSON 出力。
 - 宛先や所有者が曖昧なら拒否。不確実な提出を自動再送しません。
 
-Windows、Relay 通信、MCP、wake/resume、非アクティブ queue、Antigravity、自動更新、暗黙の全エージェント検出、人間向けテキスト出力は未実装です。未対応コマンドは明示的に失敗します。汎用オーケストレーターではありません。
+Relay 通信、MCP、wake/resume、非アクティブ queue、Antigravity、自動更新、暗黙の全エージェント検出、人間向けテキスト出力は未実装です。未対応コマンドは明示的に失敗します。汎用オーケストレーターではありません。
 
 ## 必要条件
 
-macOS / Linux、Node **22.x の 22.13 以上、または 24.x**。Node 26 は対象外です。ネイティブ flock 依存には対応する x64/arm64 バイナリが必要で、純 JavaScript パッケージではありません。Codex 送信には `codex`・`lsof`・`ps`、Claude にはアクセス可能な inbox を持つ稼働中 TUI が必要です。SSH は既存の鍵・ホスト信頼と、接続先の**同一バージョン**のクライアントを使います。
+macOS / Linux / Windows native、Node **22.x の 22.13 以上、または 24.x**。Node 26 は対象外です。ネイティブロック依存には対応する x64/arm64 バイナリが必要で、純 JavaScript パッケージではありません。Codex 送信には `codex` が必要で、macOS/Linux では `lsof`・`ps` も必要です。Windows はネイティブロックと Restart Manager で所有者を確認します。Claude にはアクセス可能な inbox を持つ稼働中 TUI が必要です。SSH は既存の鍵・ホスト信頼と、接続先の**同一バージョン**のクライアントを使います。
 
 ## インストール
 
@@ -43,6 +43,8 @@ session-peer --version
 
 インストール前後に `type -a session-peer` と `command -v session-peer` を確認します。他の実装も同名コマンドを提供するため、PATH 上の一つを選ぶか `node /absolute/path/dist/cli.js` を使ってください。`--force` で他の管理ツールのファイルを上書きしないでください。Python パッケージ・スキル・サービスを自動変更しません。削除は `npm uninstall --global session-peer` を使い、PATH を再確認します。
 
+Windows PowerShell では `Get-Command session-peer -All` で既存コマンドを確認します。Python CLI を置換せずに試すには、`npm ci --ignore-scripts`、`npm run build`、`npm pack --ignore-scripts` の後、`npm install --prefix "$env:TEMP\session-peer-ts-preview" --ignore-scripts .\session-peer-0.1.0-preview.0.tgz` を実行し、`& "$env:TEMP\session-peer-ts-preview\node_modules\.bin\session-peer.cmd" --version` で確認します。同じ prefix の `npm uninstall --prefix "$env:TEMP\session-peer-ts-preview" session-peer` で削除します。
+
 ## 使い方
 
 ```sh
@@ -63,6 +65,8 @@ session-peer send --host user@machine --remote-bin /absolute/path/session-peer \
 
 既定のリモートコマンドは PATH の `session-peer`。絶対パスの `--remote-bin` で対応 Node を使うラッパーも指定できます。TypeScript マーカーと正確なバージョンを確認し、異なる実装は拒否します。BatchMode / StrictHostKeyChecking を使い、新しいホスト鍵の自動受理、リモートランタイムのインストール、Python フォールバックはしません。本文はリモートシェル引数ではなく JSON stdin で渡します。任意の `--ssh-opt`、IPv6 リテラル、Tailscale の正規名補完は非対応です。SSH alias / hostname を使ってください。片方向の接続成功は逆方向の接続を保証しません。
 
+Windows の SSH 宛先では `--remote-platform win32` を指定し、必要に応じて `--remote-bin 'C:\absolute\path\session-peer.cmd'` を使います。既に認証済みの OpenSSH 制御ソケットは `--ssh-control-path /local/absolute/socket` で選択できます。ホスト鍵の確認や新しいログイン権限を回避しません。Windows ローカルの Codex home には完全な `C:\Users\...\.codex` パスを使います。既存の Python CLI は自動削除・置換しません。
+
 ### 返信
 
 `session-peer://v1/reply?...` URI を `--to` に指定できます。不明 / 重複フィールド、不正ホスト・エンコード、明示した経路との矛盾は拒否します。`--reply-address URI` は明示的な返信先を付けますが、経路を自動推測・検証しません。新しい返信先なしで返すときは `--no-reply-to`。有効な CODEX_THREAD_ID / CODEX_SESSION_ID は参考用 From 情報になり、`--no-from` で省略できます。不明な送信者は捏造しません。peer 情報は権限ではなく、URI をシェルとして実行しません。
@@ -89,7 +93,7 @@ npm run test:package
 npm audit
 ```
 
-Python は開発時の互換検証基準のみです（v1.0.2、`47c23713d0a2a3c11ebde6186afd8c43489b8b65`）。実行時依存ではありません。テストには C コンパイラーと lsof も必要です。CI は基準コミットを固定し macOS/Linux × Node 22/24 を確認します。SQLite・Unix inbox・実 lock の fixture と、専用実 TUI の証拠 [VALIDATION.md](VALIDATION.md) は別です。fixture 成功は ACK ではありません。パッケージ内容、反復 pack ハッシュ、新規インストール、アンインストールも検証します。ネイティブ依存の通常の install script は実行せず、検証した prebuilt 経路は `--ignore-scripts` を使います。SQLite 読み取り専用接続も WAL 共有メモリー管理に関与し得るため、スナップショットではありません。
+Python は開発時の互換検証基準のみです（v1.0.2、`47c23713d0a2a3c11ebde6186afd8c43489b8b65`）。実行時依存ではありません。POSIX 契約テストには C コンパイラーと lsof も必要です。CI は基準コミットを固定し macOS/Linux/Windows × Node 22/24 を確認します。SQLite・Unix inbox・実 lock の fixture と、専用実 TUI の証拠 [VALIDATION.md](VALIDATION.md) は別です。fixture 成功は ACK ではありません。パッケージ内容、反復 pack ハッシュ、新規インストール、アンインストールも検証します。ネイティブ依存の通常の install script は実行せず、検証した prebuilt 経路は `--ignore-scripts` を使います。SQLite 読み取り専用接続も WAL 共有メモリー管理に関与し得るため、スナップショットではありません。
 
 [CONTRIBUTING.md](CONTRIBUTING.md)、[RELEASING.md](RELEASING.md)、[SECURITY.md](SECURITY.md) を参照してください。公開には別途承認が必要で、自動 npm 公開はありません。[MIT](LICENSE) ライセンスです。
 

diff --git a/README.ko.md b/README.ko.md
@@ -19,15 +19,16 @@ TypeScript 클라이언트입니다. Python 없이 Node.js로 실행합니다.
 - 구조화된 Reply-To URI와 JSON 결과
 - 모호한 대상·확인할 수 없는 소유권은 거부하고, 불확실한 제출은 자동 재시도하지 않음
 
-Windows, Relay 전송, MCP, wake/resume, 비활성 세션 queue, Antigravity, 자동 업데이트,
+Relay 전송, MCP, wake/resume, 비활성 세션 queue, Antigravity, 자동 업데이트,
 암묵적인 전체 에이전트 탐색, 일반 텍스트 출력은 미지원입니다. 미지원 옵션은 명시적으로
 거부하며 범용 오케스트레이터를 지향하지 않습니다.
 
 ## 요구사항
 
-macOS/Linux와 Node **22.x의 22.13 이상 또는 24.x**가 필요합니다. Node 26은
+macOS/Linux/Windows native와 Node **22.x의 22.13 이상 또는 24.x**가 필요합니다. Node 26은
 미지원입니다. 네이티브 flock 의존성에 맞는 사전 빌드 바이너리(x64/arm64)가 필요하므로
-순수 JavaScript 패키지는 아닙니다. Codex 전송에는 `codex`, `lsof`, `ps`와 저장된
+순수 JavaScript 패키지는 아닙니다. Codex 전송에는 `codex`가 필요하고 macOS/Linux에서는
+`lsof`, `ps`도 필요합니다. Windows는 네이티브 잠금과 Restart Manager로 소유자를 확인합니다. 저장된
 스레드의 유일하고 안정적인 live writer가 필요합니다. Claude는 접근 가능한 inbox가
 있는 실행 중 TUI가 필요합니다. SSH에는 OpenSSH, 기존 키·호스트 신뢰 설정과 원격의
 **동일 버전 클라이언트**가 필요합니다.
@@ -64,6 +65,18 @@ session-peer --version
 않습니다. npm 설치본 제거는 `npm uninstall --global session-peer`로 하고 PATH를
 다시 확인하세요.
 
+Windows PowerShell에서는 `Get-Command session-peer -All`로 기존 설치본을 확인하세요.
+Python CLI를 덮어쓰지 않으려면 격리 prefix에 설치·제거할 수 있습니다.
+
+```powershell
+npm ci --ignore-scripts
+npm run build
+npm pack --ignore-scripts
+npm install --prefix "$env:TEMP\session-peer-ts-preview" --ignore-scripts .\session-peer-0.1.0-preview.0.tgz
+& "$env:TEMP\session-peer-ts-preview\node_modules\.bin\session-peer.cmd" --version
+# 이후 제거: npm uninstall --prefix "$env:TEMP\session-peer-ts-preview" session-peer
+```
+
 ## 사용법
 
 ```sh
@@ -95,6 +108,12 @@ Node를 선택하는 래퍼를 지정할 수 있습니다. TypeScript 표시와
 Tailscale 정규 이름 보강은 미지원이므로 SSH 별칭·호스트명을 사용하세요. 정방향 접속이
 역방향 접속을 보장하지 않습니다.
 
+Windows SSH 대상에는 `--remote-platform win32`를 명시하고, 원격 PATH에 없다면
+`--remote-bin 'C:\절대\경로\session-peer.cmd'`를 지정하세요. 이미 인증된 OpenSSH
+제어 소켓은 `--ssh-control-path /로컬/절대/소켓`으로 선택할 수 있습니다. 이는 호스트 키
+검증을 우회하거나 새 로그인을 허용하지 않습니다. Windows 로컬 Codex 홈은
+`C:\Users\...\.codex`처럼 전체 경로를 사용합니다. 기존 Python CLI는 자동 제거·교체하지 않습니다.
+
 ### 회신
 
 `session-peer://v1/reply?...` URI를 `--to`로 사용할 수 있습니다. 알 수 없거나 중복된
@@ -134,7 +153,7 @@ npm audit
 
 Python은 개발용 호환성 기준(v1.0.2 커밋
 `47c23713d0a2a3c11ebde6186afd8c43489b8b65`)일 뿐 런타임 의존성이 아닙니다. 테스트에는
-C 컴파일러와 lsof도 필요합니다. CI는 참조 커밋을 고정하고 macOS/Linux × Node 22/24를
+C 컴파일러와 lsof는 POSIX 계약 테스트에 필요합니다. CI는 참조 커밋을 고정하고 macOS/Linux/Windows × Node 22/24를
 검사합니다. 임시 SQLite·Unix inbox·실제 잠금 fixture와 [VALIDATION.md](VALIDATION.md)의
 실제 TUI 증거는 구분합니다. fixture 통과는 ACK가 아닙니다. 패키지 내용·반복 빌드 해시·
 새 환경 설치·삭제도 검사합니다. 네이티브 의존성에는 설치 스크립트가 있지만 검증한 사전

diff --git a/README.md b/README.md
@@ -21,15 +21,16 @@ a Relay server or hosted service.
 - Refuse ambiguous targets and uncertain ownership; never automatically retry
   an uncertain submission.
 
-Not implemented: Windows, Relay transport, MCP, wake/resume, inactive queueing,
+Not implemented: Relay transport, MCP, wake/resume, inactive queueing,
 Antigravity, automatic updates, implicit multi-agent discovery, or human text
 output. Unsupported commands fail explicitly; this is not a general orchestrator.
 
 ## Requirements
 
-macOS or Linux; Node **22.13+ within 22.x or 24.x**. Node 26 is not supported.
+macOS, Linux or native Windows; Node **22.13+ within 22.x or 24.x**. Node 26 is not supported.
 The native flock dependency needs a matching prebuilt binary (x64/arm64); this
-is not a pure-JavaScript package. Codex sends also need `codex`, `lsof` and `ps`.
+is not a pure-JavaScript package. Codex sends need `codex`; macOS/Linux also
+need `lsof` and `ps`. Windows uses native lock and Restart Manager inspection.
 Claude needs a live TUI with an accessible native inbox. SSH requires OpenSSH,
 existing key/host trust and the **same client version** on the destination.
 
@@ -65,6 +66,18 @@ or call this build explicitly with `node /absolute/path/dist/cli.js`. Do not use
 is installed, removed or reconfigured automatically. To remove this npm install,
 run `npm uninstall --global session-peer` and recheck PATH.
 
+On Windows PowerShell, inspect competing commands with
+`Get-Command session-peer -All`. To avoid replacing the Python CLI, use an isolated prefix:
+
+```powershell
+npm ci --ignore-scripts
+npm run build
+npm pack --ignore-scripts
+npm install --prefix "$env:TEMP\session-peer-ts-preview" --ignore-scripts .\session-peer-0.1.0-preview.0.tgz
+& "$env:TEMP\session-peer-ts-preview\node_modules\.bin\session-peer.cmd" --version
+# Later: npm uninstall --prefix "$env:TEMP\session-peer-ts-preview" session-peer
+```
+
 ## Use
 
 ```sh
@@ -97,6 +110,14 @@ JSON stdin request, not remote shell arguments. Arbitrary `--ssh-opt`, IPv6
 literals and Tailscale canonical-name enrichment are not supported; use an SSH
 alias/hostname. Forward access does not establish reverse access.
 
+For a Windows SSH destination, add `--remote-platform win32` and select a
+Windows `--remote-bin 'C:\absolute\path\session-peer.cmd'` if needed. A previously
+authenticated OpenSSH control socket can be selected with
+`--ssh-control-path /absolute/local/socket`; this does not bypass host-key
+verification or grant a new login. For local Windows Codex commands, use a full
+`C:\Users\...\.codex` path for `--codex-home`. The Python CLI, if present,
+is not removed or replaced by this preview.
+
 ### Replies
 
 Use a `session-peer://v1/reply?...` URI as `--to`. Unknown/duplicate fields,
@@ -137,8 +158,9 @@ npm audit
 
 Python is only the development conformance oracle (v1.0.2 commit
 `47c23713d0a2a3c11ebde6186afd8c43489b8b65`), never a runtime dependency. Tests also
-need a C compiler and lsof. CI pins the reference and covers macOS/Linux × Node
-22/24. Temporary SQLite, Unix inbox and real lock fixtures are distinct from
+need a C compiler and lsof for the POSIX contract suite. CI pins the reference
+and covers macOS/Linux/Windows × Node 22/24. Temporary
+SQLite, Unix inbox and real lock fixtures are distinct from
 the dedicated real-TUI evidence in [VALIDATION.md](VALIDATION.md). A green fixture
 test is not an ACK. Package tests inspect contents, repeat-pack hashes, clean
 install and uninstall. The native dependency normally has an install script;