claude-inbox 0.13.0 → 0.13.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: f8b8a6141fcc9efc19386143e9412d4ebab669e73350ee42205e6a07fd05b290
-  data.tar.gz: 412882713110008db6ff1d96fe8b786e5d61e82ea9b349202c12560f290a86b3
+  metadata.gz: 36fa381f8d03173896c6b44dff47534ed54119c9ff529833a9783c7f5c524506
+  data.tar.gz: '0386da94a6ffa5259bbad165857821f44b082dc5a64d957beae352c46dc61100'
 SHA512:
-  metadata.gz: f87a453630132a470dc22b345e8f611ae0e58f04bc877c52ee1c53c4358a306377529a10ae8d807058dc32e1c9d039fc2480dd962a89d382a16e00d35faf6908
-  data.tar.gz: de74aeac784fdc777336fdaa4db38cfae93e7458873809e2c3e52c0a5a69dc53d2391cec86d73e2d52882ad9634c4567553f3d6151e2c40c571a7eca0abc8db5
+  metadata.gz: bb933d5723ee131285824d2faea2570762854a4695da2ecd98716d5b9d981b2b36aece7abbda8acf92fa063b47f52f40ac2931136ef5fecee194f0fda7cdc72c
+  data.tar.gz: 3593591f4192056035fdc13e3480a26824794be46df0d8aa5b72fdb5c84a4b6b039d658b4279ec64cdf35ec94c2d65533117321c01bdd9b3e06a4267571a83b6

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.rb

@@ -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
@@ -264,7 +264,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)
@@ -283,7 +283,7 @@ module ClaudeInbox
       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
+      dt = monotonic - t0
       Debug.log("render #{(dt * 1000).round}ms") if dt > 0.05
     end
 
@@ -309,11 +309,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,11 +28,11 @@ 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 key(name) = @theme.cyan_bold(name)
 
     # A key and what it does.
@@ -83,10 +83,6 @@ 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
-
       def lines(width, _caret)
         (@prs.each_with_index.map { |pr, i| "  #{key((i + 1).to_s)}  #{label(pr)}" } +
           ["", "  #{hint(KEYS.fetch(kind), "#{kind} #{@prs.first.short}")} · #{key("esc")} #{@theme.dim("cancel")}"])
@@ -102,6 +98,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)

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/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/renderer.rb

@@ -7,9 +7,8 @@ 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.
@@ -141,7 +140,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 +311,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)
 
@@ -416,8 +415,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,7 +430,6 @@ 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

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,11 +17,8 @@ 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.
+    # Button events in the SGR encoding, which Mouse parses. A terminal that
+    # knows neither mode falls back to WHEEL_KEYS_ON, or its own scrollback.
     MOUSE_ON = "\e[?1000h\e[?1006h"
     MOUSE_OFF = "\e[?1006l\e[?1000l"
     # Bracketed paste: what is pasted arrives fenced off from what is typed
@@ -54,7 +49,7 @@ 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

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/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.13.1"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: claude-inbox
 version: !ruby/object:Gem::Version
-  version: 0.13.0
+  version: 0.13.1
 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