clauderipple 0.9.5 → 0.11.0

package/CHANGELOG.md

@@ -1,5 +1,123 @@
 # Changelog
 
+## 0.11.0 — 2026-10-20
+
+### Added
+
+- **Close the laptop, Claude keeps working.** For sessions driven from a phone, the laptop now
+  stays awake with the lid shut while a model call runs and for 10 minutes after (or until a time
+  you set), and lets go under a 20% battery floor or, on macOS, a thermal warning, putting a closed
+  laptop to sleep when it does. macOS needs one setup: macOS's own password dialog installs a
+  sudoers rule for exactly the commands used, and Insomnia is cleaned up. Windows needs no
+  administrator rights: a router child holds `SetThreadExecutionState` and sets the lid action
+  only while held, restoring yours afterwards. Off until turned on in the dashboard's Laptop view.
+- **Wi-Fi without internet fails over to the phone hotspot, and comes back.** The router probes the
+  internet through the Wi-Fi interface (a dead uplink or a captive portal still reads "connected"
+  to the OS), joins the hotspot you name after 3 of 5 failed rounds, and tries the way back to a
+  known Wi-Fi 5, 10, 20, 30, 40, 50 and 60 minutes after landing, then every 10 minutes. iPhone and
+  Android hotspots both work: an Android hotspot's subnet is learned from the router's own join.
+  When calls never stop, the switch holds new model calls for a moment instead of waiting forever;
+  nothing is refused.
+- **The app's window is the dashboard, and it opens with the router down.** It draws its own copy
+  of the dashboard, so a broken router no longer takes the only screen with it; the Status view
+  offers repair and a switch to Claude's own connection. `clauderipple doctor`, `repair` and
+  `direct on|off` do the same from a terminal. Opening the app from its icon shows the window.
+- **The app and its tray wear 리플이,** and the Dock shows that icon instead of Electron's.
+
+### Changed
+
+- **Gemini 3.8 Flash's high effort uses the medium tier.** `-high` thinks without a budget, and
+  on a normal day the requests past medium's 4,000 tokens took 64% of all request time.
+- **Every model goes to the Antigravity host that offers it** (Gemini 3.1 Pro is on prod only),
+  and the limits row reads the quota of the host the requests spend.
+- **Korean reads as everyday Korean** across the dashboard, the mod and the menu-bar app, and the
+  power screens name no device brand: laptop and phone, with iPhone and Android steps side by side.
+- **An agent's conversation shows whole,** with no "earlier" to press, and a back button floats at
+  the top once you scroll down. Narrow agent cards give the elapsed time no row of its own and cut
+  titles at two lines; the band and log drop a hosted model's vendor path.
+
+### Fixed
+
+- **A Mac offline no longer restarts the router in a loop.** The health self-exit, meant for a
+  wedged process, fired 27 times in 18 minutes on a commute and kept the hotspot failover from ever
+  counting its failures; it now asks a fresh process first and stays up when the machine is offline.
+- **Google's "no capacity" no longer rests the account.** A 503 `MODEL_CAPACITY_EXHAUSTED` is retried
+  twice, slowly, then handed to the route fallback or answered 529 overloaded; other turns are not
+  refused with "all accounts resting".
+- **Ripple Remote keeps sending when the `claude` CLI's login lapses.** The phone host borrowed the
+  CLI's keychain login, which only the CLI refreshes; it now falls back to the login the Claude app
+  is using.
+- **Gemini's quota is read from the host the requests spend it on,** a window past its reset reads
+  0% instead of vanishing, and Gemini's Claude-and-GPT windows show only when such a model runs
+  through it.
+
+## 0.10.0 — 2026-10-20
+
+### Added
+
+- **Code tab sessions on an SSH host route through Ripple.** Claude Code on a remote host went
+  straight to Anthropic and could not find the GPT workers, because Claude Desktop opens that
+  connection itself and never reads `RemoteForward` (#67). `clauderipple remote add <host>` copies
+  the CA and the generated agent files over plain `sh`, points the host's `settings.json` at a
+  router-held reverse tunnel on `127.0.0.1:18791`, re-syncs the agents whenever they change, and
+  `remote hosts` / `remote remove` manage them. It needs key-based `ssh` with no password prompt;
+  the mod is not on the remote host yet.
+- **The logs page shows token usage for any period, and every provider.** The chips covered only
+  the last hour. A period control (1 hour, today, 7 days, 30 days, this month, all time, custom
+  dates) now reads an hourly history that survives restarts, a per-model table shows where the
+  tokens went, and the provider menu lists every configured provider instead of only the ones in
+  the last 200 requests, filtering the chips, the table and the recent requests together. A figure
+  too wide for a narrow pane or a 1,024px window steps its type down instead of being cut.
+- **The band's limits row shows every provider.** Claude, ChatGPT, Antigravity (Gemini), OpenCode
+  Go and a Grok subscription each draw a group in their provider's colour, from one
+  `/api/limits` read; before, only Claude and ChatGPT did. At about 100 columns four providers
+  took roughly 207 cells as gauges against 96, so the row picks the roomiest of three densities
+  and gives up later groups only when none fits. Each provider can be kept off the status bar.
+- **The Agents pane gives each agent a card.** The pane showed "no agents running · 2 done" over
+  an empty panel. Each card now holds the state, title, the model that answered and the effort it
+  was sent at, the API's real token counts with cache share, the tool count, and the elapsed time,
+  and keeps its size steady while the agent runs. Opening a card shows its conversation in the
+  pane, with a run of tool calls collapsed into one summary line ("3 files read, 1 command run"),
+  as the Claude app draws it.
+- **The dashboard's Phone view pairs Ripple Remote and manages the connection.** Pairing used to
+  mean running `npm run remote -- pair` in a source checkout. The view now shows the host's state,
+  a pairing QR on request, the mode, the phones seen and a key rotation, answered on a
+  loopback-only `/local` API with a secret from a `0600` file. The published CLI and dashboard now
+  install the phone host, which runs under Windows and Linux user supervisors as well as launchd.
+- **Ripple Remote tells you which session finished and what it did.** Notifications carried one
+  fixed line for every session; the host now sends the title and the last answer, approval request
+  or failure reason inside an encrypted blob, leaving Expo, APNs and FCM with only the fallback
+  text. Mac sessions push when a turn ends while the Mac is away, Claude app sessions send and
+  receive photos, a subagent shows its model and opens its own chat, and thinking no longer
+  splits a run (one real session went from 1,442 rows to 549).
+- **The desktop has two skins, deep and flat.** A `skin` setting picks them on the quick settings
+  panel and the dashboard's Look card; deep stays the default. Flat follows the app's own surface
+  and quiet text colour, keeps one accent, and the band's labels, counts and controls carry the
+  right colour.
+
+### Fixed
+
+- **Google and Antigravity prompt refusals are retried instead of failing the turn.** A refusal is
+  now returned unwritten and retried once along a configured fallback route with the original
+  request, and an Antigravity 429 is called a real limit only when fresh account and project quota
+  evidence says so.
+- **Parallel tool results with images stay together on the OpenAI-compatible wire.** Three image
+  Reads used to interleave `tool|user|tool|user`, and DeepSeek refused them
+  ("insufficient tool messages following tool_calls", #64). Images now wait until the run of tool
+  results ends.
+- **A slow reasoning model passes the connection check.** Hive answers a streamed request in 0.3
+  seconds but a whole one in 3–23, past the 8-second probe, so a working key read as "could not
+  connect"; the check now streams and drops the body once the status is in.
+- **A provider named in Hangul is named after its domain.** "하이브" slugged to nothing and showed
+  as "provider"; it now falls back to the URL's domain ("thehive").
+- **A failed restart no longer ends the Windows supervisor loop.** One `Start-Process` error, such
+  as a locked log file, stopped the script and left the router and host unsupervised until logon.
+- **A dark-mode select's options are readable.** Native options and optgroups now get opaque,
+  theme-aware backgrounds.
+- **Slash commands stay available when settings fail to load.** A throw while loading settings
+  took `/ripple`, `/ripple-log` and `/ripple-bar` with it (#62); the settings step now has its own
+  catch, so the commands register either way.
+
 ## 0.9.5 — 2026-10-14
 
 ### Fixed

package/README.es.md

@@ -321,6 +321,13 @@ los modelos que asignas van a tu proveedor, y todo lo demás va a Anthropic byte
   imágenes de referencia y fondos transparentes. A los subagentes se les explica cómo
   hacerlo, así que un worker de GPT o DeepSeek puede crear una imagen y verla sin una
   herramienta de imágenes.
+- **Cierra el portátil y Claude sigue trabajando.** En macOS y Windows el portátil se
+  mantiene despierto con la tapa cerrada mientras Claude trabaja (y 10 minutos después),
+  así que una tarea que lanzaste desde el teléfono llega al final. Si el Wi-Fi se queda sin
+  internet, pasa al punto de acceso de tu teléfono (iPhone o Android) y más tarde vuelve a
+  un Wi-Fi conocido. Viene desactivado hasta que lo actives en la vista Portátil del panel;
+  consulta [Tapa cerrada y el punto de acceso del
+  teléfono](#tapa-cerrada-y-el-punto-de-acceso-del-teléfono).
 - **Workers ligeros, si los quieres.** Un solo interruptor da a los subagentes generados
   solo las herramientas que usa un worker, en lugar de todos los servidores MCP y plugins
   de la sesión: la primera solicitud de un worker bajó de 33k a 9k tokens.
@@ -546,6 +553,44 @@ compatible con Anthropic que hayas configurado está disponible de la misma form
   <img src="docs/media/add-provider.png" width="880" alt="Añadir proveedor: suscripción de ChatGPT, ajustes predefinidos, proveedores compatibles con OpenAI">
 </p>
 
+## Tapa cerrada y el punto de acceso del teléfono
+
+Para las sesiones que llevas desde el teléfono (Remote Control, Ripple Remote): el portátil
+sigue trabajando dentro de una mochila. Abre la vista **Portátil** del panel.
+
+**Seguir despierto con la tapa cerrada.** Hay tres modos: *No*; *Mientras trabaja* —
+despierto mientras corre una llamada al modelo y durante 10 minutos después de la última;
+*Siempre* — hasta que lo apagues o llegue una hora que fijes. Deja de mantenerse despierto
+por sí solo cuando la batería baja del 20 % o (en macOS) el Mac avisa de un problema térmico,
+y entonces pone en reposo un portátil con la tapa cerrada. Mientras está despierto, no lo
+lleves mucho tiempo en una mochila cerrada.
+
+- macOS: pulsa **Configurar** una vez. El propio cuadro de contraseña de macOS instala una
+  regla de sudoers para exactamente los comandos que se usan (`pmset disablesleep`,
+  `pmset sleepnow`, conectarse al punto de acceso que indicas); ClaudeRipple nunca ve la
+  contraseña. `clauderipple awake setup --remove` la quita. Si Insomnia está instalado, la
+  configuración lo elimina (hace el mismo trabajo).
+- Windows: no hacen falta permisos de administrador. Un proceso hijo del router mantiene
+  `SetThreadExecutionState`, y la acción de la tapa se pone en «no hacer nada» solo mientras
+  lo mantiene; tus propios ajustes de energía vuelven después, también si el router muere.
+
+**Wi-Fi sin internet → punto de acceso del teléfono.** Comprueba internet a través de la
+interfaz Wi-Fi (un router con el enlace caído o un portal cautivo sigue pareciendo
+«conectado» al sistema) y se une al punto de acceso que indicas cuando fallan 3 de 5
+intentos. En el punto de acceso prueba la vuelta a los 5, 10, 20, 30, 40, 50 y 60 minutos de
+llegar, y luego cada 10 minutos: sale del punto de acceso para que el sistema se una al mejor
+Wi-Fi conocido que haya en el alcance, y se queda solo si ese Wi-Fi tiene internet. Una
+llamada al modelo que empieza durante el cambio espera un momento en lugar de fallar.
+
+- Conéctate una vez a mano al punto de acceso del teléfono desde el portátil, para que el
+  sistema guarde su contraseña.
+- iPhone: mantén activado Ajustes › Punto de acceso personal ›
+  «Permitir a otros conectarse». En un Mac, la misma cuenta de Apple y el Bluetooth
+  activado ayudan a encontrar el teléfono.
+- Android: un punto de acceso inactivo se apaga solo al cabo de un rato; vuelve a encenderlo
+  si no aparece.
+- Linux: aún no es compatible.
+
 ## Proveedores
 
 | Proveedor | Tipo | Autenticación | Lista de modelos | Notas |

package/README.ja.md

@@ -173,6 +173,7 @@ Claude Codeのシステムプロンプトとツールの説明はClaude向けに
 - **サブエージェントの名前タグ**。バックグラウンドタスクパネルに、汎用の「Agent」ではなく`Terra·high · Review`のように表示されます。
 - **プロンプトの上のrippleモッド**。帯1本に推論強度、コンテキスト、キャッシュタイマー、直前のリクエストに実際に応答したモデルとキャッシュヒット率を表示します。小さな判定モデル（Haiku 5.5またはJev）がプロンプトごとに直近の会話と合わせて読み、lowからmaxまで推論強度を決めます。任せた作業は`ripple:auto`に渡り、判定モデルが難しさに応じてワーカーを選びます。軽い作業はDeepSeekやGLM、難しい作業はGPTやOpusへ。キャッシュが冷えたとき、コンテキストが重くなったとき、プランの上限が80%を超えたときにカードで知らせ、圧縮か、同じフォルダの新しいセッションへの引き継ぎを提案します。`Log`（または`/ripple-log`）でリクエストログをサイドペインに開きます。「クライアント」画面のスイッチ1つ、または`clauderipple mod on`で有効にできます。
 - **ChatGPTのサブスクリプションで画像を生成**。`clauderipple image "<prompt>"`で、参照画像や透明背景にも対応します。サブエージェントにもやり方が伝えられているので、GPTやDeepSeekのワーカーでも、画像ツールなしで画像を作って確認できます。
+- **ノートPCのふたを閉じても、Claudeは作業を続けます**。macOSとWindowsでは、Claudeが作業している間（終わってから10分間も）ふたを閉じたままでもノートPCがスリープしないので、スマホから頼んだ作業が最後まで進みます。Wi-Fiがインターネットにつながらなくなると、スマホのインターネット共有（iPhoneまたはAndroid）に切り替え、あとで登録済みのWi-Fiに戻ります。ダッシュボードの「ノートPC の管理」画面でオンにするまでは無効です。[ふたを閉じたときとスマートフォンのインターネット共有](#ふたを閉じたときとスマートフォンのインターネット共有)を参照してください。
 - **必要なら軽量なワーカーを**。スイッチ1つで、生成されるサブエージェントに、セッションのすべてのMCPサーバーとプラグインではなく、ワーカーが使うツールだけを渡します。あるワーカーの最初のリクエストは33kトークンから9kトークンに減りました。
 - **ターミナルを使いたくない人のために**。ワンクリックの接続テストとモデル検出付きのプロバイダープリセット、ドロップダウンによるモデルマッピング、自動保存、韓国語と英語のUI。独自のランタイムを同梱し、初回起動時に自らセットアップするメニューバーアプリ。署名・公証済みです。
 
@@ -315,6 +316,22 @@ ClaudeのモデルはCodexのモデル一覧にそれぞれの名前で表示さ
   <img src="docs/media/add-provider.png" width="880" alt="プロバイダーの追加：ChatGPTサブスクリプション、プリセット、OpenAI互換プロバイダー">
 </p>
 
+## ふたを閉じたときとスマートフォンのインターネット共有
+
+スマホから進めるセッション（Remote Control、Ripple Remote）のための機能です。ノートPCをかばんに入れたままでも作業が続きます。ダッシュボードの**ノートPC の管理**画面でオンにします。
+
+**ふたを閉じてもスリープしない。** モードは3つです。*オフ*、*作業中のみ*（モデルの呼び出しが動いている間と、最後の呼び出しから10分間）、*常にオン*（オフにするか、決めた時刻になるまで）。バッテリーが20%を下回るか、（macOSでは）Macが熱の警告を出すと、自動でスリープ防止をやめ、ふたが閉じていればノートPCをスリープさせます。スリープしない間は、密閉したかばんに長く入れたままにしないでください。
+
+- macOS：**設定する**を一度押します。macOS自身のパスワード画面が、使うコマンド（`pmset disablesleep`、`pmset sleepnow`、指定したインターネット共有への接続）だけを許可するsudoersルールをインストールし、ClaudeRippleがパスワードを見ることはありません。`clauderipple awake setup --remove`で削除できます。Insomniaが入っている場合は同じ役割なので、設定時に片付けます。
+- Windows：管理者権限は不要です。ルーターの子プロセスが`SetThreadExecutionState`を保持し、保持している間だけふたの動作を「何もしない」にします。元の電源設定は、ルーターが落ちた場合も含めて後で戻ります。
+
+**インターネットにつながらないWi-Fi → スマホのインターネット共有。** Wi-Fiインターフェース経由で実際にインターネットを確かめ（上流が切れたルーターや、ログインページが出るWi-Fiも、OSには「接続済み」に見えるためです）、5回中3回失敗すると指定したインターネット共有に接続します。共有に接続してから5、10、20、30、40、50、60分後に戻り先を試し、その後は10分ごとに試します。共有からいったん離れてOSに範囲内で一番良い登録済みWi-Fiへ接続させ、そのWi-Fiでインターネットが使えるときだけとどまります。切り替えの瞬間に始まったモデルの呼び出しは、失敗せずに少し待ちます。
+
+- ノートPCから一度、手動でスマホのインターネット共有に接続しておいてください。OSがパスワードを覚えます。
+- iPhone：設定 › インターネット共有 ›「ほかの人の接続を許可」をオンにしておいてください。Macの場合は、同じAppleアカウントとBluetoothがオンだと見つけやすくなります。
+- Android：誰も接続していないと、共有はしばらくして自動で切れます。見つからないときは、もう一度オンにしてください。
+- Linux：まだ対応していません。
+
 ## プロバイダー
 
 | プロバイダー | 種類 | 認証 | モデル一覧 | 備考 |

package/README.ko.md

@@ -257,6 +257,10 @@ ClaudeRipple은 Claude Code 프로세스만 신뢰하는 작은 HTTPS 프록시
   클라이언트 화면의 스위치 하나, 또는 `clauderipple mod on`.
 - **ChatGPT 구독으로 이미지 생성.** `clauderipple image "<프롬프트>"`. 참고 이미지와 투명 배경도 됩니다. 서브에이전트에도
   방법이 적혀 있어, GPT나 DeepSeek 워커가 이미지 도구 없이 이미지를 만들고 직접 확인합니다.
+- **노트북을 덮어도 Claude는 계속 일합니다.** macOS와 Windows에서 Claude가 일하는 동안(끝난 뒤 10분까지)
+  덮개를 닫아도 노트북이 잠들지 않아, 휴대폰으로 맡긴 일이 끝까지 갑니다. 와이파이에서 인터넷이 끊기면 휴대폰
+  핫스팟(아이폰·안드로이드)으로 옮겼다가 나중에 아는 와이파이로 돌아옵니다. 대시보드의 노트북 관리 화면에서
+  켜기 전까지는 꺼져 있습니다. [노트북 덮개와 휴대폰 핫스팟](#노트북-덮개와-휴대폰-핫스팟)을 보세요.
 - **원하면 가벼운 워커.** 스위치 하나로, 생성된 서브에이전트에 세션의 MCP·플러그인 도구 전부 대신 워커가 쓰는 도구만
   줍니다. 워커 첫 요청이 3.3만에서 0.9만 토큰으로 줄었습니다.
 - **터미널이 싫은 사람을 위해.** 원클릭 연결 확인과 모델 자동 검색이 붙은 프로바이더 프리셋, 드롭다운 모델 매핑, 자동 저장,
@@ -443,6 +447,33 @@ Anthropic API 키로 갑니다. 구독 로그인 재사용은 Anthropic 약관
   <img src="docs/media/add-provider.png" width="880" alt="프로바이더 추가: ChatGPT 구독, 프리셋, OpenAI 호환 프로바이더">
 </p>
 
+## 노트북 덮개와 휴대폰 핫스팟
+
+휴대폰으로 돌리는 세션(Remote Control, Ripple Remote)을 위한 기능입니다. 노트북을 가방에 넣어도 일이 이어집니다.
+대시보드의 **노트북 관리** 화면에서 켭니다.
+
+**덮개를 닫아도 잠들지 않게.** 모드는 셋입니다. *끔*, *일할 때만*(모델 요청이 도는 동안과 마지막 요청 뒤 10분),
+*계속 켜 두기*(끄거나 정한 시각까지). 배터리가 20% 아래로 내려가거나 (macOS에서) 맥이 과열 경고를 내면 스스로
+멈추고, 덮개가 닫혀 있으면 노트북을 재웁니다. 깨어 있는 동안 막힌 가방에 오래 넣어 두지는 마세요.
+
+- macOS: **설정하기**를 한 번 누릅니다. macOS 자체 암호 창이 쓰는 명령(`pmset disablesleep`, `pmset sleepnow`,
+  정해 둔 핫스팟 접속)만 허용하는 sudoers 규칙을 설치하며, ClaudeRipple은 암호를 보지 않습니다.
+  `clauderipple awake setup --remove`로 지웁니다. Insomnia가 깔려 있으면 같은 일을 하므로 설정할 때 정리합니다.
+- Windows: 관리자 권한이 필요 없습니다. 라우터의 자식 프로세스가 `SetThreadExecutionState`를 잡고, 그동안만
+  덮개 동작을 "아무것도 안 함"으로 둡니다. 원래 전원 설정은 라우터가 죽어도 되돌아옵니다.
+
+**인터넷 안 되는 와이파이 → 휴대폰 핫스팟.** 와이파이 인터페이스로 실제 인터넷을 확인합니다(업링크가 죽은 공유기나
+로그인 페이지가 뜨는 와이파이도 OS에는 "연결됨"으로 보이기 때문입니다). 5번 중 3번 실패하면 정해 둔 핫스팟에
+붙습니다. 핫스팟에 붙은 뒤 5·10·20·30·40·50·60분에, 그다음엔 10분마다 돌아가기를 시도합니다. 핫스팟에서 잠깐
+나와 OS가 범위 안의 아는 와이파이에 붙게 하고, 그 와이파이에서 인터넷이 될 때만 머뭅니다. 전환하는 순간
+시작된 모델 요청은 실패하지 않고 잠깐 기다립니다.
+
+- 노트북에서 휴대폰 핫스팟에 한 번 직접 접속해 두세요. 그래야 OS가 암호를 기억합니다.
+- 아이폰: 설정 › 개인용 핫스팟 › '다른 사람의 연결 허용'을 켜 두세요. 맥이라면 같은 Apple 계정과 블루투스가
+  있으면 더 잘 찾습니다.
+- 안드로이드: 아무도 안 붙어 있으면 핫스팟이 잠시 뒤 스스로 꺼집니다. 못 찾으면 다시 켜 주세요.
+- Linux: 아직 지원하지 않습니다.
+
 ## 프로바이더
 
 | 프로바이더 | 종류 | 인증 | 모델 목록 | 비고 |

package/README.md

@@ -310,6 +310,11 @@ you map go to your provider, everything else goes to Anthropic byte for byte.
 - **Images from your ChatGPT subscription.** `clauderipple image "<prompt>"`, with
   reference images and transparent backgrounds. Subagents are told how, so a GPT or
   DeepSeek worker can make an image and look at it without an image tool.
+- **Close the laptop, Claude keeps working.** On macOS and Windows the laptop stays awake
+  with the lid shut while Claude works (and 10 minutes after), so a task you started from
+  your phone finishes. If the Wi-Fi loses its internet, it moves to your phone's hotspot
+  (iPhone or Android) and back to a known Wi-Fi later. Off until you turn it on in the
+  dashboard's Laptop view; see [Lid closed and the phone hotspot](#lid-closed-and-the-phone-hotspot).
 - **Lean workers, if you want them.** One switch gives generated subagents only the
   tools a worker uses instead of every MCP server and plugin of the session: one
   worker's first request fell from 33k to 9k tokens.
@@ -495,6 +500,71 @@ same ChatGPT provider as the search backend in `config.json`:
 This is opt-in. With no `webSearch` setting, Claude Code's existing search path
 is unchanged.
 
+### Remote (SSH) sessions
+
+Claude Desktop's Code tab can run a session on a remote Linux host over SSH.
+Claude Code then runs **on that host**, where ClaudeRipple is not, so routed
+models are unknown there (`Agent type 'gpt-6-1-sol' not found`). Connect the
+host once from the machine ClaudeRipple runs on:
+
+```bash
+clauderipple remote add my-server            # an ssh alias or user@host; --port N (default 18791)
+clauderipple remote hosts                    # tunnel state per host (also in `remote status`)
+clauderipple remote remove my-server         # undo it
+```
+
+`remote add` needs key-based `ssh my-server` to work without a password prompt.
+It copies the router's CA certificate (the public certificate only) to
+`~/.clauderipple-remote/` on the host, points the host's
+`~/.claude/settings.json` at the tunnel (`HTTPS_PROXY=http://127.0.0.1:18791`,
+`NODE_EXTRA_CA_CERTS`; the original is kept as
+`settings.json.clauderipple-backup`; a different proxy already there is refused
+without `--force`), and copies the generated agent files. The router then keeps
+a reverse SSH tunnel open from the host's `127.0.0.1:18791` to itself, restarts
+it when it drops, and copies the agent files again whenever they change. The
+host needs only `sh` — no Node and no ClaudeRipple.
+
+While the tunnel is down, Claude Code on the host gets *connection refused*
+rather than going to Anthropic around the router. The remote session only exists
+while this machine's Claude Desktop is connected to it anyway. The tunnel
+listens on the host's loopback only, but on a shared host every user there can
+reach that port, and through it your router. The status mod and image
+generation are not available on remote hosts yet.
+
+## Lid closed and the phone hotspot
+
+For sessions you drive from your phone (Remote Control, Ripple Remote): the laptop
+keeps working in a bag. Open the dashboard's **Laptop** view.
+
+**Stay awake with the lid closed.** Three modes: *Off*; *While working* — awake while a
+model call runs and for 10 minutes after the last one; *Always* — until you turn it off
+or a time you set. It lets go by itself when the battery drops below 20% or (on macOS) the
+Mac reports a thermal warning, and puts a closed laptop to sleep when it does. Don't carry
+it in a closed bag for long while it is awake.
+
+- macOS: press **Set up** once. macOS's own password dialog installs a sudoers rule for
+  exactly the commands used (`pmset disablesleep`, `pmset sleepnow`, joining the hotspot
+  you name); ClaudeRipple never sees the password. `clauderipple awake setup --remove`
+  takes it out. If Insomnia is installed, setup removes it (it does the same job).
+- Windows: no administrator rights. A child of the router holds
+  `SetThreadExecutionState`, and the lid action is set to "do nothing" only while it is
+  held; your own power settings come back afterwards, also if the router dies.
+
+**Wi-Fi without internet → phone hotspot.** It probes the internet through the Wi-Fi
+interface (a router with a dead uplink or a captive portal still looks "connected" to
+the OS) and joins the hotspot you name after 3 of 5 rounds fail. On the hotspot it tries
+the way back 5, 10, 20, 30, 40, 50 and 60 minutes after landing, then every 10 minutes:
+it leaves the hotspot so the OS joins the best known Wi-Fi in range, and stays there only
+if that Wi-Fi has internet. A model call that starts during the switch waits a moment
+instead of failing.
+
+- Join the phone's hotspot from the laptop once by hand, so the OS keeps its password.
+- iPhone: keep Settings › Personal Hotspot › "Allow Others to Join" on. On a Mac, the
+  same Apple Account and Bluetooth on help it find the phone.
+- Android: an idle hotspot turns itself off after a while; turn it on again if it is
+  not found.
+- Linux: not supported yet.
+
 ### Codex app and Codex CLI
 
 ```bash

package/README.pt-BR.md

@@ -316,6 +316,13 @@ que você mapeia vão para o seu provedor, e todo o resto vai para a Anthropic b
   de referência e fundos transparentes. Os subagentes recebem instruções de como fazer,
   então um worker GPT ou DeepSeek consegue criar uma imagem e olhar para ela sem uma
   ferramenta de imagem.
+- **Feche o notebook e o Claude continua trabalhando.** No macOS e no Windows o notebook
+  fica acordado com a tampa fechada enquanto o Claude trabalha (e por 10 minutos depois),
+  então uma tarefa que você começou pelo celular chega ao fim. Se o Wi-Fi ficar sem
+  internet, ele passa para o Acesso Pessoal do celular (iPhone ou Android) e mais tarde
+  volta para um Wi-Fi conhecido. Vem desligado até você ativá-lo na tela **Notebook** do
+  painel; veja [Tampa fechada e o Acesso Pessoal do
+  celular](#tampa-fechada-e-o-acesso-pessoal-do-celular).
 - **Workers enxutos, se você quiser.** Um único botão faz com que os subagentes gerados
   recebam só as ferramentas que um worker usa, em vez de todos os servidores MCP e plugins
   da sessão: a primeira requisição de um worker caiu de 33k para 9k tokens.
@@ -533,6 +540,44 @@ que você tenha configurado fica disponível da mesma forma.
   <img src="docs/media/add-provider.png" width="880" alt="Adicionar provedor: assinatura do ChatGPT, presets, provedores compatíveis com OpenAI">
 </p>
 
+## Tampa fechada e o Acesso Pessoal do celular
+
+Para as sessões que você conduz pelo celular (Remote Control, Ripple Remote): o notebook
+continua trabalhando dentro de uma mochila. Abra a tela **Notebook** do painel.
+
+**Continuar acordado com a tampa fechada.** São três modos: *Não*; *Enquanto trabalha* —
+acordado enquanto uma chamada ao modelo roda e por 10 minutos depois da última; *Sempre* —
+até você desligar ou chegar um horário que você definir. Ele se solta sozinho quando a
+bateria cai abaixo de 20% ou (no macOS) o Mac avisa de um problema térmico, e põe um
+notebook de tampa fechada em repouso. Enquanto estiver acordado, não o carregue por muito
+tempo numa mochila fechada.
+
+- macOS: clique em **Configurar** uma vez. A própria janela de senha do macOS instala uma
+  regra de sudoers para exatamente os comandos usados (`pmset disablesleep`,
+  `pmset sleepnow`, entrar no Acesso Pessoal que você indicar); o ClaudeRipple nunca vê a
+  senha. `clauderipple awake setup --remove` a remove. Se o Insomnia estiver instalado, a
+  configuração o remove (ele faz o mesmo trabalho).
+- Windows: não precisa de permissões de administrador. Um processo filho do roteador mantém
+  `SetThreadExecutionState`, e a ação da tampa fica em "não fazer nada" só enquanto ele a
+  mantém; suas próprias configurações de energia voltam depois, também se o roteador
+  morrer.
+
+**Wi-Fi sem internet → Acesso Pessoal do celular.** Ele testa a internet pela interface
+Wi-Fi (um roteador com o link caído ou um portal cativo ainda parece "conectado" para o
+sistema) e entra no Acesso Pessoal que você indicar quando 3 de 5 tentativas falham. No
+Acesso Pessoal ele tenta a volta 5, 10, 20, 30, 40, 50 e 60 minutos depois de chegar, e
+depois a cada 10 minutos: sai do Acesso Pessoal para o sistema entrar no melhor Wi-Fi
+conhecido ao alcance, e só fica se esse Wi-Fi tiver internet. Uma chamada ao modelo que
+começa durante a troca espera um momento em vez de falhar.
+
+- Conecte-se uma vez à mão ao Acesso Pessoal do celular a partir do notebook, para o sistema
+  guardar a senha.
+- iPhone: mantenha ativado Ajustes › Acesso Pessoal › «Permitir Outros». Num Mac, a mesma
+  Conta Apple e o Bluetooth ligado ajudam a encontrar o celular.
+- Android: um Acesso Pessoal ocioso se desliga sozinho depois de um tempo; ligue-o de novo
+  se ele não aparecer.
+- Linux: ainda não é compatível.
+
 ## Provedores
 
 | Provedor | Tipo | Autenticação | Lista de modelos | Observações |

package/README.zh-CN.md

@@ -174,6 +174,7 @@ Claude Code 的系统提示词和工具描述是为 Claude 编写的，所以其
 - **子代理名称标签。** 后台任务面板显示 `Terra·high · Review`，而不是笼统的“Agent”。
 - **输入框上方的 ripple 模组。** 一条横栏显示推理强度、上下文、缓存计时，以及上一个请求实际由哪个模型作答和缓存命中率。一个小型判定模型（Haiku 5.5 或 Jev）会结合最近的对话阅读每条提示词，在 low 到 max 之间设定推理强度。委派的工作交给 `ripple:auto`，由判定模型按难度挑选 worker：轻活交给 DeepSeek 或 GLM，难活交给 GPT 或 Opus。缓存变冷、上下文变重或套餐额度超过 80% 时会弹出卡片提醒，并提供压缩或交接到同一文件夹的新会话。`Log`（或 `/ripple-log`）会在侧边窗格中打开请求日志。在“客户端”页面上打开一个开关即可启用，或运行 `clauderipple mod on`。
 - **用 ChatGPT 订阅生成图片。** `clauderipple image "<prompt>"`，支持参考图和透明背景。子代理会被告知用法，因此 GPT 或 DeepSeek worker 无需图像工具也能生成图片并查看结果。
+- **合上笔记本，Claude 照样干活。** 在 macOS 和 Windows 上，Claude 工作期间（以及结束后 10 分钟内）笔记本合盖也不睡眠，所以你从手机发起的任务能做完。Wi-Fi 断了网，它会转到手机热点（iPhone 或 Android），之后再回到已知的 Wi-Fi。该功能默认关闭，需要在控制面板的“笔记本管理”中打开；见[合盖与手机热点](#合盖与手机热点)。
 - **按需精简 worker。** 打开一个开关，生成的子代理就只获得 worker 会用到的工具，而不是会话中的所有 MCP 服务器和插件：某个 worker 的首个请求因此从 33k token 降到了 9k token。
 - **为不想碰终端的人而设计。** 供应商预设支持一键连接测试和模型发现，下拉式模型映射，自动保存，韩语和英语界面。菜单栏应用自带运行时，首次启动时自动完成设置。经过签名和公证。
 
@@ -316,6 +317,22 @@ Claude 模型会以各自的名称出现在 Codex 的模型列表中（ClaudeRip
   <img src="docs/media/add-provider.png" width="880" alt="添加供应商：ChatGPT 订阅、预设、OpenAI 兼容供应商">
 </p>
 
+## 合盖与手机热点
+
+这是给用手机远程推进的会话（Remote Control、Ripple Remote）准备的功能：笔记本放进背包也照样工作。在控制面板的 **笔记本管理** 页面打开。
+
+**合盖时保持唤醒。** 共三档：*关闭*、*仅在工作时*（模型请求进行中，以及最后一次请求结束后 10 分钟）、*始终开启*（直到你关闭或到达设定的时间）。电量降到 20% 以下，或（在 macOS 上）Mac 报告过热警告时，它会自动停止保持唤醒；如果此时已合盖，就让笔记本睡眠。保持唤醒期间，不要长时间把它放在封闭的背包里。
+
+- macOS：点一次 **设置**。macOS 自己的密码窗口会安装一条 sudoers 规则，只允许用到的命令（`pmset disablesleep`、`pmset sleepnow`，以及连接你指定的热点）；ClaudeRipple 看不到密码。用 `clauderipple awake setup --remove` 可以删除。如果装了 Insomnia，设置时会把它清理掉（它与本功能作用相同）。
+- Windows：不需要管理员权限。路由服务的子进程持有 `SetThreadExecutionState`，只在持有期间把合盖动作设为“不采取任何操作”；你自己的电源设置随后会恢复，即使路由服务崩溃也一样。
+
+**Wi-Fi 无法上网 → 手机热点。** 它通过 Wi-Fi 网卡实际检查能否上网（上行链路坏掉的路由器，或弹出登录页的 Wi-Fi，在系统看来仍是“已连接”），5 次检查中失败 3 次就加入你指定的热点。加入热点后，在 5、10、20、30、40、50、60 分钟时尝试切回，之后每 10 分钟一次：先离开热点，让系统连上范围内最好的已知 Wi-Fi，只有那个 Wi-Fi 能上网才留下。切换瞬间开始的模型请求不会失败，而是稍等一下。
+
+- 先在笔记本上手动连接一次手机热点，系统才会记住密码。
+- iPhone：保持开启 设置 › 个人热点 ›“允许其他人加入”。在 Mac 上，登录同一个 Apple 账户并开启蓝牙会更容易找到手机。
+- Android：热点闲置一段时间会自动关闭；找不到时请重新打开。
+- Linux：暂不支持。
+
 ## 供应商
 
 | 供应商 | 类型 | 认证 | 模型列表 | 备注 |

package/dist/app/dist/claude-desktop.js

@@ -0,0 +1,67 @@
+"use strict";
+// Quitting and reopening Claude Desktop, which is how it picks up a changed connection. The caller
+// asks the user first: quitting ends whatever is open in the app.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.reopenClaude = reopenClaude;
+const node_child_process_1 = require("node:child_process");
+const MAC_BUNDLE_ID = "com.anthropic.claudefordesktop";
+const QUIT_WAIT_MS = 20_000;
+function run(file, args, timeoutMs = 30_000) {
+    return new Promise((resolve) => {
+        (0, node_child_process_1.execFile)(file, args, { timeout: timeoutMs, windowsHide: true }, (err, stdout) => resolve({ ok: !err, stdout: String(stdout) }));
+    });
+}
+const sleep = (ms) => new Promise((r) => setTimeout(r, ms));
+/** True once Claude Desktop is running again. */
+async function reopenClaude() {
+    if (process.platform === "darwin")
+        return reopenMac();
+    if (process.platform === "win32")
+        return reopenWindows();
+    return false;
+}
+async function macRunning() {
+    // `is running` asks without launching the app.
+    const r = await run("osascript", ["-e", `application id "${MAC_BUNDLE_ID}" is running`], 10_000);
+    return r.ok && r.stdout.trim() === "true";
+}
+async function reopenMac() {
+    if (await macRunning()) {
+        await run("osascript", ["-e", `tell application id "${MAC_BUNDLE_ID}" to quit`]);
+        const deadline = Date.now() + QUIT_WAIT_MS;
+        while (Date.now() < deadline && (await macRunning()))
+            await sleep(500);
+        // Opening it while the old one is still on its way out would only bring that one forward.
+        if (await macRunning())
+            return false;
+    }
+    const opened = await run("open", ["-b", MAC_BUNDLE_ID]);
+    return opened.ok || (await run("open", ["-a", "Claude"])).ok;
+}
+/**
+ * Claude Desktop is the claude.exe that owns a window; Claude Code's own claude.exe (terminal
+ * sessions, the copy Desktop caches) has none and must not be touched. Closing the window asks it
+ * to quit; whatever of that same executable is left after a few seconds is ended, then it is
+ * started again from the same path.
+ */
+const WINDOWS_SCRIPT = String.raw `
+$ErrorActionPreference = 'SilentlyContinue'
+$main = Get-Process -Name claude | Where-Object { $_.MainWindowHandle -ne 0 -and $_.Path } | Select-Object -First 1
+if ($main) {
+  $exe = $main.Path
+  Get-Process -Name claude | Where-Object { $_.Path -eq $exe } | ForEach-Object { [void]$_.CloseMainWindow() }
+  $deadline = (Get-Date).AddSeconds(8)
+  while ((Get-Process -Name claude | Where-Object { $_.Path -eq $exe }) -and (Get-Date) -lt $deadline) { Start-Sleep -Milliseconds 500 }
+  Get-Process -Name claude | Where-Object { $_.Path -eq $exe } | Stop-Process -Force
+  Start-Sleep -Milliseconds 500
+} else {
+  $exe = Join-Path $env:LOCALAPPDATA 'AnthropicClaude\claude.exe'
+  if (-not (Test-Path $exe)) { exit 1 }
+}
+Start-Process -FilePath $exe
+if (-not $?) { exit 1 }
+`;
+async function reopenWindows() {
+    const r = await run("powershell.exe", ["-NoProfile", "-NonInteractive", "-ExecutionPolicy", "Bypass", "-Command", WINDOWS_SCRIPT], 40_000);
+    return r.ok;
+}