throughline 0.16.15 → 0.16.17

package/CHANGELOG.md

@@ -10,6 +10,59 @@ shipped to npm but were not individually tagged on GitHub.
 
 ## [Unreleased]
 
+## [0.16.17] — 2026-10-10
+
+### 修正
+
+- Windowsで、Claude Codeの自動継続の後、Windows Terminalの窓が約2秒おきに開いては消えた。後継をClaude Desktopへ移す処理は、後継が手すきになるまで`claude agents --json --all`を繰り返し呼ぶ。この処理はconsoleを持たない切り離したprocessで動き、子の`pwsh.exe`を窓を隠さずに起こしていたので、呼ぶたびに新しいconsole（既定のターミナルの窓）が出ていた。後継が手すきにならない間、最長2分、ターンが終わるたびに続いた。
+  - 子processを起こす共通の部品（`src/os/portable-spawn-sync.mjs`）が、窓を隠す指定（`windowsHide`）を既定で付ける。`claude agents`・`claude stop`・後継の起動・L1の要約（`claude -p`・`codex exec`）・更新の処理が対象。
+  - URLを開く`cmd.exe /c start`と、手動の引き継ぎのapp-serverの起動にも付けた。開く先のアプリの窓は隠れない。
+  - 端末が要る`claude --desktop --resume`は、今までどおり最小化した新しいconsoleの中で呼ぶ（1回だけ）。
+  - 手すきを待つ間隔を1秒から3秒へ広げた。
+
+### 対応の範囲
+
+| | macOS | Linux | Windows |
+|---|---|---|---|
+| Claude Code | 窓の指定は効かないOS。手すきを待つ間隔だけ変わる（3秒）。単体試験とCI | 窓の指定は効かないOS。単体試験とCI。Desktopへ移す処理はLinuxでは動かない | 直した。実機の画面のあるsessionで、consoleを持たない切り離したprocessから`claude agents`を呼び、現れた窓を30msおきに数えた。0.16.16は3回の呼び出しでWindows Terminalの窓が3回、直した版は5回の呼び出しで0回。呼び出しの結果（一覧）は同じに読めた |
+| Codex | 同じ（効かないOS） | 同じ | 直した。URLを開く所は、実機で窓を隠した`cmd.exe`からアプリが開く事を確かめた（電卓のURLで代用）。自動継続のworkerが起こすL1の要約（`codex exec`）は同じ部品を通るが、個別には確かめていない |
+| Grok | 同じ（効かないOS） | 同じ | 直した。Stopのhookが起こすL1の要約が同じ部品を通る。個別には確かめていない |
+| Cursor | 同じ（効かないOS） | 同じ | 直した。Grokと同じ |
+
+### 確認していない範囲
+
+- 本物の引き継ぎの後に窓が出ない事（公開して端末へ入れた後に確かめる）。
+- 後継が手すきにならない理由（裏で動き続ける処理を持つ会話など）。その間、後継はClaude Desktopへ移らない。
+
+## [0.16.16] — 2026-10-10
+
+### 追加
+
+- Claude Desktopから始まった会話の後継を、リモートコントロール付き（`--remote-control=<後継の名前>`）で立てる。後継は裏の会話で、ターンを終えるまでClaude Desktopの一覧に出ない。作業の最中も、claude.ai/codeとClaudeのアプリから様子を見て操作できる（[ADR 0048](docs/adr/0048-claude-desktop-origin-successor-has-remote-control.md)）。
+  - 端末から始めた会話の後継には付けない。後継がさらに引き継ぐ時は、元の会話の出どころを引き継ぐ。
+  - 付けて立てるのに失敗した時は、付けずに1回だけ立て直す。引き継ぎは止めない。
+  - `auto-handoff status --host claude --json`の`remote_control_state`で読める（`requested`: 付けて立てた、`unavailable`: 付けずに立て直した、`null`: 対象外）。
+  - 環境変数`THROUGHLINE_AUTO_HANDOFF_REMOTE_CONTROL`で上書きできる（`on`・`off`）。
+
+### 対応の範囲
+
+| | macOS | Linux | Windows |
+|---|---|---|---|
+| Claude Code | 追加した。試験用フォルダで、本物のworkerが後継をリモートコントロール付きで立て、transcriptにリモートのURLが入った（Claude Code 2.1.289、画面のあるsessionの端末）。sshから立てた時は、後継は立つがURLが入らなかった | 追加した。同じ確かめでURLが入った（2.1.296）。信頼していないフォルダでは、付けずに立て直す所まで動き、どちらも`Workspace not trusted`で立たなかった（今までと同じ） | 追加した。同じ確かめでURLが入った（2.1.296） |
+| Codex | 対象外。リモートコントロールはClaude Codeの機能 | 同じ | 同じ |
+| Grok | 対象外。同じ理由。自動継続の機能も無い | 同じ | 同じ |
+| Cursor | 対象外。同じ理由。自動継続の機能も無い | 同じ | 同じ |
+
+### 変わらない事
+
+- 後継がターンを終えた時にClaude Desktopへ移して開く動き。端末から始めた会話の引き継ぎ。
+
+### 確認していない範囲
+
+- claude.ai/codeとClaudeのアプリの側で、後継が見えて操作できる所（確かめたのは、後継のtranscriptにリモートのURLが入った事まで）。
+- Claude Desktopの会話の、本物の引き継ぎでの動き（試験は、端末から始めた会話にDesktopの印を付けて流した）。
+- リモートコントロールが使えない状態（未ログインなど）での実物の動き（試験では作り物の失敗で、付けずに立て直す事を確かめた）。
+
 ## [0.16.15] — 2026-10-10
 
 ### 追加
@@ -2217,7 +2270,9 @@ two attempts, instrument first instead of patching again.
 
 ---
 
-[Unreleased]: https://github.com/kitepon/Throughline/compare/v0.16.15...HEAD
+[Unreleased]: https://github.com/kitepon/Throughline/compare/v0.16.17...HEAD
+[0.16.17]: https://github.com/kitepon/Throughline/compare/v0.16.16...v0.16.17
+[0.16.16]: https://github.com/kitepon/Throughline/compare/v0.16.15...v0.16.16
 [0.16.15]: https://github.com/kitepon/Throughline/compare/v0.16.14...v0.16.15
 [0.16.14]: https://github.com/kitepon/Throughline/compare/v0.16.13...v0.16.14
 [0.16.13]: https://github.com/kitepon/Throughline/compare/v0.16.12...v0.16.13

package/README.ja.md

@@ -69,7 +69,7 @@ throughline auto-handoff disable --host claude
 3. 同じprojectに、継続の指示を最初の指示として付けた新しいClaudeの会話を裏で立てます（`claude --bg`）。会話の名前は、前任の会話の題から`<project名>｜<作業の概要>（自動引き継ぎ）`にします。モデル・推論強度・権限は旧い会話から引き継ぎます。
 4. 最初の指示を受け取った時に、止めた時点の依頼、そのターンでここまでにしたこと（発言と道具の呼び出し）、実行されなかった道具、直近の会話の原文を注入します（上限9,500字）。止めたターンの道具の入出力は、後継が`throughline detail`で取り出せます。
 
-続きは裏の会話で動きます。`claude agents`の一覧と`claude attach <id>`で見られます。Claude Desktopの画面から始まった会話の後継は、そのターンの作業を終えた時に、Claude Desktopへ移して開きます（macOSは0.16.8から、Windowsは0.16.9から。LinuxのClaude Codeには`--desktop`が無いので開きません。[ADR 0043](docs/adr/0043-claude-successor-opens-in-desktop.md)）。Claude Codeは裏で動いている会話をDesktopへ移さないので、作業の間はDesktopには出ません。続けて引き継いだ時は、最後に作業を終えた後継だけを開きます。端末から始めた会話の後継は開きません。手で開く時は、`claude stop <id>`で裏の実行を停止し、`claude --desktop --resume <session-id>`を実行します。`session-id`は`claude agents --json --all`の`sessionId`です。環境変数`THROUGHLINE_AUTO_HANDOFF_OPEN`を`desktop`にすると出どころに関係なく開き、`off`にすると開きません。手動`/compact`、subagentの中の圧縮、`claude -p`などscriptから起動した会話は対象に含めません。
+続きは裏の会話で動きます。`claude agents`の一覧と`claude attach <id>`で見られます。Claude Desktopの画面から始まった会話の後継は、そのターンの作業を終えた時に、Claude Desktopへ移して開きます（macOSは0.16.8から、Windowsは0.16.9から。LinuxのClaude Codeには`--desktop`が無いので開きません。[ADR 0043](docs/adr/0043-claude-successor-opens-in-desktop.md)）。Claude Codeは裏で動いている会話をDesktopへ移さないので、作業の間はDesktopには出ません。続けて引き継いだ時は、最後に作業を終えた後継だけを開きます。端末から始めた会話の後継は開きません。手で開く時は、`claude stop <id>`で裏の実行を停止し、`claude --desktop --resume <session-id>`を実行します。`session-id`は`claude agents --json --all`の`sessionId`です。環境変数`THROUGHLINE_AUTO_HANDOFF_OPEN`を`desktop`にすると出どころに関係なく開き、`off`にすると開きません。手動`/compact`、subagentの中の圧縮、`claude -p`などscriptから起動した会話は対象に含めません。 Claude Desktopから始まった会話の後継は、リモートコントロール付きで立てるので、作業の最中もclaude.ai/codeとClaudeのアプリから見られます（0.16.16から。[ADR 0048](docs/adr/0048-claude-desktop-origin-successor-has-remote-control.md)）。
 
 ```bash
 throughline auto-handoff status --host claude --operation <handoff-id> --json

package/README.md

@@ -68,7 +68,7 @@ throughline auto-handoff disable --host claude
 3. 同じprojectに、継続の指示を最初の指示として付けた新しいClaudeの会話を裏で立てます（`claude --bg`）。会話の名前は、前任の会話の題から`<project名>｜<作業の概要>（自動引き継ぎ）`にします。モデル・推論強度・権限は旧い会話から引き継ぎます。
 4. 最初の指示を受け取った時に、止めた時点の依頼、そのターンでここまでにしたこと（発言と道具の呼び出し）、実行されなかった道具、直近の会話の原文を注入します（上限9,500字）。止めたターンの道具の入出力は、後継が`throughline detail`で取り出せます。
 
-続きは裏の会話で動きます。`claude agents`の一覧と`claude attach <id>`で見られます。Claude Desktopの画面から始まった会話の後継は、そのターンの作業を終えた時に、Claude Desktopへ移して開きます（macOSは0.16.8から、Windowsは0.16.9から。LinuxのClaude Codeには`--desktop`が無いので開きません。[ADR 0043](docs/adr/0043-claude-successor-opens-in-desktop.md)）。Claude Codeは裏で動いている会話をDesktopへ移さないので、作業の間はDesktopには出ません。続けて引き継いだ時は、最後に作業を終えた後継だけを開きます。端末から始めた会話の後継は開きません。手で開く時は、`claude stop <id>`で裏の実行を停止し、`claude --desktop --resume <session-id>`を実行します。`session-id`は`claude agents --json --all`の`sessionId`です。環境変数`THROUGHLINE_AUTO_HANDOFF_OPEN`を`desktop`にすると出どころに関係なく開き、`off`にすると開きません。手動`/compact`、subagentの中の圧縮、`claude -p`などscriptから起動した会話は対象に含めません。
+続きは裏の会話で動きます。`claude agents`の一覧と`claude attach <id>`で見られます。Claude Desktopの画面から始まった会話の後継は、そのターンの作業を終えた時に、Claude Desktopへ移して開きます（macOSは0.16.8から、Windowsは0.16.9から。LinuxのClaude Codeには`--desktop`が無いので開きません。[ADR 0043](docs/adr/0043-claude-successor-opens-in-desktop.md)）。Claude Codeは裏で動いている会話をDesktopへ移さないので、作業の間はDesktopには出ません。続けて引き継いだ時は、最後に作業を終えた後継だけを開きます。端末から始めた会話の後継は開きません。手で開く時は、`claude stop <id>`で裏の実行を停止し、`claude --desktop --resume <session-id>`を実行します。`session-id`は`claude agents --json --all`の`sessionId`です。環境変数`THROUGHLINE_AUTO_HANDOFF_OPEN`を`desktop`にすると出どころに関係なく開き、`off`にすると開きません。手動`/compact`、subagentの中の圧縮、`claude -p`などscriptから起動した会話は対象に含めません。 Claude Desktopから始まった会話の後継は、リモートコントロール付きで立てるので、作業の最中もclaude.ai/codeとClaudeのアプリから見られます（0.16.16から。[ADR 0048](docs/adr/0048-claude-desktop-origin-successor-has-remote-control.md)）。
 
 ```bash
 throughline auto-handoff status --host claude --operation <handoff-id> --json

package/docs/adr/0048-claude-desktop-origin-successor-has-remote-control.md

@@ -0,0 +1,47 @@
+# ADR 0048: Claude Desktop から始まった会話の後継は、リモートコントロール付きで立てる
+
+日付: 2026-10-10
+
+## Context
+
+Claude Code の自動継続は、後継を `claude --bg`（裏の会話）で立てる（ADR 0033）。Claude Desktop から始まった会話の後継は、
+ターンを終えた時に Desktop へ移して開く（ADR 0043）。動いている最中の裏の会話は Desktop へ移せないので、後継が作業している間は、
+Desktop の一覧に何も出ない。
+
+2026-10-10、Windows の実機で、本物の会話の最初の引き継ぎが起きた（Claude Desktop の会話、約 96.8 万トークン）。引き継ぎは成功したが、
+後継は裏で作業を続け、オーナーには状況が見えなかった（「スルーラインは発動したのか？状況がわからん」「リモートコントロールは有効に
+なっているのかな」）。旧い会話は Desktop の会話で、リモートの接続の記録があった。後継には無かった。Throughline が後継を立てる時に、
+リモートコントロールの指定を付けていなかった。
+
+Claude Code には `--remote-control [name]` がある。付けて立てた会話は、claude.ai/code と Claude のアプリから見て操作できる。
+実機で確かめた事（試験用フォルダ、Haiku）:
+
+- `claude --bg --name=<名前> --remote-control=<名前> …` は、Windows・Linux（Claude Code 2.1.296）と macOS（2.1.289）で通る。
+  立った会話は裏の会話（`kind: background`）で、transcript の `remote_session_change` にリモートの URL が入る。
+- 名前は `=` の形で渡す。名前を省ける option なので、離して書くと次の引数を名前として読む。
+- macOS で ssh から立てた時は、指定は通り会話も立つが、URL が入らなかった。画面のある session の端末からは入った。
+  本物の引き継ぎの worker は Claude Desktop の下で動く。
+- 信頼していないフォルダでは、リモートコントロールの有無に関係なく `Workspace not trusted` で立たない。
+
+## Decision
+
+1. Claude Desktop から始まった会話の後継と、その後継がさらに引き継ぐ時の後継を、`--remote-control=<後継の名前>` を付けて立てる。
+   端末から始めた会話の後継には付けない（オーナーの裁定。Approval Box K-4DNZDK）。
+2. Desktop から始まったかは、ADR 0043 と同じく、止める時点の transcript の最後の `entrypoint`（`claude-desktop`）と、hook の環境変数
+   `CLAUDE_CODE_ENTRYPOINT` で決める。OS は問わない。引き継ぎの記録に `remote_control.wanted` として残す。
+3. 付けて立てるのに失敗した時（終了 code が 0 でない、裏の会話の ID が返らない）は、付けずに1回だけ立て直す。引き継ぎは止めない。
+   後継が立っていない事が分かっている時だけ立て直すので、後継は2つにならない。
+4. 結果を記録の `remote_control.state`（`requested`: 付けて立てた、`unavailable`: 付けずに立て直した）に残し、
+   `auto-handoff status --host claude --json` の `remote_control_state` で読める。付けて立てた後に、Claude Code がリモートへ
+   つなげたかまでは見ない。
+5. 環境変数 `THROUGHLINE_AUTO_HANDOFF_REMOTE_CONTROL` で上書きできる。`on` は出どころに関係なく付け、`off` は付けない。
+6. 旧い会話を止めた理由の文に、後継がリモートコントロール付きで立つ事を書く。
+7. 後継がターンを終えた時に Desktop へ移して開く動き（ADR 0043）は変えない。
+
+## Consequences
+
+- Desktop で作業している利用者は、後継が作業している最中も、claude.ai/code と Claude のアプリから様子を見て操作できる。
+- リモートコントロールを付けた会話は、利用者のアカウントでログインした端末から操作できる状態になる。
+- claude.ai/code とアプリの一覧に、Desktop から始まった会話の後継が並ぶ。
+- すでに動いている後継には付かない。次の引き継ぎから付く。
+- リモートコントロールは Claude Code の機能なので、Codex・Grok・Cursor には当てはまらない。

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "throughline",
-  "version": "0.16.15",
+  "version": "0.16.17",
   "type": "module",
   "description": "Persistent memory hooks for Claude Code, Codex, Grok, and Cursor (/clear-safe context compression)",
   "keywords": [

package/src/claude-auto-handoff.mjs

@@ -61,6 +61,8 @@ const PER_SESSION_ENV = ['CLAUDECODE', 'CLAUDE_CODE_ENTRYPOINT', 'CLAUDE_CODE_ME
 const DESKTOP_ENTRYPOINT = 'claude-desktop';
 // 後継を Desktop で開くかを、会話の出どころに関係なく決める（`desktop` で必ず開く、`off` で開かない）。
 const OPEN_OVERRIDE_ENV = 'THROUGHLINE_AUTO_HANDOFF_OPEN';
+// 後継をリモートコントロール付きで立てるかの上書き。`on` は出どころに関係なく付け、`off` は付けない。
+const REMOTE_CONTROL_OVERRIDE_ENV = 'THROUGHLINE_AUTO_HANDOFF_REMOTE_CONTROL';
 
 // requested と failed は、次の道具の hook が後継の立ち上げを始められる。
 const RETRYABLE_STATES = new Set(['requested', 'failed']);
@@ -145,6 +147,9 @@ export function publicClaudeAutoHandoff(record) {
     // 後継を Claude Desktop で開く引き継ぎか、開けたか（null は対象外）。
     desktop_state: record.desktop?.wanted ? (record.desktop.state ?? 'waiting') : null,
     desktop_error_code: record.desktop?.error_code ?? null,
+    // 後継をリモートコントロール付きで立てる引き継ぎか（null は対象外）。requested は指定を付けて立てた、unavailable は付けずに立て直した。
+    // 付けて立てた後に、Claude Code がリモートへつなげたかまでは見ていない。
+    remote_control_state: record.remote_control?.wanted ? (record.remote_control.state ?? 'waiting') : null,
     requested_at, updated_at };
 }
 
@@ -220,6 +225,19 @@ function openInDesktopWanted({ sessionId, transcriptPath, env, dir, platform })
   return listClaudeAutoHandoffs({ dir }).some(record => record.successor?.session_id === sessionId && record.desktop?.wanted);
 }
 
+/**
+ * この会話の後継を、リモートコントロール付きで立てるか（ADR 0048）。
+ * Claude Desktop の画面から始まった会話と、その後継がさらに引き継ぐ時だけ付ける。後継は裏の会話で、ターンを終えるまで
+ * Desktop の一覧に出ない。リモートコントロールがあれば、作業の最中も claude.ai/code と Claude のアプリから見られる。
+ * 端末から始めた会話の後継は `claude agents`・`claude attach` で見られるので付けない。
+ */
+function remoteControlWanted({ sessionId, transcriptPath, env, dir }) {
+  if (env[REMOTE_CONTROL_OVERRIDE_ENV] === 'off') return false;
+  if (env[REMOTE_CONTROL_OVERRIDE_ENV] === 'on') return true;
+  if (env.CLAUDE_CODE_ENTRYPOINT === DESKTOP_ENTRYPOINT || readLatestEntrypoint(transcriptPath) === DESKTOP_ENTRYPOINT) return true;
+  return listClaudeAutoHandoffs({ dir }).some(record => record.successor?.session_id === sessionId && record.remote_control?.wanted);
+}
+
 /**
  * 会話を起動した project の場所を、その OS の書き方にそろえる。
  *
@@ -308,6 +326,7 @@ export function requestClaudeAutoHandoff({
     accepted_at: null,
     desktop: { wanted: openInDesktopWanted({ sessionId, transcriptPath: payload.transcript_path, env, dir, platform }),
       state: null, error_code: null, opened_at: null },
+    remote_control: { wanted: remoteControlWanted({ sessionId, transcriptPath: payload.transcript_path, env, dir }), state: null },
   });
   return { status: 'requested', block: true, sessionId, projectPath, handoffId };
 }
@@ -489,7 +508,8 @@ function stopOutput(record) {
     ? `この会話はThroughlineが新しい会話へ引き継ぎ済みです（引き継ぎID: ${record.handoff_id}）。続きは後継の会話で行ってください: claude attach ${record.successor.short_id}`
     : `Throughlineが、自動圧縮の代わりに新しい会話へ引き継ぎます（引き継ぎID: ${record.handoff_id}）。` +
       (record.desktop?.wanted
-        ? '後継の会話は裏で作業を続け、そのターンを終えた時にClaude Desktopへ開きます。途中の様子は `claude agents` の一覧で見られます。'
+        ? '後継の会話は裏で作業を続け、そのターンを終えた時にClaude Desktopへ開きます。途中の様子は `claude agents` の一覧で見られます。' +
+          (record.remote_control?.wanted ? '後継はリモートコントロール付きで立てるので、claude.ai/code とClaudeのアプリからも見られます。' : '')
         : '後継の会話は `claude agents` の一覧に出ます。');
   return {
     continue: false,
@@ -605,9 +625,12 @@ function successorName(record) {
     titles: [record.transcript_path ? readSessionTitle(record.transcript_path) : null, record.in_flight?.user?.content] });
 }
 
-function successorArgs(record) {
+function successorArgs(record, { remoteControl = false } = {}) {
   // 名前は `--name=` の形で渡す。project のフォルダ名が `-` で始まっても、option として読まれない。
-  const args = ['--bg', `--name=${successorName(record)}`];
+  const name = successorName(record);
+  const args = ['--bg', `--name=${name}`];
+  // リモートコントロールの名前も `=` の形で渡す（名前を省ける option なので、離して書くと次の引数を名前として読む）。
+  if (remoteControl) args.push(`--remote-control=${name}`);
   const { model, effort, permission_mode: permissionMode } = record.settings ?? {};
   if (model) args.push('--model', model);
   if (effort) args.push('--effort', effort);
@@ -656,13 +679,27 @@ export async function runClaudeAutoHandoffWorker(sessionId, {
     settings: { ...record.settings, model: record.transcript_path ? readLatestModel(record.transcript_path) : null },
     in_flight: inFlight,
   });
-  const launched = spawn('claude', successorArgs(record), {
+  const launch = remoteControl => spawn('claude', successorArgs(record, { remoteControl }), {
     cwd: record.project_path, env: successorEnv(env), encoding: 'utf8', timeout: 60_000, stdio: ['ignore', 'pipe', 'pipe'],
   });
+  const backgroundedId = result => BACKGROUNDED_PATTERN.exec(normalizeTerminalText(`${result.stdout ?? ''}`))?.[1];
+  let launched = launch(Boolean(record.remote_control?.wanted));
+  if (record.remote_control?.wanted) {
+    if (!launched.error && launched.status === 0 && backgroundedId(launched)) {
+      update({ remote_control: { ...record.remote_control, state: 'requested' } });
+    } else if (!launched.error && !backgroundedId(launched)) {
+      // リモートコントロールを付けると立てられない（未ログイン、古い Claude Code など）。後継は立っていないので、
+      // 付けずに立て直す。引き継ぎは止めない。
+      process.stderr.write(`[auto-handoff] claude --bg --remote-control exit=${launched.status} ` +
+        `stderr=${JSON.stringify(`${launched.stderr ?? ''}`.slice(0, 300))}; retrying without remote control\n`);
+      update({ remote_control: { ...record.remote_control, state: 'unavailable' } });
+      launched = launch(false);
+    }
+  }
   if (launched.error) {
     return fail(launched.error.code === 'ENOENT' ? 'handoff_claude_cli_unavailable' : 'handoff_successor_launch_failed');
   }
-  const shortId = BACKGROUNDED_PATTERN.exec(normalizeTerminalText(`${launched.stdout ?? ''}`))?.[1];
+  const shortId = backgroundedId(launched);
   if (launched.status !== 0 || !shortId) {
     // 理由を端末内の worker のログに残す（指示や記憶は含まれない、起動コマンドの出力だけ）。
     process.stderr.write(`[auto-handoff] claude --bg exit=${launched.status} stdout=${JSON.stringify(`${launched.stdout ?? ''}`.slice(0, 500))} ` +
@@ -741,7 +778,8 @@ export async function runClaudeDesktopOpen(sourceSessionId, {
   spawn = spawnPortableSync,
   pty = runWithPty,
   idleTimeoutMs = 120_000,
-  pollMs = 1_000,
+  // 一覧を読むたびに `claude agents` を起こす（Windows では pwsh 経由）。手すきは急いで知る必要が無いので、間を空ける。
+  pollMs = 3_000,
 } = {}) {
   let record = readClaudeAutoHandoff(sourceSessionId, dir);
   if (!record) throw new ClaudeHandoffError('handoff_not_found');

package/src/claude-auto-handoff.test.mjs

@@ -639,7 +639,83 @@ test('PreToolUse: Desktop で開く引き継ぎは、止めた理由に、後継
   writeFileSync(desktopTranscript, jsonl([{ ...user('読んで', '2026-10-08T12:00:00.000Z'), entrypoint: 'claude-desktop' }]));
   request(dir, { platform: 'darwin', transcriptPath: desktopTranscript });
   const output = await stopClaudeTurnForHandoff({ payload: { session_id: SESSION, cwd: '/work/app', tool_use_id: 't1' }, dir, launchWorker: async () => 1 });
-  assert.match(output.stopReason, /そのターンを終えた時にClaude Desktopへ開きます。途中の様子は `claude agents` の一覧で見られます。$/);
+  assert.match(output.stopReason, /そのターンを終えた時にClaude Desktopへ開きます。途中の様子は `claude agents` の一覧で見られます。後継はリモートコントロール付きで立てるので、claude\.ai\/code とClaudeのアプリからも見られます。$/);
+}));
+
+test('PreCompact: Claude Desktop から始まった会話と、その後継の引き継ぎだけ、後継をリモートコントロール付きで立てる印を付ける（OS に関係なく）', () => withDir(dir => {
+  const wanted = overrides => {
+    rmSync(join(dir, `${SESSION}.json`), { force: true });
+    request(dir, overrides);
+    return readClaudeAutoHandoff(SESSION, dir).remote_control;
+  };
+  const desktopTranscript = join(dir, 'desktop.jsonl');
+  writeFileSync(desktopTranscript, jsonl([{ ...user('読んで', '2026-10-10T05:00:00.000Z'), entrypoint: 'claude-desktop' }]));
+  const cliTranscript = join(dir, 'cli.jsonl');
+  writeFileSync(cliTranscript, jsonl([{ ...user('読んで', '2026-10-10T05:00:00.000Z'), entrypoint: 'cli' }]));
+  for (const platform of ['darwin', 'win32', 'linux']) {
+    const payload = platform === 'win32' ? { cwd: 'C:\\work\\app' } : undefined;
+    assert.deepEqual(wanted({ platform, payload, transcriptPath: desktopTranscript }), { wanted: true, state: null }, platform);
+    assert.equal(wanted({ platform, payload, env: { CLAUDE_CODE_ENTRYPOINT: 'claude-desktop' } }).wanted, true, platform);
+    assert.equal(wanted({ platform, payload, transcriptPath: cliTranscript }).wanted, false, `${platform}: 端末から始めた会話の後継には付けない`);
+    assert.equal(wanted({ platform, payload }).wanted, false, platform);
+    assert.equal(wanted({ platform, payload, transcriptPath: cliTranscript, env: { THROUGHLINE_AUTO_HANDOFF_REMOTE_CONTROL: 'on' } }).wanted, true, platform);
+    assert.equal(wanted({ platform, payload, transcriptPath: desktopTranscript, env: { THROUGHLINE_AUTO_HANDOFF_REMOTE_CONTROL: 'off' } }).wanted, false, platform);
+  }
+  // 裏で作業している後継がさらに引き継ぐ時は、元の会話の出どころを引き継ぐ（後継の transcript は cli）。
+  writeRecord(dir, 'origin-desktop', { successor: { short_id: SESSION.slice(0, 8), session_id: SESSION }, remote_control: { wanted: true, state: 'requested' } });
+  assert.equal(wanted({ platform: 'darwin', transcriptPath: cliTranscript }).wanted, true);
+  writeRecord(dir, 'origin-desktop', { successor: { short_id: SESSION.slice(0, 8), session_id: SESSION }, remote_control: { wanted: false, state: null } });
+  assert.equal(wanted({ platform: 'darwin', transcriptPath: cliTranscript }).wanted, false);
+}));
+
+test('worker: 印のある引き継ぎは、後継を --remote-control=<後継の名前> 付きで立てる。印の無い引き継ぎには付けない', () => withDir(async dir => {
+  const run = async (sessionId, env) => {
+    const transcriptPath = join(dir, `${sessionId}.jsonl`);
+    writeFileSync(transcriptPath, jsonl([{ ...user('14個のファイルを順に読んで', '2026-10-10T05:00:10Z'), entrypoint: env.CLAUDE_CODE_ENTRYPOINT ?? 'cli' },
+      { type: 'custom-title', customTitle: 'マビノギ BOT 開発' }, assistant('part04 を読みました。', '2026-10-10T05:00:12Z')]));
+    const db = makeBatonDb();
+    requestClaudeAutoHandoff({ payload: { session_id: sessionId, trigger: 'auto', cwd: '/work/OpenLogicool', transcript_path: transcriptPath },
+      env, config: ENABLED, openDb: () => db, dir, platform: 'linux' });
+    await stopClaudeTurnForHandoff({ payload: { session_id: sessionId, cwd: '/work/OpenLogicool', transcript_path: transcriptPath },
+      dir, launchWorker: async () => {} });
+    const launches = [];
+    const record = await runClaudeAutoHandoffWorker(sessionId, { dir, env: {}, pollMs: 10, acceptTimeoutMs: 300, transcriptTimeoutMs: 50,
+      spawn: (command, args) => { launches.push(args); successorStarts(dir, sessionId)(args); return launchedOk(); } });
+    return { record, launches };
+  };
+  const desktop = await run('bbbbbbbb-0000-4000-8000-000000000001', { CLAUDE_CODE_ENTRYPOINT: 'claude-desktop' });
+  assert.equal(desktop.launches.length, 1);
+  assert.deepEqual(desktop.launches[0].slice(0, 3), ['--bg', '--name=OpenLogicool｜マビノギ BOT 開発（自動引き継ぎ）', '--remote-control=OpenLogicool｜マビノギ BOT 開発（自動引き継ぎ）']);
+  assert.equal(desktop.record.state, 'sent');
+  assert.deepEqual(desktop.record.remote_control, { wanted: true, state: 'requested' });
+  assert.equal(publicClaudeAutoHandoff(desktop.record).remote_control_state, 'requested');
+
+  const terminal = await run('bbbbbbbb-0000-4000-8000-000000000002', {});
+  assert.ok(!terminal.launches[0].some(arg => arg.startsWith('--remote-control')));
+  assert.deepEqual(terminal.record.remote_control, { wanted: false, state: null });
+  assert.equal(publicClaudeAutoHandoff(terminal.record).remote_control_state, null);
+}));
+
+test('worker: リモートコントロールを付けると立てられない時は、付けずに立て直す。引き継ぎは止めない', () => withDir(async dir => {
+  const sessionId = 'cccccccc-0000-4000-8000-000000000001';
+  const transcriptPath = join(dir, `${sessionId}.jsonl`);
+  writeFileSync(transcriptPath, jsonl([{ ...user('読んで', '2026-10-10T05:00:10Z'), entrypoint: 'claude-desktop' }, assistant('読みました。', '2026-10-10T05:00:12Z')]));
+  const db = makeBatonDb();
+  requestClaudeAutoHandoff({ payload: { session_id: sessionId, trigger: 'auto', cwd: '/work/app', transcript_path: transcriptPath },
+    env: {}, config: ENABLED, openDb: () => db, dir, platform: 'darwin' });
+  await stopClaudeTurnForHandoff({ payload: { session_id: sessionId, cwd: '/work/app', transcript_path: transcriptPath }, dir, launchWorker: async () => {} });
+  const launches = [];
+  const record = await runClaudeAutoHandoffWorker(sessionId, { dir, env: {}, pollMs: 10, acceptTimeoutMs: 300, transcriptTimeoutMs: 50,
+    spawn: (command, args) => {
+      launches.push(args.some(arg => arg.startsWith('--remote-control')));
+      if (launches.length === 1) return { status: 1, stdout: '', stderr: 'Remote Control requires a claude.ai login' };
+      successorStarts(dir, sessionId)(args); return launchedOk();
+    } });
+  assert.deepEqual(launches, [true, false], '1回目は付けて、2回目は付けずに立てる');
+  assert.equal(record.state, 'sent'); assert.equal(record.error_code, null);
+  assert.deepEqual(record.remote_control, { wanted: true, state: 'unavailable' });
+  assert.equal(publicClaudeAutoHandoff(record).remote_control_state, 'unavailable');
+  assert.equal(publicClaudeAutoHandoff(record).desktop_state, 'waiting', 'Desktop へ開く印は変わらない');
 }));
 
 test('Stop: Desktop で開く引き継ぎの後継がターンを終えたら、移す process を1回だけ起動する', () => withDir(async dir => {

package/src/cli/doctor.mjs

@@ -1014,7 +1014,7 @@ export async function run(argv = []) {
   await check('throughline コマンドが PATH で見つかるか', () => {
     try {
       const which = process.platform === 'win32' ? 'where throughline' : 'which throughline';
-      const result = execSync(which, { encoding: 'utf8', stdio: ['pipe', 'pipe', 'pipe'] }).trim();
+      const result = execSync(which, { encoding: 'utf8', stdio: ['pipe', 'pipe', 'pipe'], windowsHide: true }).trim();
       return result.split(/\r?\n/)[0];
     } catch {
       throw new Error('見つからない — npm install -g throughline を実行してください');

package/src/codex-app-server.mjs

@@ -1649,6 +1649,7 @@ function startAppServerClient({ command, args, cwd, timeoutMs, requestTimeoutMs
   const child = spawn(command, args, {
     cwd,
     stdio: ['pipe', 'pipe', 'pipe'],
+    windowsHide: true,
   });
   let stdoutBuffer = '';
   let stderr = '';

package/src/os/open-url.mjs

@@ -11,6 +11,7 @@ export function openUrlWithOsHandler(url, {
   spawnImpl = spawnSync,
 } = {}) {
   if (platform === 'darwin') return spawnImpl('open', [url], { encoding: 'utf8' });
-  if (platform === 'win32') return spawnImpl('cmd.exe', ['/c', 'start', '', url], { encoding: 'utf8' });
+  // cmd.exe 自身の窓は隠す（console を持たない worker から呼ぶと、窓が一瞬出る）。start が開く先の窓は、これでは隠れない。
+  if (platform === 'win32') return spawnImpl('cmd.exe', ['/c', 'start', '', url], { encoding: 'utf8', windowsHide: true });
   return spawnImpl('xdg-open', [url], { encoding: 'utf8' });
 }

package/src/os/open-url.test.mjs

@@ -0,0 +1,14 @@
+import test from 'node:test';
+import assert from 'node:assert/strict';
+import { openUrlWithOsHandler } from './open-url.mjs';
+
+test('openUrlWithOsHandler: OS ごとの命令で開き、Windows では cmd.exe の窓を隠す', () => {
+  const calls = [];
+  const spawnImpl = (command, args, options) => { calls.push({ command, args, options }); return { status: 0 }; };
+  openUrlWithOsHandler('codex://threads/abc', { platform: 'win32', spawnImpl });
+  openUrlWithOsHandler('codex://threads/abc', { platform: 'darwin', spawnImpl });
+  openUrlWithOsHandler('codex://threads/abc', { platform: 'linux', spawnImpl });
+  assert.deepEqual(calls[0], { command: 'cmd.exe', args: ['/c', 'start', '', 'codex://threads/abc'], options: { encoding: 'utf8', windowsHide: true } });
+  assert.deepEqual([calls[1].command, calls[1].args], ['open', ['codex://threads/abc']]);
+  assert.deepEqual([calls[2].command, calls[2].args], ['xdg-open', ['codex://threads/abc']]);
+});

package/src/os/portable-spawn-sync.mjs

@@ -28,11 +28,15 @@ function resolveWindowsCommand(command, env) {
   return command;
 }
 
-function portableInvocation(command, args, options = {}) {
+export function portableInvocation(command, args, options = {}) {
   const platform = options.platform ?? process.platform;
   const spawnOptions = { ...options };
   delete spawnOptions.platform;
   spawnOptions.shell = false;
+  // Windows では、console を持たない process（切り離した worker など）が console の子を起こすと、新しい console が作られ、
+  // 既定のターミナル（Windows Terminal）の窓が一瞬出る。出力は pipe で受けるので、窓は要らない。
+  // 窓が要る呼び出し（端末が要る命令）は os/pty-run.mjs が別に持つ。ほかの OS では無視される。
+  spawnOptions.windowsHide ??= true;
 
   if (platform !== 'win32') return [command, args, spawnOptions];
 

package/src/os/portable-spawn-sync.test.mjs

@@ -3,7 +3,7 @@ import assert from 'node:assert/strict';
 import { mkdtempSync, rmSync, writeFileSync } from 'node:fs';
 import { tmpdir } from 'node:os';
 import { join } from 'node:path';
-import { spawnPortable, spawnPortableSync } from './portable-spawn-sync.mjs';
+import { portableInvocation, spawnPortable, spawnPortableSync } from './portable-spawn-sync.mjs';
 import { createInterface } from 'node:readline';
 import { once } from 'node:events';
 
@@ -88,3 +88,24 @@ exit $LASTEXITCODE
     rmSync(dir, { recursive: true, force: true });
   }
 });
+
+test('portableInvocation: 窓を隠す指定を既定で付ける。呼び出し側が false を渡した時だけ外す', () => {
+  for (const platform of ['win32', 'linux', 'darwin']) {
+    const [, , hidden] = portableInvocation('claude', ['agents', '--json', '--all'], { platform, env: { PATH: '' }, encoding: 'utf8' });
+    assert.equal(hidden.windowsHide, true, platform);
+    assert.equal(hidden.shell, false); assert.equal(hidden.encoding, 'utf8'); assert.equal('platform' in hidden, false);
+    const [, , shown] = portableInvocation('claude', ['agents'], { platform, env: { PATH: '' }, windowsHide: false });
+    assert.equal(shown.windowsHide, false, platform);
+  }
+});
+
+test('portableInvocation: Windows の .ps1 shim は pwsh.exe 経由で、窓を隠して起こす', () => {
+  const dir = mkdtempSync(join(tmpdir(), 'tl-portable-hide-'));
+  try {
+    writeFileSync(join(dir, 'claude.ps1'), 'exit 0\n');
+    const [command, args, options] = portableInvocation('claude', ['stop', 'abcd1234'], { platform: 'win32', env: { PATH: dir } });
+    assert.equal(command, 'pwsh.exe');
+    assert.ok(args.at(-1).includes(join(dir, 'claude.ps1')) && args.at(-1).includes("'stop' 'abcd1234'"));
+    assert.equal(options.windowsHide, true);
+  } finally { rmSync(dir, { recursive: true, force: true }); }
+});