claude-inbox 0.13.0 → 0.14.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: f8b8a6141fcc9efc19386143e9412d4ebab669e73350ee42205e6a07fd05b290
-  data.tar.gz: 412882713110008db6ff1d96fe8b786e5d61e82ea9b349202c12560f290a86b3
+  metadata.gz: c346a215bf94ae3088c6ce5ddff23a2852e0294b77bbaa92a980d6baf4315cb7
+  data.tar.gz: 92e53f999cc3731ab9bf96c20e96048cd47a2261cb9640ed26bdafdc5032bbd6
 SHA512:
-  metadata.gz: f87a453630132a470dc22b345e8f611ae0e58f04bc877c52ee1c53c4358a306377529a10ae8d807058dc32e1c9d039fc2480dd962a89d382a16e00d35faf6908
-  data.tar.gz: de74aeac784fdc777336fdaa4db38cfae93e7458873809e2c3e52c0a5a69dc53d2391cec86d73e2d52882ad9634c4567553f3d6151e2c40c571a7eca0abc8db5
+  metadata.gz: cb9dc45979798d3e8c73534f06c1e6dc73a6bdfb5019c6df3f87ae7e3e3adb6cf0d67f370e61f29729f3a10a07a5728a58507dd1f961929843c2798e52f5cd18
+  data.tar.gz: 59558583519adb57a59ab15c9bad0d78bff87b8db105210c8bdd63370eaa40d3105a68bed312ec0972bfd6fe91bca53866c39decd734db64b09059d8071d4860

data/exe/claude-inbox

@@ -1,6 +1,10 @@
 #!/usr/bin/env ruby
 # frozen_string_literal: true
 
+# Claude's files are UTF-8 whatever the locale says; under LANG=C a read of
+# ~/.claude.json would otherwise come back US-ASCII and fail to parse.
+Encoding.default_external = Encoding::UTF_8
+
 require "claude_inbox"
 require "claude_inbox/cli"
 

data/lib/claude_inbox/app/navigating.rb

@@ -7,12 +7,6 @@ module ClaudeInbox
     module Navigating
       private
 
-      # Remembers where the frame put the rows, so a click can find one.
-      def placed(frame)
-        @row_items = frame.items
-        @top = frame.top
-      end
-
       # The row to land on once a poll lists it, as after a spawn.
       def select_later(id)
         @pending_select = id
@@ -100,7 +94,7 @@ module ClaudeInbox
       # no item of its own; a click there resolves to the row above it.
       def row_item_at(row)
         idx = row - 1
-        @row_items[idx] || (@row_items[idx - 1] if idx > 0 && @row_items[idx - 1]&.row?)
+        @frame.items[idx] || (@frame.items[idx - 1] if idx > 0 && @frame.items[idx - 1]&.row?)
       end
     end
   end

data/lib/claude_inbox/app.rb

@@ -71,8 +71,8 @@ module ClaudeInbox
         reaper: reaper, queue: @queue, snapshot: snapshot, actions: actions, notifier: notifier)
       @listener = listen ? Remote::Listener.new(client: client, store: store, queue: @queue, **listen) : Remote::Listener.disabled
       @selected = nil
-      @row_items = []
-      @top = 0
+      @frame = Renderer::Frame.new([], [], 0)
+      @pointer_at = nil
       @expanded = Hash.new(false)
       @keymap = Keymap.new
       @tick = 0
@@ -87,7 +87,7 @@ module ClaudeInbox
     end
 
     def run
-      @booted_at = Process.clock_gettime(Process::CLOCK_MONOTONIC)
+      @booted_at = monotonic
       install_traps
       @terminal.enter
       @poller.start
@@ -190,6 +190,9 @@ module ClaudeInbox
     # the normal action table (see handle_key); mouse input defers to the
     # same rule rather than reaching past whatever has focus.
     def handle_mouse(event)
+      @pointer_at = [event.row, event.col]
+      link = link_under_pointer
+      return click_link(link) if event.kind == :click && link
       return if @modal || filter_editing?
       case event.kind
       when :click then click_row(event.row)
@@ -198,6 +201,15 @@ module ClaudeInbox
       end
     end
 
+    def click_link(link)
+      return open_in_browser(link.url, link.text) unless @modal
+      pr_picked if @modal.pick_by_url(link.url)
+    end
+
+    def link_under_pointer
+      @frame.link_at(*@pointer_at) if @pointer_at && !filter_editing?
+    end
+
     def handle_modal_key(name, key)
       return handle_form_key(name, key) if @modal.is_a?(NewSessionForm)
       case @modal.press(name, key)
@@ -264,7 +276,7 @@ module ClaudeInbox
     end
 
     def render
-      t0 = Process.clock_gettime(Process::CLOCK_MONOTONIC)
+      t0 = monotonic
       now = Time.now
       all = @store.sections(now)
       @snapshot.write(all, now)
@@ -274,16 +286,16 @@ module ClaudeInbox
       ensure_selection(sections)
       @tick += 1
       view = Renderer::View.new(
-        width: width, height: height, now: now, selected: @selected&.key, top: @top, expanded: @expanded,
+        width: width, height: height, now: now, selected: @selected&.key, top: @frame.top, expanded: @expanded,
         modal: modal_lines(width), screen: screen_lines(width, body_h),
         status: status_text(now), usage: @rate_limits.windows(now), filter: filter, filter_editing: filter_editing?,
         tick: @tick / 2, loading: loading_for, listening: @listener.snapshot
       )
-      frame = @renderer.frame(sections, view)
-      frame = frame.plain unless @color # --no-color: decided here and nowhere else
-      placed(frame)
-      @terminal.paint(frame.lines)
-      dt = Process.clock_gettime(Process::CLOCK_MONOTONIC) - t0
+      @frame = @renderer.frame(sections, view)
+      @frame = @frame.plain unless @color # --no-color: decided here and nowhere else
+      @terminal.paint(@frame.lines)
+      @terminal.pointer(!link_under_pointer.nil?)
+      dt = monotonic - t0
       Debug.log("render #{(dt * 1000).round}ms") if dt > 0.05
     end
 
@@ -309,11 +321,13 @@ module ClaudeInbox
     # already says how to retry.
     def loading_for
       return nil if @last_poll || @error || !@booted_at
-      Process.clock_gettime(Process::CLOCK_MONOTONIC) - @booted_at
+      monotonic - @booted_at
     end
 
     def notice(msg)
       @notice = [msg, Time.now + 4]
     end
+
+    def monotonic = Process.clock_gettime(Process::CLOCK_MONOTONIC)
   end
 end

data/lib/claude_inbox/dialog.rb

@@ -28,10 +28,15 @@ module ClaudeInbox
         .split("\n")
     end
 
+    private
+
     # How wide the box wants to be; the frame caps it at the terminal.
     def fit = self.class::WIDTH
 
-    private
+    def bordered(rows, inner)
+      top = Text.truncate(title, inner)
+      ["┌#{top}#{"─" * (inner - Text.width(top))}┐", *rows.map { |row| "│#{row}│" }, "└#{"─" * inner}┘"]
+    end
 
     def key(name) = @theme.cyan_bold(name)
 
@@ -83,9 +88,17 @@ module ClaudeInbox
 
       def title = " #{kind.to_s.capitalize} pull request "
 
-      # Titles vary, so the box grows to the longest line plus some air,
-      # and never shrinks below a plain dialog.
-      def fit = [WIDTH, lines(Float::INFINITY, nil).map { |l| Text.width(l) }.max + MARGIN].max
+      # Drawn by hand: TTY::Box counts a link's hidden characters toward the
+      # line's width, so it would clip every line that has a link.
+      def frame(width, _caret = nil)
+        inner = [width - 4, fit].min - 2
+        bordered(lines(inner - 2, nil).map { |l| " #{Text.pad(l, inner - 2)} " }, inner)
+      end
+
+      def pick_by_url(url)
+        @choice = @prs.find { |pr| pr.url == url }
+        @choice && :pick
+      end
 
       def lines(width, _caret)
         (@prs.each_with_index.map { |pr, i| "  #{key((i + 1).to_s)}  #{label(pr)}" } +
@@ -102,6 +115,10 @@ module ClaudeInbox
 
       private
 
+      # Titles vary, so the box grows to the longest line plus some air,
+      # and never shrinks below a plain dialog.
+      def fit = [WIDTH, lines(Float::INFINITY, nil).map { |l| Text.width(l) }.max + MARGIN].max
+
       # The list's badge, then the title. A bare #190 is ambiguous only
       # once the list spans repos.
       def label(pr)
@@ -170,9 +187,7 @@ module ClaudeInbox
       # pushes the right border out on every line that has one.
       def frame(width, _caret = nil)
         inner = [width - 4, WIDTH].min - 2
-        ["┌#{title}#{"─" * (inner - Text.width(title))}┐",
-          *lines(inner, nil).map { |l| "│#{Text.pad(Text.truncate(l, inner), inner)}│" },
-          "└#{"─" * inner}┘"]
+        bordered(lines(inner, nil).map { |l| Text.pad(Text.truncate(l, inner), inner) }, inner)
       end
 
       def lines(_width, _caret)

data/lib/claude_inbox/headless.rb

@@ -33,8 +33,11 @@ module ClaudeInbox
     def run
       return false unless @lock.take(role: "headless")
       @poller.start
-      Thread.new { watch_for_updates } if @updater
+      updates = Thread.new { watch_for_updates } if @updater
       loop { @queue.pop }
+    ensure
+      @poller.stop
+      updates&.kill
     end
 
     private

data/lib/claude_inbox/mouse.rb

@@ -2,31 +2,32 @@
 
 module ClaudeInbox
   # Parses SGR mouse reports ("\e[<Cb;Cx;Cy(M|m)", emitted once App turns on
-  # \e[?1000h\e[?1006h) into clicks and wheel ticks. Pure: no terminal, no
-  # IO. Row is the terminal's own 1-based row, so callers can index straight
-  # into what they just painted.
+  # \e[?1003h\e[?1006h) into clicks, pointer moves and wheel ticks. Pure: no
+  # terminal, no IO. Row and column are the terminal's own 1-based ones, so
+  # callers can index straight into what they just painted.
   module Mouse
     SEQUENCE = /\e\[<(\d+);(\d+);(\d+)([Mm])/
 
-    Event = Struct.new(:kind, :row)
+    Event = Struct.new(:kind, :row, :col)
 
     # A raw keypress can glue several reports together the same way a fast
     # "esc gg" glues onto one read (see Input#split_keys), so this scans
     # rather than matching once.
     def self.events(raw)
-      raw.scan(SEQUENCE).filter_map do |cb, _col, row, type|
+      raw.scan(SEQUENCE).filter_map do |cb, col, row, type|
         kind = kind_for(cb.to_i, type)
-        Event.new(kind, row.to_i) if kind
+        Event.new(kind, row.to_i, col.to_i) if kind
       end
     end
 
-    # Bit 6 (0x40) marks a wheel tick, direction in bit 0. Otherwise this is
-    # a button press/release: bits 0-1 give the button (0 = left) and bit 5
-    # (0x20) marks a drag, so 0x23 masks both at once. Only a left click,
-    # released of any drag, counts; middle/right buttons and drags are left
-    # for the terminal's own handling.
+    # Bit 6 (0x40) marks a wheel tick, direction in bit 0. Otherwise bits
+    # 0-1 give the button (0 = left, 3 = none) and bit 5 (0x20) marks motion,
+    # so 0x23 masks both at once. Only a left click, released of any drag,
+    # counts, and motion with no button held is the pointer moving; middle
+    # and right buttons and drags are left for the terminal's own handling.
     def self.kind_for(cb, type)
       return (cb.even? ? :scroll_up : :scroll_down) if cb & 0x40 != 0
+      return :move if cb & 0x23 == 0x23
       :click if type == "M" && cb & 0x23 == 0
     end
     private_class_method :kind_for

data/lib/claude_inbox/new_session_form.rb

@@ -12,12 +12,11 @@ require_relative "text_buffer"
 require_relative "theme"
 
 module ClaudeInbox
-  # State and key handling for the "new session" modal. Pure: returns what
-  # happened so the App can act on it. Rendering returns plain lines; the
-  # App wraps them in a box.
+  # The `n` form a new session is composed in. Pure: it says what happened
+  # and the App acts on it.
   class NewSessionForm
     # `value` is a TextBuffer on :text and :multiline fields and the picked
-    # string on :choice ones — `kind` says which.
+    # string on :choice ones.
     Field = Struct.new(:key, :label, :kind, :value, :choices)
 
     # A directory the Directory field offers, shown by its shortest
@@ -71,11 +70,9 @@ module ClaudeInbox
 
     # => :cancel | :start | :start_and_attach | :changed
     def press(name, raw)
-      # `:start`/`:start_and_attach` leave the form up until the spawn is
-      # known to have worked, so a failure (untrusted directory, `claude`
-      # missing, ...) can hand the composed prompt back instead of losing
-      # it; there is no way to cancel a spawn already under way, so every
-      # key is swallowed until the App reports back.
+      # A start leaves the form up until the spawn has worked, so a failure
+      # can hand the prompt back. A spawn under way can't be cancelled, so
+      # every key is swallowed until the App reports back.
       return :changed if @busy
       return confirm_discard_press(name, raw) if @confirm_discard
       @error = nil
@@ -149,8 +146,7 @@ module ClaudeInbox
       @defaults = Settings.defaults(cwd, home: @home)
     end
 
-    # Full-screen body: a tall prompt editor, then one row per setting with
-    # every choice visible. Exactly `height` lines.
+    # The whole body, exactly `height` lines.
     def screen(width, height)
       inner_w = width - 4
       fixed = 3 + 2 + 1 + (@fields.size - 1) + 1
@@ -189,11 +185,8 @@ module ClaudeInbox
       @theme.hints(keys)
     end
 
-    # The App's `claude --bg` call failed after `:start`/`:start_and_attach`
-    # already handed the form off — an untrusted directory, a stale binary,
-    # a permissions error. The composed prompt is still here, so the form
-    # reopens on it with the reason shown instead of the App just logging
-    # the failure and losing the draft.
+    # The App's `claude --bg` call failed after a start. The form shows why,
+    # over the prompt it kept.
     def submission_failed(message)
       @busy = false
       @error = message

data/lib/claude_inbox/pull_requests.rb

@@ -169,7 +169,7 @@ module ClaudeInbox
     end
 
     def seed(url)
-      number = url[%r{/pull/(\d+)}, 1]&.to_i
+      number = url[%r{/(?:pull|-/merge_requests)/(\d+)}, 1]&.to_i
       cached = resolved[url] || claude_cache[url]
       PullRequest.new(number: cached&.dig("number") || number, url: url, state: cached&.dig("state"),
         resolved_at: cached&.dig("resolved_at"), title: cached&.dig("title"))

data/lib/claude_inbox/renderer.rb

@@ -7,13 +7,17 @@ require_relative "theme"
 require_relative "store"
 
 module ClaudeInbox
-  # sections -> Array<String> (one entry per terminal row, each exactly
-  # `width` columns wide) plus a parallel Array of selectable items.
-  # Pure: no terminal, no IO, no clock beyond the `now` it is handed.
+  # Turns the sections and a View into a Frame, every line exactly `width`
+  # columns. Pure: no terminal, no IO, no clock beyond the `now` it is handed.
   class Renderer
     Frame = Struct.new(:lines, :items, :top) do
       # The same frame for a terminal drawn without color.
-      def plain = self.class.new(lines.map { |l| Text.strip_ansi(l) }, items, top)
+      def plain = self.class.new(lines.map { |l| l.gsub(Text::CSI, "") }, items, top)
+
+      def link_at(row, col)
+        @links ||= lines.map { |l| Text.links(l) }
+        @links.fetch(row - 1, []).find { |link| link.columns.cover?(col - 1) }
+      end
     end
 
     CHROME_ROWS = 2 # header + footer
@@ -141,7 +145,7 @@ module ClaudeInbox
         bar = "█" * filled + "░" * (10 - filled)
         left = w.resets_at.to_i - now.to_i if resets && w.resets_at
         figure = left&.positive? ? "#{w.percent}% · #{Text.age(left)} left" : "#{w.percent}%"
-        "#{@p.dim(w.label)} #{@theme.public_send(usage_hue(w.percent), bar)} #{@p.dim(figure)}"
+        "#{@p.dim(w.label)} #{@theme.tint(usage_hue(w.percent), bar)} #{@p.dim(figure)}"
       end.join("  ")
     end
 
@@ -312,7 +316,7 @@ module ClaudeInbox
       chrome = 1 + 1 + 1 + 1 + 1 + 2 + Text.width(meta) + 2 + 1
       # Project is only cut once the label has given up all its space too,
       # so the row can never exceed `width` and fall into Text.pad's blind
-      # tail-chop (which used to land mid-project-name with no ellipsis).
+      # tail-chop.
       project_text = Text.truncate(s.project, [width - chrome, 0].max)
       project = quiet ? @p.dim(project_text) : @theme.cyan(project_text)
 
@@ -397,7 +401,7 @@ module ClaudeInbox
     def pr_badge(s, section)
       pr = s.pr
       return nil unless pr
-      badge = (section == :settled) ? @p.dim("#{pr.short} #{pr.state&.downcase}".strip) : @theme.pr_badge(pr)
+      badge = @theme.pr_badge(pr, quiet: section == :settled)
       more = (s.prs.size > 1) ? @p.dim(" · +#{s.prs.size - 1}") : ""
       badge + more
     end
@@ -416,8 +420,8 @@ module ClaudeInbox
     end
 
     # "working" while the agent is thinking, "idle" once it has stopped and
-    # only the work it kicked off is still open — with that work named either
-    # way, since "working · 2 agents" is the answer to "working on what?".
+    # only the work it kicked off is still open. Either way the work is
+    # named, since "working · 2 agents" answers "working on what?".
     def working_badge(s)
       return @theme.yellow("waiting#{": #{s.waiting_for}" if s.waiting_for}") if s.status == "waiting"
       label = s.job_state&.in_flight_label
@@ -431,12 +435,12 @@ module ClaudeInbox
 
     # ----- modal --------------------------------------------------------------
 
-    # Centre a block of lines over the frame.
     def overlay(lines, block, width)
       block_w = block.map { |l| Text.width(l) }.max || 0
       left = [(width - block_w) / 2, 0].max
       top = [(lines.size - block.size) / 2, 0].max
-      out = lines.dup
+      # Nothing behind a pop-up is clickable.
+      out = lines.map { |l| l.gsub(Text::LINK, "") }
       block.each_with_index do |bl, i|
         y = top + i
         next if y >= out.size

data/lib/claude_inbox/slash_commands.rb

@@ -4,13 +4,9 @@ require_relative "settings"
 
 module ClaudeInbox
   # The slash commands `claude` would offer at its own prompt, read from the
-  # same places it reads them: `.claude/commands/*.md` and
-  # `.claude/skills/*/SKILL.md` under the project and the home directory,
-  # the skills and commands of the plugins enabled there (named
-  # `plugin:name`), and the skills claude.ai syncs down
-  # (`anthropic-skills:name`). Built-ins live inside the CLI and are not
-  # listed; typing one still works, since the prompt goes to `claude --bg`
-  # verbatim.
+  # same places it reads them (docs/cli-quirks.md). Built-ins live inside
+  # the CLI and are not listed; typing one still works, since the prompt
+  # goes to `claude --bg` verbatim.
   #
   # Pure: filesystem in, plain values out. Nothing here runs `claude`.
   module SlashCommands
@@ -61,7 +57,6 @@ module ClaudeInbox
       end
     end
 
-    # "name", or "plugin:name" when it comes from a plugin.
     def qualify(prefix, name) = [prefix, name].compact.join(":")
 
     # `installed_plugins.json` maps "name@marketplace" to where the plugin
@@ -77,8 +72,6 @@ module ClaudeInbox
       end
     end
 
-    # claude.ai's synced skills sit in one bucket per account under
-    # ~/.claude/skills/synced and answer to the anthropic-skills prefix.
     def synced(home)
       Dir.glob(File.join(home, ".claude", "skills", "synced", "*", "")).flat_map do |bucket|
         skills(bucket, prefix: SYNCED_PLUGIN)

data/lib/claude_inbox/store/row.rb

@@ -54,10 +54,6 @@ module ClaudeInbox
       # Active rather than Settled, until the state changes again.
       def acknowledged? = unchanged_since?(entry&.acknowledged_at)
 
-      # Finished or needing you, so it carries a read or unread mark. Only a
-      # session you can attach to counts, since nothing else ever clears it.
-      def markable? = session.actionable? && (session.finished? || session.needs_you?)
-
       # Finished or needing you since you last attached.
       def unread?
         return false unless markable?
@@ -122,6 +118,10 @@ module ClaudeInbox
 
       private
 
+      # Finished or needing you, so it carries a read or unread mark. Only a
+      # session you can attach to counts, since nothing else ever clears it.
+      def markable? = session.actionable? && (session.finished? || session.needs_you?)
+
       def unchanged_since?(at) = at && entry.state_since.to_i <= at.to_i
     end
   end

data/lib/claude_inbox/subprocess.rb

@@ -1,10 +1,8 @@
 # frozen_string_literal: true
 
 module ClaudeInbox
-  # Runs a helper command with stdout/stderr captured, in its own session so
-  # it is not associated with our tty. Terminal.app (and others) put the
-  # "active process" of the tty in the tab title; without this the title
-  # flips to "claude" or "ps" on every poll.
+  # Runs a helper command with its output captured, in a session of its own
+  # so it never reaches the tab title (docs/cli-quirks.md).
   module Subprocess
     Result = Struct.new(:out, :err, :status) do
       def success? = status.success?

data/lib/claude_inbox/terminal.rb

@@ -6,10 +6,8 @@ require "tty-screen"
 require_relative "painter"
 
 module ClaudeInbox
-  # The screen the inbox draws on: the alt screen and the mouse and wheel
-  # modes that come and go with it, raw mode on the input, the cached size,
-  # and the Painter that diffs frames onto it. `release` hands the whole
-  # thing to a child that wants the tty and takes it back afterwards.
+  # The screen the inbox draws on, lent with `release` to a child that
+  # wants the tty.
   class Terminal
     ALT_ON = "\e[?1049h"
     ALT_OFF = "\e[?1049l"
@@ -19,13 +17,14 @@ module ClaudeInbox
     # know the mode ignore it and keep scrolling their own history.
     WHEEL_KEYS_ON = "\e[?1007h"
     WHEEL_KEYS_OFF = "\e[?1007l"
-    # Real mouse reporting: button events plus the SGR encoding, so clicks
-    # and wheel ticks arrive as escape sequences we parse ourselves (Mouse)
-    # instead of the terminal only ever translating the wheel to arrow
-    # keys. Terminals that don't understand either mode just ignore it and
-    # fall back to WHEEL_KEYS_ON's translation, or their own scrollback.
-    MOUSE_ON = "\e[?1000h\e[?1006h"
-    MOUSE_OFF = "\e[?1006l\e[?1000l"
+    # Any-motion events in the SGR encoding, which Mouse parses: the pointer
+    # moving too, so a link can take a hand pointer. A terminal that knows
+    # neither mode falls back to WHEEL_KEYS_ON, or its own scrollback.
+    MOUSE_ON = "\e[?1003h\e[?1006h"
+    MOUSE_OFF = "\e[?1006l\e[?1003l"
+    # OSC 22 sets the pointer's shape. Terminals without it ignore it.
+    POINTER = "\e]22;pointer\e\\"
+    POINTER_OFF = "\e]22;default\e\\"
     # Bracketed paste: what is pasted arrives fenced off from what is typed
     # (Paste), and a pasted image, which has no text, arrives as an empty
     # fence rather than not at all.
@@ -38,6 +37,7 @@ module ClaudeInbox
       @painter = Painter.new(out)
       @restored = true
       @size = nil
+      @over_link = false
     end
 
     # The tty's mode is kept as found, not assumed: `cooked!` sets a stock
@@ -54,12 +54,13 @@ module ClaudeInbox
       resized
     end
 
-    # Safe to call twice, and from at_exit: the second call is a no-op.
+    # Safe to call twice, and from at_exit.
     def restore
       return if @restored
       @restored = true
+      @over_link = false
       @input.console_mode = @mode if @mode && @input.tty?
-      @out.print TTY::Cursor.show, PASTE_OFF, MOUSE_OFF, WHEEL_KEYS_OFF, ALT_OFF
+      @out.print TTY::Cursor.show, POINTER_OFF, PASTE_OFF, MOUSE_OFF, WHEEL_KEYS_OFF, ALT_OFF
       @out.flush
     rescue
       nil
@@ -98,6 +99,13 @@ module ClaudeInbox
 
     def paint(lines) = @painter.paint(lines)
 
+    def pointer(over_link)
+      return if over_link == @over_link
+      @over_link = over_link
+      @out.print(over_link ? POINTER : POINTER_OFF)
+      @out.flush
+    end
+
     private
 
     def measure

data/lib/claude_inbox/text.rb

@@ -6,15 +6,42 @@ module ClaudeInbox
   # Width-aware string helpers. Never use String#[] on user-facing text:
   # session names carry emoji and glyphs that break byte/char slicing.
   module Text
-    ANSI = /\e\[[0-9;?]*[A-Za-z]/
+    # An OSC 8 hyperlink's opening or, with an empty url, its closing.
+    LINK = /\e\]8;[^;\e]*;[^\e]*\e\\/
+    CSI = /\e\[[0-9;?]*[A-Za-z]/
+    ANSI = /#{CSI}|#{LINK}/
     # A grapheme, or an escape that takes no column.
     GLYPH = /#{ANSI}|\X/
     ELLIPSIS = "…"
+    LINK_END = "\e]8;;\e\\"
 
     module_function
 
     def strip_ansi(s) = s.gsub(ANSI, "")
 
+    # The url comes from a transcript, so a control character in it is dropped.
+    def link(s, url) = "\e]8;;#{url.delete("\x00-\x1f\x7f")}\e\\#{s}#{LINK_END}"
+
+    Link = Data.define(:columns, :url, :text)
+
+    def links(s)
+      found = []
+      col = 0
+      start = url = text = nil
+      s.scan(GLYPH) do |g|
+        if g.start_with?("\e]8;")
+          found << Link.new(start...col, url, text) if url
+          url = g[/\A\e\]8;[^;\e]*;([^\e]+)/, 1]
+          start = col
+          text = +""
+        elsif !g.start_with?("\e")
+          text << g if url
+          col += Unicode::DisplayWidth.of(g)
+        end
+      end
+      found
+    end
+
     # Bytes that aren't UTF-8 become U+FFFD.
     def utf8(s) = String.new(s.to_s, encoding: Encoding::UTF_8).scrub("\uFFFD")
 
@@ -32,8 +59,8 @@ module ClaudeInbox
       take(s, w - width(ELLIPSIS)) << ELLIPSIS
     end
 
-    # First `n` columns, no ellipsis. Colors survive the cut, and a reset
-    # closes whichever one the cut left open.
+    # First `n` columns, no ellipsis. Colors and links survive the cut, and
+    # the cut closes whichever one it left open.
     def take(s, n)
       out = +""
       used = 0
@@ -43,6 +70,8 @@ module ClaudeInbox
         out << g
         used += gw
       end
+      last_link = out.scan(LINK).last
+      out << LINK_END if last_link && last_link != LINK_END
       (out.include?("\e") && !out.end_with?("\e[0m")) ? out << "\e[0m" : out
     end
 

data/lib/claude_inbox/text_buffer.rb

@@ -35,6 +35,8 @@ module ClaudeInbox
 
     def initialize(text = "")
       @widths = Hash.new { |h, s| h[s] = Text.width(s) }
+      @images = 0
+      @pastes = 0
       replace(text)
     end
 
@@ -77,11 +79,11 @@ module ClaudeInbox
 
     # Chips are numbered per kind and never reused, so a second image is
     # `[Image #2]` even after the first was deleted, as Claude Code does.
-    def attach(path) = place(Image.new(@images = (@images || 0) + 1, path))
+    def attach(path) = place(Image.new(@images += 1, path))
 
     def paste(text)
       return insert(text) if text.size <= FOLD_CHARS && text.count("\n") < FOLD_LINES
-      place(Pasted.new(@pastes = (@pastes || 0) + 1, text))
+      place(Pasted.new(@pastes += 1, text))
     end
 
     # Handles one keypress: readline's editing keys, plus printable text.

data/lib/claude_inbox/theme.rb

@@ -1,5 +1,7 @@
 # frozen_string_literal: true
 
+require_relative "text"
+
 module ClaudeInbox
   # Chrome hues tuned to Atom One Dark rather than the terminal profile's
   # own ANSI reds and greens. 256-color indices, since those render the
@@ -28,12 +30,16 @@ module ClaudeInbox
 
     # "#885 open", or "#885 open · ✗ checks" when something is wrong.
     # `name` replaces the bare number where that would be ambiguous.
-    def pr_badge(pr, name = pr.short)
-      return dim(name) unless PR_HUES.key?(pr.state)
-      badge = tint(PR_HUES[pr.state], "#{name} #{pr.state.downcase}")
-      pr.trouble ? badge + dim(" · ") + tint(PR_TROUBLE_HUES[pr.health], pr.trouble) : badge
+    def pr_badge(pr, name = pr.short, quiet: false)
+      hue = PR_HUES[pr.state] unless quiet
+      linked = Text.link(underline(tint(hue, name)), pr.url)
+      return linked unless PR_HUES.key?(pr.state)
+      badge = linked + tint(hue, " #{pr.state.downcase}")
+      (pr.trouble && !quiet) ? badge + dim(" · ") + tint(PR_TROUBLE_HUES[pr.health], pr.trouble) : badge
     end
 
+    def underline(text) = "\e[4m#{text}\e[24m"
+
     # A filled pill: editor-background text on the hue, for a selected row
     # or choice — the inverse of `color`, which puts the hue on the text.
     def pill(text, hue) = "\e[38;5;#{BG};48;5;#{HUES.fetch(hue)}m#{text}\e[0m"

data/lib/claude_inbox/updater.rb

@@ -133,7 +133,7 @@ module ClaudeInbox
     # clone follows the fork.
     def fetch_upstream
       remote = git("config", "branch.main.remote") or raise Error, "main tracks no remote"
-      fetched = @run.call("git", "-C", @root, "fetch", "--quiet", remote)
+      fetched = run_git("fetch", "--quiet", remote)
       raise Error, "git fetch #{remote} failed: #{fetched.err.strip}" unless fetched.success?
       git("rev-parse", "main@{upstream}") or raise Error, "main tracks no remote"
     end
@@ -142,12 +142,14 @@ module ClaudeInbox
       branch = git("symbolic-ref", "--short", "HEAD")
       return Applied.new(success: false, output: "not on main (on #{branch})") unless branch == "main"
       return Applied.new(success: false, output: "the working tree is dirty") unless git("status", "--porcelain") == ""
-      merged = @run.call("git", "-C", @root, "merge", "--ff-only", "--quiet", "main@{upstream}")
+      merged = run_git("merge", "--ff-only", "--quiet", "main@{upstream}")
       Applied.from(merged)
     end
 
+    def run_git(*args) = @run.call("git", "-C", @root, *args)
+
     def git(*args)
-      result = @run.call("git", "-C", @root, *args)
+      result = run_git(*args)
       result.out.strip if result.success?
     end
 

data/lib/claude_inbox/vt_screen.rb

@@ -2,6 +2,7 @@
 
 require "strscan"
 require "unicode/display_width"
+require_relative "text"
 
 module ClaudeInbox
   # A deliberately small cursor-addressed screen model that turns captured
@@ -22,7 +23,7 @@ module ClaudeInbox
     end
 
     def feed(str)
-      ss = StringScanner.new(str.dup.force_encoding("UTF-8").scrub)
+      ss = StringScanner.new(Text.utf8(str))
       until ss.eos?
         if ss.scan(CSI)
           csi(ss[1], ss[2])

data/lib/claude_inbox.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module ClaudeInbox
-  VERSION = "0.13.0"
+  VERSION = "0.14.0"
 end

data/mod/hooks/register.tsx

@@ -335,7 +335,7 @@ export const register: Register = (on, options) => {
   })
 
   on('ui.render', { component: 'Pane', requestId: PANE }, async ($, e) => {
-    const { Box, Text, Button } = $.ui.resolve(e)
+    const { Box, Text, Button, Link } = $.ui.resolve(e)
     const list = await read($, rows)
     const viewing = await read($, current)
     const folded = await read($, folds)
@@ -497,9 +497,16 @@ export const register: Register = (on, options) => {
                     {/* The label gives up its cells to the PR chip, which would otherwise wrap under it. */}
                     {one.pr ? (
                       <Box flexShrink={0}>
+                        <Box key={`pr:${itemKey(item)}`} marginLeft={1} hover={{ backgroundColor: 'subtle' }}>
+                          <Link href={one.pr.url}>
+                            <Text underline color={isQuiet ? undefined : PR_COLOR[one.pr.state]} dimColor={isQuiet}>
+                              {one.pr.short}
+                            </Text>
+                          </Link>
+                        </Box>
                         <Text color={isQuiet ? undefined : PR_COLOR[one.pr.state]} dimColor={isQuiet}>
                           {' '}
-                          {one.pr.short} {one.pr.state}
+                          {one.pr.state}
                         </Text>
                       </Box>
                     ) : null}

data/mod/tests/pane.test.tsx

@@ -129,7 +129,8 @@ test("rows sit under the gem's sections, Settled folded until za opens it", asyn
     expect((await ui.findAll({ type: 'Text', text: '● ' })).filter(dot => dot.props.color === 'blue')).toHaveLength(1)
     expect((await ui.find({ type: 'Text', text: 'finished unseen' }))?.props.bold).toBe(true)
     expect(await ui.find({ type: 'Text', text: 'still going' })).toBeUndefined()
-    expect(await ui.find({ type: 'Text', text: /#7 open/ })).toBeDefined()
+    expect((await ui.find({ type: 'Link' }))?.props.href).toBe('https://github.com/o/r/pull/7')
+    expect((await ui.find({ type: 'Text', text: '#7' }))?.props.underline).toBe(true)
     expect(await ui.find({ text: /1 folded/ })).toBeDefined()
     expect(await ui.find({ text: /put away/ })).toBeUndefined()
     await ui.press({ key: 'g' })

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: claude-inbox
 version: !ruby/object:Gem::Version
-  version: 0.13.0
+  version: 0.14.0
 platform: ruby
 authors:
 - Jordan Byron
@@ -9,6 +9,20 @@ bindir: exe
 cert_chain: []
 date: 1980-01-02 00:00:00.000000000 Z
 dependencies:
+- !ruby/object:Gem::Dependency
+  name: optparse
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0.5'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0.5'
 - !ruby/object:Gem::Dependency
   name: tty-cursor
   requirement: !ruby/object:Gem::Requirement