ring-cli 0.10.0__tar.gz → 0.11.1__tar.gz

{ring_cli-0.10.0 → ring_cli-0.11.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ring-cli
-Version: 0.10.0
+Version: 0.11.1
 Summary: RiNG — Realtime Instance Notification Grid for active agent CLI sessions.
 Keywords: claude-code,codex,tui,dashboard,session,monitor,rich
 Author: Wei Lee
@@ -59,6 +59,7 @@ RiNG puts them on one board, with sessions waiting for you sorted first.
 - **Waiting first**: sessions that need your response are highlighted and sorted above the rest.
 - **Jump back to the terminal**: in the TUI, select a session and press `Enter` / `Space` to focus tmux, iTerm2, Terminal.app (macOS), or a Linux X11 window (`wmctrl`).
 - **Notifies you without the board open**: with hooks installed, the moment a session turns 🔴 waiting it beeps and fires a system notification — even with no RiNG board running. With `terminal-notifier`, clicking the notification jumps back.
+- **Reply to permission requests in place**: with the cursor on a 🔴 waiting row, press `p` — RiNG reads the permission dialog from that session's terminal screen, pops the numbered options in a modal, and presses your choice for you, so you don't have to jump over one by one (sessions inside tmux, plus plain iTerm2 tabs on macOS).
 - **Name your sessions**: press `n` in the TUI to name a session, e.g. "auth refactor"; once named, the board and notifications show the name instead of the workspace directory.
 - **See what it is waiting for**: in hook mode, a 🔴 waiting session carries the concrete pending item (the command to run, the question asked) — shown in the TUI and in the notification body.
 - **Fits your status bar**: `ring --format oneline` prints a `🔴2 🟢1 🟡3` one-liner for tmux / SwiftBar / waybar; `--format json` feeds scripts.
@@ -153,7 +154,7 @@ Completes subcommands, flags, and `config set` keys; `ring focus` prompts for a
 ## Watch Mode
 
 - With **Textual** (`[tui]` extra) in a real terminal: interactive TUI.
-  Use `↑/↓` to select, `Enter` / `Space` to jump, `n` to name a session, `a` to toggle ended sessions, `dd` to hide a session (it reappears automatically once it has new activity), `r` to refresh, and `q` to quit.
+  Use `↑/↓` to select, `Enter` / `Space` to jump, `p` to reply to a permission request in place, `n` to name a session, `a` to toggle ended sessions, `dd` to hide a session (it reappears automatically once it has new activity), `r` to refresh, and `q` to quit.
   If you have vim muscle memory like I do, `j/k` move up/down and `g/G` jump to the first/last row.
   When the selected row is 🔴 waiting, a line under the table shows **what it is concretely waiting for** (the command to run, the question asked; hook mode only).
 - Otherwise: Rich polling; without Rich, plain text.
@@ -172,6 +173,30 @@ hands the request to the TUI so it selects that session; otherwise it focuses th
 TTY matching is most accurate in hook mode. Without hooks, Codex falls back to zero-config matching:
 one live Codex session per cwd can jump correctly; multiple live Codex sessions in the same cwd are shown conservatively to avoid focusing the wrong tab.
 
+### Reply To Permission Requests In Place (`p`)
+
+With the cursor on a 🔴 waiting row, press `p`. RiNG reads that session's screen, parses the
+permission dialog (Claude Code's "Do you want to proceed?" box, including background-subagent
+ones with a "from the … agent" header), and lists the numbered options verbatim in a modal.
+After you pick one, RiNG **captures the screen again** to confirm the dialog is still there and
+unchanged (it may have been answered while you were deciding), only then sends that single
+digit, and re-checks that the dialog actually disappeared.
+
+- **Sessions inside tmux**: reads the screen with `tmux capture-pane` and sends keys with
+  `tmux send-keys`.
+- **Sessions in a plain iTerm2 tab on macOS** (no tmux): locates the matching iTerm2 session by
+  its `tty` via AppleScript, and both reads the screen and sends keys through `osascript`. The
+  first use triggers the macOS Automation permission prompt ("allow control of iTerm2") — allow
+  it once.
+
+Safety first: if no recognizable dialog can be parsed (missing markers, numbering, or cursor),
+RiNG only shows a toast and **never sends a key** — without the dialog, keystrokes would land in
+the chat input box as text. If the dialog happens to vanish in the instant the digit is sent and
+the digit lands in the input box, RiNG sends a Backspace to clean it up and warns you.
+
+**Limits**: reading the screen requires a tmux pane coordinate, or (on macOS) an iTerm2 session
+with a detectable tty; for other sessions, press `Enter` to jump over and reply there.
+
 ### Notifications
 
 Default behavior: with hooks installed, the moment a session changes to 🔴 waiting, the hook beeps

{ring_cli-0.10.0 → ring_cli-0.11.1}/README.en.md

@@ -34,6 +34,7 @@ RiNG puts them on one board, with sessions waiting for you sorted first.
 - **Waiting first**: sessions that need your response are highlighted and sorted above the rest.
 - **Jump back to the terminal**: in the TUI, select a session and press `Enter` / `Space` to focus tmux, iTerm2, Terminal.app (macOS), or a Linux X11 window (`wmctrl`).
 - **Notifies you without the board open**: with hooks installed, the moment a session turns 🔴 waiting it beeps and fires a system notification — even with no RiNG board running. With `terminal-notifier`, clicking the notification jumps back.
+- **Reply to permission requests in place**: with the cursor on a 🔴 waiting row, press `p` — RiNG reads the permission dialog from that session's terminal screen, pops the numbered options in a modal, and presses your choice for you, so you don't have to jump over one by one (sessions inside tmux, plus plain iTerm2 tabs on macOS).
 - **Name your sessions**: press `n` in the TUI to name a session, e.g. "auth refactor"; once named, the board and notifications show the name instead of the workspace directory.
 - **See what it is waiting for**: in hook mode, a 🔴 waiting session carries the concrete pending item (the command to run, the question asked) — shown in the TUI and in the notification body.
 - **Fits your status bar**: `ring --format oneline` prints a `🔴2 🟢1 🟡3` one-liner for tmux / SwiftBar / waybar; `--format json` feeds scripts.
@@ -128,7 +129,7 @@ Completes subcommands, flags, and `config set` keys; `ring focus` prompts for a
 ## Watch Mode
 
 - With **Textual** (`[tui]` extra) in a real terminal: interactive TUI.
-  Use `↑/↓` to select, `Enter` / `Space` to jump, `n` to name a session, `a` to toggle ended sessions, `dd` to hide a session (it reappears automatically once it has new activity), `r` to refresh, and `q` to quit.
+  Use `↑/↓` to select, `Enter` / `Space` to jump, `p` to reply to a permission request in place, `n` to name a session, `a` to toggle ended sessions, `dd` to hide a session (it reappears automatically once it has new activity), `r` to refresh, and `q` to quit.
   If you have vim muscle memory like I do, `j/k` move up/down and `g/G` jump to the first/last row.
   When the selected row is 🔴 waiting, a line under the table shows **what it is concretely waiting for** (the command to run, the question asked; hook mode only).
 - Otherwise: Rich polling; without Rich, plain text.
@@ -147,6 +148,30 @@ hands the request to the TUI so it selects that session; otherwise it focuses th
 TTY matching is most accurate in hook mode. Without hooks, Codex falls back to zero-config matching:
 one live Codex session per cwd can jump correctly; multiple live Codex sessions in the same cwd are shown conservatively to avoid focusing the wrong tab.
 
+### Reply To Permission Requests In Place (`p`)
+
+With the cursor on a 🔴 waiting row, press `p`. RiNG reads that session's screen, parses the
+permission dialog (Claude Code's "Do you want to proceed?" box, including background-subagent
+ones with a "from the … agent" header), and lists the numbered options verbatim in a modal.
+After you pick one, RiNG **captures the screen again** to confirm the dialog is still there and
+unchanged (it may have been answered while you were deciding), only then sends that single
+digit, and re-checks that the dialog actually disappeared.
+
+- **Sessions inside tmux**: reads the screen with `tmux capture-pane` and sends keys with
+  `tmux send-keys`.
+- **Sessions in a plain iTerm2 tab on macOS** (no tmux): locates the matching iTerm2 session by
+  its `tty` via AppleScript, and both reads the screen and sends keys through `osascript`. The
+  first use triggers the macOS Automation permission prompt ("allow control of iTerm2") — allow
+  it once.
+
+Safety first: if no recognizable dialog can be parsed (missing markers, numbering, or cursor),
+RiNG only shows a toast and **never sends a key** — without the dialog, keystrokes would land in
+the chat input box as text. If the dialog happens to vanish in the instant the digit is sent and
+the digit lands in the input box, RiNG sends a Backspace to clean it up and warns you.
+
+**Limits**: reading the screen requires a tmux pane coordinate, or (on macOS) an iTerm2 session
+with a detectable tty; for other sessions, press `Enter` to jump over and reply there.
+
 ### Notifications
 
 Default behavior: with hooks installed, the moment a session changes to 🔴 waiting, the hook beeps

{ring_cli-0.10.0 → ring_cli-0.11.1}/pyproject.toml

@@ -2,7 +2,7 @@
 # import 的 module（見 [tool.uv.build-backend] module-name）與 CLI 指令仍是 `ring`。
 [project]
 name = "ring-cli"
-version = "0.10.0"
+version = "0.11.1"
 description = "RiNG — Realtime Instance Notification Grid for active agent CLI sessions."
 readme = "README.en.md"
 requires-python = ">=3.13"

{ring_cli-0.10.0 → ring_cli-0.11.1}/src/ring/locale/en/LC_MESSAGES/ring.po

@@ -161,6 +161,9 @@ msgstr "terminal tab not found (it may have been closed; if it still appears aft
 msgid "沒有 focuser 接得住（裝 hook，或一個專案只開一個 session 才測得到 tty）"
 msgstr "no focuser handled it (install hooks, or keep one session per project so tty is detectable)"
 
+msgid "背景 agent，沒有終端可跳；用 `claude --resume {session_id}` 接回"
+msgstr "background agent, no terminal to jump to; reconnect with `claude --resume {session_id}`"
+
 # ── install-hooks ──
 msgid "⚠️ {path} 不是合法 JSON，先處理它再來。"
 msgstr "⚠️ {path} is not valid JSON; fix it first."
@@ -653,3 +656,42 @@ msgstr "total wait"
 
 msgid "⚠️ 其中 {n} 段還在 🔴 等你（計到現在為止）。"
 msgstr "⚠️ {n} of these are still 🔴 waiting for you (counted up to now)."
+
+msgid "回覆權限"
+msgstr "reply perm"
+
+msgid "回覆 {project} 的權限請求"
+msgstr "Reply to the permission request from {project}"
+
+msgid "Enter 或數字鍵送出、Esc 取消"
+msgstr "Enter or a digit key sends, Esc cancels"
+
+msgid "{project}：沒有 tmux 座標，且非 macOS 上的 iTerm2 session，無法就地回覆"
+msgstr "{project}: no tmux coordinates, and not a macOS iTerm2 session either — cannot reply in place"
+
+msgid "{project}：讀不到 {backend} 畫面"
+msgstr "{project}: cannot read the {backend} screen"
+
+msgid "{project}：畫面上沒有可辨識的權限對話框，未送出任何按鍵"
+msgstr "{project}: no recognizable permission dialog on screen; no key was sent"
+
+msgid "→ {project}：已回覆權限（{option}）"
+msgstr "→ {project}: permission answered ({option})"
+
+msgid "{project}：權限對話框已不在，未送出任何按鍵"
+msgstr "{project}: the permission dialog is gone; no key was sent"
+
+msgid "{project}：對話框內容已變化，未送出；請再按一次 p"
+msgstr "{project}: the dialog changed; nothing sent — press p again"
+
+msgid "{project}：tmux send-keys 失敗，沒能回覆"
+msgstr "{project}: tmux send-keys failed; could not reply"
+
+msgid "{project}：已送出但對話框還在，請跳過去確認"
+msgstr "{project}: key sent but the dialog is still there — jump over to check"
+
+msgid "{project}：對話框已不在，數字落進輸入框，已補 Backspace 清掉"
+msgstr "{project}: the dialog was gone and the digit landed in the input box — sent Backspace to clean it up"
+
+msgid "{project}：已送出但拿不到畫面驗證，請跳過去確認"
+msgstr "{project}: key sent but the screen could not be re-read to verify — jump over to check"

{ring_cli-0.10.0 → ring_cli-0.11.1}/src/ring/locale/ring.pot

@@ -8,7 +8,7 @@ msgid ""
 msgstr ""
 "Project-Id-Version: PROJECT VERSION\n"
 "Report-Msgid-Bugs-To: EMAIL@ADDRESS\n"
-"POT-Creation-Date: 2026-07-10 15:32+0800\n"
+"POT-Creation-Date: 2026-07-12 09:22+0800\n"
 "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
 "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
 "Language-Team: LANGUAGE <LL@li.org>\n"
@@ -52,7 +52,7 @@ msgstr[1] ""
 msgid "🎤 RiNG — {sess} · {proc}"
 msgstr ""
 
-#: src/ring/cli.py:163 src/ring/cli.py:216 src/ring/tui.py:213
+#: src/ring/cli.py:163 src/ring/cli.py:216 src/ring/tui.py:279
 msgid "圖例"
 msgstr ""
 
@@ -63,32 +63,32 @@ msgstr ""
 #: src/ring/cli.py:184 src/ring/cli.py:338 src/ring/commands/doctor.py:31
 #: src/ring/commands/doctor.py:68 src/ring/commands/doctor.py:70
 #: src/ring/commands/doctor.py:72 src/ring/commands/doctor.py:134
-#: src/ring/tui.py:168
+#: src/ring/tui.py:234
 msgid "狀態"
 msgstr ""
 
-#: src/ring/cli.py:186 src/ring/cli.py:235 src/ring/tui.py:170
+#: src/ring/cli.py:186 src/ring/cli.py:235 src/ring/tui.py:236
 msgid "工具"
 msgstr ""
 
 #: src/ring/cli.py:187 src/ring/cli.py:235 src/ring/commands/stats.py:60
-#: src/ring/tui.py:171
+#: src/ring/tui.py:237
 msgid "專案"
 msgstr ""
 
-#: src/ring/cli.py:188 src/ring/cli.py:235 src/ring/tui.py:171
+#: src/ring/cli.py:188 src/ring/cli.py:235 src/ring/tui.py:237
 msgid "進度"
 msgstr ""
 
-#: src/ring/cli.py:189 src/ring/cli.py:235 src/ring/tui.py:171
+#: src/ring/cli.py:189 src/ring/cli.py:235 src/ring/tui.py:237
 msgid "閒置"
 msgstr ""
 
-#: src/ring/cli.py:190 src/ring/cli.py:235 src/ring/tui.py:171
+#: src/ring/cli.py:190 src/ring/cli.py:235 src/ring/tui.py:237
 msgid "去哪"
 msgstr ""
 
-#: src/ring/cli.py:192 src/ring/cli.py:235 src/ring/tui.py:171
+#: src/ring/cli.py:192 src/ring/cli.py:235 src/ring/tui.py:237
 msgid "動作"
 msgstr ""
 
@@ -305,41 +305,41 @@ msgstr ""
 msgid "重開 Codex session、並在它詢問時「信任」這個 hook，🔴 等你狀態才會精準起來（Codex 不會執行未信任的 hook）。"
 msgstr ""
 
-#: src/ring/hook.py:406
+#: src/ring/hook.py:438
 #, python-brace-format
 msgid "⚠️ 偵測到其他工具也掛在 {events}：{cmds}"
 msgstr ""
 
-#: src/ring/hook.py:407
+#: src/ring/hook.py:439
 msgid "它們會跟 RiNG 的通知重複觸發；要完全改用 RiNG，建議移除它們。"
 msgstr ""
 
-#: src/ring/hook.py:455 src/ring/hook.py:531
+#: src/ring/hook.py:487 src/ring/hook.py:563
 #, python-brace-format
 msgid "⚠️ {path} 不是合法 JSON，先處理它再來。"
 msgstr ""
 
-#: src/ring/hook.py:493
+#: src/ring/hook.py:525
 #, python-brace-format
 msgid "✅ RiNG hooks 已經裝過了，沒有變更。（{path}）"
 msgstr ""
 
-#: src/ring/hook.py:506
+#: src/ring/hook.py:538
 #, python-brace-format
 msgid "✅ 已註冊 RiNG hooks（{events}）到 {path}"
 msgstr ""
 
-#: src/ring/hook.py:525
+#: src/ring/hook.py:557
 #, python-brace-format
 msgid "ℹ️ {path} 不存在，沒有可移除的 hook。"
 msgstr ""
 
-#: src/ring/hook.py:552
+#: src/ring/hook.py:584
 #, python-brace-format
 msgid "ℹ️ 沒有找到 RiNG hook 條目，無需移除。（{path}）"
 msgstr ""
 
-#: src/ring/hook.py:556
+#: src/ring/hook.py:588
 #, python-brace-format
 msgid "✅ 已移除 RiNG hooks（{events}）從 {path}"
 msgstr ""
@@ -349,103 +349,172 @@ msgstr ""
 msgid "⚠️ ring plugin '{name}' 載入失敗：{error}"
 msgstr ""
 
-#: src/ring/tui.py:88
+#: src/ring/tui.py:51
+#, python-brace-format
+msgid "背景 agent，沒有終端可跳；用 `claude --resume {session_id}` 接回"
+msgstr ""
+
+#: src/ring/tui.py:96
 #, python-brace-format
 msgid "為 {project} 命名（Enter 存、Esc 取消、清空移除）"
 msgstr ""
 
-#: src/ring/tui.py:89
+#: src/ring/tui.py:97
 msgid "這個 session 在做什麼…"
 msgstr ""
 
-#: src/ring/tui.py:106
+#: src/ring/tui.py:141
+#, python-brace-format
+msgid "回覆 {project} 的權限請求"
+msgstr ""
+
+#: src/ring/tui.py:146
+msgid "Enter 或數字鍵送出、Esc 取消"
+msgstr ""
+
+#: src/ring/tui.py:169
 msgid "離場"
 msgstr ""
 
-#: src/ring/tui.py:107
+#: src/ring/tui.py:170
 msgid "刷新"
 msgstr ""
 
-#: src/ring/tui.py:108
+#: src/ring/tui.py:171
 msgid "含已離場"
 msgstr ""
 
-#: src/ring/tui.py:109
+#: src/ring/tui.py:172
 msgid "命名"
 msgstr ""
 
-#: src/ring/tui.py:110
+#: src/ring/tui.py:173
 msgid "隱藏"
 msgstr ""
 
-#: src/ring/tui.py:111
+#: src/ring/tui.py:174
 msgid "最久等待"
 msgstr ""
 
-#: src/ring/tui.py:112 src/ring/tui.py:113
+#: src/ring/tui.py:175
+msgid "回覆權限"
+msgstr ""
+
+#: src/ring/tui.py:176 src/ring/tui.py:177
 msgid "跳過去"
 msgstr ""
 
-#: src/ring/tui.py:189
+#: src/ring/tui.py:255
 msgid "💡 同專案開了多個 session，裝 hook 跳轉才精準：ring install-hooks"
 msgstr ""
 
-#: src/ring/tui.py:191
+#: src/ring/tui.py:257
 msgid "↑/↓ 選一列，Enter 或 Space 跳到那個 session 的終端"
 msgstr ""
 
-#: src/ring/tui.py:227
+#: src/ring/tui.py:293
 #, python-brace-format
 msgid "🔔 {names} 在等你回話"
 msgstr ""
 
-#: src/ring/tui.py:268
+#: src/ring/tui.py:334
 #, python-brace-format
 msgid "→ 已跳到 {project}（來自通知）"
 msgstr ""
 
-#: src/ring/tui.py:273
+#: src/ring/tui.py:339
 msgid "那個 session 已不在場"
 msgstr ""
 
-#: src/ring/tui.py:332
+#: src/ring/tui.py:400
 msgid "  ⚠ hook 可能失效：來源檔有更新但沒有 heartbeat"
 msgstr ""
 
-#: src/ring/tui.py:361 src/ring/tui.py:385 src/ring/tui.py:411
+#: src/ring/tui.py:431 src/ring/tui.py:455 src/ring/tui.py:494
+#: src/ring/tui.py:562
 msgid "（沒有選到 session）"
 msgstr ""
 
-#: src/ring/tui.py:392
+#: src/ring/tui.py:462 src/ring/tui.py:470 src/ring/tui.py:500
 #, python-brace-format
-msgid "→ {project}（{where}）"
+msgid "{project}：{msg}"
 msgstr ""
 
-#: src/ring/tui.py:394
+#: src/ring/tui.py:468
 #, python-brace-format
-msgid "{project}：{msg}"
+msgid "→ {project}（{where}）"
 msgstr ""
 
-#: src/ring/tui.py:402
+#: src/ring/tui.py:478
 msgid "（沒有正在等待的 session）"
 msgstr ""
 
-#: src/ring/tui.py:419
+#: src/ring/tui.py:504
+#, python-brace-format
+msgid "{project}：沒有 tmux 座標，且非 macOS 上的 iTerm2 session，無法就地回覆"
+msgstr ""
+
+#: src/ring/tui.py:511
+#, python-brace-format
+msgid "{project}：讀不到 {backend} 畫面"
+msgstr ""
+
+#: src/ring/tui.py:515
+#, python-brace-format
+msgid "{project}：畫面上沒有可辨識的權限對話框，未送出任何按鍵"
+msgstr ""
+
+#: src/ring/tui.py:544
+#, python-brace-format
+msgid "→ {project}：已回覆權限（{option}）"
+msgstr ""
+
+#: src/ring/tui.py:548
+#, python-brace-format
+msgid "{project}：權限對話框已不在，未送出任何按鍵"
+msgstr ""
+
+#: src/ring/tui.py:549
+#, python-brace-format
+msgid "{project}：對話框內容已變化，未送出；請再按一次 p"
+msgstr ""
+
+#: src/ring/tui.py:550
+#, python-brace-format
+msgid "{project}：tmux send-keys 失敗，沒能回覆"
+msgstr ""
+
+#: src/ring/tui.py:551
+#, python-brace-format
+msgid "{project}：已送出但對話框還在，請跳過去確認"
+msgstr ""
+
+#: src/ring/tui.py:553
+#, python-brace-format
+msgid "{project}：對話框已不在，數字落進輸入框，已補 Backspace 清掉"
+msgstr ""
+
+#: src/ring/tui.py:555
+#, python-brace-format
+msgid "{project}：已送出但拿不到畫面驗證，請跳過去確認"
+msgstr ""
+
+#: src/ring/tui.py:570
 #, python-brace-format
 msgid "再按一次 d 隱藏 {project}（有新活動會自動重新出現）"
 msgstr ""
 
-#: src/ring/tui.py:424
+#: src/ring/tui.py:575
 #, python-brace-format
 msgid "{project} 是仍在執行的 process，無法隱藏；請跳過去結束它"
 msgstr ""
 
-#: src/ring/tui.py:432
+#: src/ring/tui.py:583
 #, python-brace-format
 msgid "已隱藏 {project}，並清掉 RiNG 狀態；有新活動會自動重新出現"
 msgstr ""
 
-#: src/ring/tui.py:434
+#: src/ring/tui.py:585
 #, python-brace-format
 msgid "已隱藏 {project}（沒有 RiNG registry 可清；有新活動會自動重新出現）"
 msgstr ""