claude-inbox 0.5.0 → 0.6.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 150bc4c5ae639139680ad48d476e0628faa82e89e77e783fb1ac9b2ac34ab25f
-  data.tar.gz: c40bbe7c0a955ba01edc66014b3b2ff9d8b80eb70d3b6ea4a9345495a69af011
+  metadata.gz: b325ed415502366088de4b6e9b7634835aea1fb0a6be708e211344dfeba8fa33
+  data.tar.gz: 53fbfbeac341e7f5643724911eb5feecb4165a6aaa367dad73c2a4002be9bee9
 SHA512:
-  metadata.gz: 1168c17b14d49071580d1c8565eff838a8c5229e339de5cbbd3f90ed78274973cbe1b1b0f3d21b89c4734142029630a1cb9ea8b03932655d22d151a3447faaf8
-  data.tar.gz: 7a6fb8224d67ae2ff94136d9615bb1a5caf12b7430031c5d221fde12a46357aef6f7ffd223f2ab725fb15d3797458ddb7f6cd824d890a01b3b525c0dbc8e3f1b
+  metadata.gz: 072a5ce3e44c1e5317d105fd49aea27fc5e1365c146c165e8ad87b61b50c24f0046bd659278a41b3848ec15523c1eaa255748f5f080a4e26b25476ba6f7e1218
+  data.tar.gz: 31715b40f83b6749d3064c323018c74f62e1176f248bcc00b3cf16769b81c202b49cb0e7228e3ca8bd3b5519c8d7ca99001c026868d29605b488430a6662f5eb

data/README.md

@@ -18,6 +18,8 @@ gem install claude-inbox
 claude-inbox
 ```
 
+`claude-inbox update` installs the latest release.
+
 Put arguments you want on every launch in `~/.config/claude-inbox/config`.
 
 To add the pane to every Claude Code session:
@@ -26,6 +28,7 @@ To add the pane to every Claude Code session:
 claude-inbox install
 ```
 
+The inbox offers to do this once, the first time it starts without the pane.
 `claude-inbox install --force` also replaces any other copy of the pane.
 
 ## Claude Code pane
@@ -37,7 +40,7 @@ a fullscreen terminal.
 
 `/inbox` opens it, `ctrl+x tab` focuses it and `esc` leaves. The keys are the
 ones below, with `ge` for `G`, `n` `p` for `Tab` `Shift+Tab`, and no `a`,
-`P`, `X`, `Ctrl-x`, `/` or `R`. `Enter`, or a click on a row, switches to the
+`P`, `X`, `Ctrl-x`, `/`, `R` or `U`. `Enter`, or a click on a row, switches to the
 session when you attached through `claude-inbox`.
 
 It opens when a session starts. To stop that, set
@@ -88,6 +91,7 @@ Vim bindings. Arrows and the mouse work too.
 | `Ctrl-x` | delete the session, transcript and worktree for good |
 | `/` | filter; `Enter` keeps it, `Esc` clears |
 | `R` | poll now |
+| `U` | update claude-inbox when the header says a newer one is out |
 | `q` | quit |
 
 `X` and `Ctrl-x` both ask for `y` first.
@@ -95,8 +99,9 @@ Vim bindings. Arrows and the mouse work too.
 ### New session
 
 `n` opens a form for the prompt, name, directory, model, effort, permissions,
-worktree and Remote Control. `Tab` moves between fields, `Ctrl-S` starts the
-session and `Ctrl-O` starts it and attaches.
+worktree, Remote Control and color, which tints the row as `/color` would.
+`Tab` moves between fields, `Ctrl-S` starts the session and `Ctrl-O` starts
+it and attaches.
 
 Paste an image on macOS, or drop a file into the prompt, and refer to it as
 `[Image #1]`. Type `/` for a menu of your skills.

data/exe/claude-inbox

@@ -29,8 +29,28 @@ if ARGV.first == "install"
   exit
 end
 
+if ARGV.first == "update"
+  require "claude_inbox/updater"
+  updater = ClaudeInbox::Updater.new
+  begin
+    update = updater.check(force: true)
+  rescue ClaudeInbox::Updater::Error => e
+    abort "claude-inbox: #{e.message}"
+  end
+  unless update
+    puts((updater.kind == :gem) ? "claude-inbox #{ClaudeInbox::VERSION} is the latest release." : "main is up to date.")
+    exit
+  end
+  puts update.installing
+  applied = updater.apply
+  abort "claude-inbox: #{applied.output.strip}" unless applied.success?
+  puts((update.kind == :gem) ? "Installed claude-inbox #{update.latest}." : "main is at #{update.latest}.")
+  exit
+end
+
 require "claude_inbox/app"
 require "claude_inbox/config"
+require "claude_inbox/updater"
 require "claude_inbox/writer_lock"
 require "tmpdir"
 
@@ -70,14 +90,27 @@ else
   opts[:snapshot] = ClaudeInbox::Snapshot.new
   opts[:switch] = ClaudeInbox::Switch.new
   opts[:actions] = ClaudeInbox::Actions.new
+  opts[:pane_offer] = ClaudeInbox::Mod::Offer.new
   opts[:listen] = listen
+  opts[:updater] = ClaudeInbox::Updater.new unless argv.include?("--no-update-check")
+  # The typed arguments, not the config's: a relaunch reads the config again.
+  opts[:argv] = ARGV
 end
 opts[:color] = false if argv.include?("--no-color")
 
 if argv.include?("--headless")
   abort "claude-inbox: --headless takes no --fixture" if fixture
   require "claude_inbox/headless"
-  exit(ClaudeInbox::Headless.new(client: opts[:client], store: opts[:store]).run ? 0 : 1)
+  exit(ClaudeInbox::Headless.new(client: opts[:client], store: opts[:store], updater: opts[:updater]).run ? 0 : 1)
+end
+
+# Only what a check within the day already found: a cold launch never waits
+# on the network. The relaunch is the new version's launch; a failure leaves
+# this one to start as usual.
+if argv.include?("--auto-update") && (update = opts[:updater]&.cached)
+  puts update.installing
+  applied = opts[:updater].apply
+  applied.success? ? opts[:updater].relaunch(ARGV) : warn("claude-inbox: #{applied.output.strip}")
 end
 
 # The first inbox you can see is the snapshot's writer: a headless one gives
@@ -89,6 +122,7 @@ unless writer_lock.take(role: "inbox")
   opts[:reaper] = ClaudeInbox::Reaper.disabled
   opts[:snapshot] = ClaudeInbox::Snapshot.disabled
   opts[:actions] = ClaudeInbox::Actions.disabled
+  opts[:pane_offer] = ClaudeInbox::Mod::Offer.disabled
 end
 # So the pane settings.json names is the installed version's, after a gem update too.
 ClaudeInbox::Mod.link unless fixture

data/lib/claude_inbox/actions.rb

@@ -11,7 +11,6 @@ module ClaudeInbox
   # the store cannot honour after that, or a verb it lacks, is dropped.
   class Actions
     DEFAULT_DIR = File.join(Dir.home, ".config", "claude-inbox", "actions")
-    VERBS = %w[settle wake pin snooze acknowledge].freeze
     SNOOZES = %w[m15 h1 tomorrow_9am until_woken].freeze
     # A file still being written parses as nothing for milliseconds; a
     # session not yet polled appears within one poll.
@@ -62,12 +61,14 @@ module ClaudeInbox
     def parse(path)
       request = JSON.parse(File.read(path))
       request = {} unless request.is_a?(Hash)
-      return request if File.mtime(path) < @clock.call - GRACE
+      return request if stale?(path)
       (request.key?("id") && request.key?("action")) ? request : nil
     rescue JSON::ParserError
-      (File.mtime(path) < @clock.call - GRACE) ? {} : nil
+      stale?(path) ? {} : nil
     end
 
+    def stale?(path) = File.mtime(path) < @clock.call - GRACE
+
     def young?(request)
       at = request["at"].to_i / 1000
       at.positive? && Time.at(at) >= @clock.call - GRACE
@@ -75,7 +76,7 @@ module ClaudeInbox
 
     def apply(store, request, keys)
       id = request["id"]
-      return false unless keys.include?(id) && VERBS.include?(request["action"])
+      return false unless keys.include?(id)
       case request["action"]
       when "settle" then store.settle(id)
       when "wake" then store.wake(id)
@@ -84,6 +85,8 @@ module ClaudeInbox
       when "snooze"
         return false unless SNOOZES.include?(request["choice"])
         store.snooze(id, request["choice"].to_sym)
+      else
+        return false
       end
       true
     end

data/lib/claude_inbox/agents_client.rb

@@ -59,17 +59,23 @@ module ClaudeInbox
       watchdog&.kill
     end
 
-    def stop(id) = run(@bin, "stop", id)
+    def stop(id) = run("stop", id)
 
-    def rm(id) = run(@bin, "rm", id)
+    def rm(id) = run("rm", id)
 
     MODELS = %w[default fable opus sonnet haiku].freeze
     EFFORTS = %w[default low medium high xhigh max].freeze
     PERMISSION_MODES = %w[default acceptEdits auto plan bypassPermissions].freeze
-
-    # Start a background session. Returns its short id.
-    def spawn(prompt:, cwd:, **opts)
-      start_bg(self.class.spawn_args(@bin, prompt: prompt, **opts), cwd, "claude --bg")
+    # The colors `/color` offers, in its order.
+    COLORS = %w[default red blue green yellow purple orange pink cyan].freeze
+
+    # Start a background session. Returns its short id. `claude --bg` takes
+    # no color, and `/color` refuses a prompt after the color, so the color
+    # goes into the job file the way `/color` would put it there.
+    def spawn(prompt:, cwd:, color: nil, **opts)
+      id = start_bg(self.class.spawn_args(@bin, prompt: prompt, **opts), cwd, "claude --bg")
+      JobState.write_color(id, color, jobs_dir: @jobs_dir) if color
+      id
     end
 
     # How a prompt attaches a file: the same @ mention the CLI's own prompt
@@ -239,10 +245,9 @@ module ClaudeInbox
       nil
     end
 
-    def run(*argv)
-      r = Subprocess.capture(*argv)
-      raise Error, "#{argv[1]} failed: #{r.err.strip}" unless r.success?
-      true
+    def run(verb, id)
+      r = Subprocess.capture(@bin, verb, id)
+      raise Error, "#{verb} failed: #{r.err.strip}" unless r.success?
     end
 
     def start_bg(argv, cwd, what)
@@ -275,7 +280,7 @@ module ClaudeInbox
     # terminal round-trips through cooked mode and back.
     def attach(id) = system("sh", "-c", "printf 'fake attach to %s\\npress enter to detach: ' \"$1\"; read -r _", "attach", id)
 
-    def stop(_id) = true
+    def stop(_id) = nil
 
     def spawn(prompt:, cwd:, **)
       sleep 0.5
@@ -284,6 +289,6 @@ module ClaudeInbox
 
     def adopt(session_id:, cwd:, pid:) = "adop7ed0"
 
-    def rm(_id) = true
+    def rm(_id) = nil
   end
 end

data/lib/claude_inbox/app.rb

@@ -24,6 +24,8 @@ require_relative "actions"
 require_relative "snapshot"
 require_relative "switch"
 require_relative "trust"
+require_relative "mod"
+require_relative "updater"
 
 module ClaudeInbox
   # Owns the terminal and the key loop. The only class allowed to spawn a
@@ -33,14 +35,17 @@ module ClaudeInbox
     # so both are off unless `bin/claude-inbox` switches them on.
     def initialize(client: AgentsClient.new, store: Store.new, pull_requests: PullRequests.new,
       rate_limits: RateLimits.new, reaper: Reaper.disabled, snapshot: Snapshot.disabled, switch: Switch.disabled,
-      actions: Actions.disabled, listen: nil, out: $stdout, input: $stdin, color: true, trust: Trust.method(:projects),
-      terminal: Terminal.new(out, input), queue: Queue.new)
+      actions: Actions.disabled, listen: nil, updater: nil, argv: [], out: $stdout, input: $stdin, color: true,
+      trust: Trust.method(:projects), terminal: Terminal.new(out, input), queue: Queue.new, pane_offer: Mod::Offer.disabled)
       @client = client
       @store = store
       @snapshot = snapshot
       @switch = switch
       @rate_limits = rate_limits
       @terminal = terminal
+      @updater = updater
+      @argv = argv
+      @out = out
       @color = color
       @trust = trust
       @renderer = Renderer.new(color: color)
@@ -65,6 +70,8 @@ module ClaudeInbox
       @last_poll = nil
       @quit = false
       @resize = false
+      @pane_offer = pane_offer
+      @modal = Dialog::PaneOffer.new if pane_offer.take
     end
 
     def run
@@ -83,6 +90,7 @@ module ClaudeInbox
     end
 
     def step(input = nil)
+      check_for_update unless @update_status
       drain_queue
       @logs.tick
       if @resize
@@ -124,6 +132,7 @@ module ClaudeInbox
           @error = nil
         when :error then @error = rest[0]
         when :notice then notice(rest[0])
+        when :update then update_checked(*rest)
         when :select then @pending_select = rest[0]
         when :attach then attach(rest[0])
         when :form_started then @modal = nil if @modal.equal?(rest[0])
@@ -131,8 +140,6 @@ module ClaudeInbox
         when :remote_started then remote_started(*rest)
         end
       end
-    rescue ThreadError
-      nil
     end
 
     # ----- main loop --------------------------------------------------------
@@ -208,7 +215,49 @@ module ClaudeInbox
     def status_text(now)
       return @notice[0] if @notice && now < @notice[1]
       return "⚠ #{@error}" if @error
-      "polling…" unless @last_poll
+      return "polling…" unless @last_poll
+      "#{@update.notice} · U updates" if @update
+    end
+
+    # ----- updates ----------------------------------------------------------
+
+    # Once, on the first step: a stale cache means a network round trip, so
+    # it runs off the main thread. A laptop that is offline stays quiet
+    # rather than show an error at every launch; U says what went wrong.
+    def check_for_update
+      @update_status = @updater ? "checking for updates…" : "update check is off — claude-inbox update installs the latest"
+      return unless @updater
+      in_background do
+        @queue << [:update, @updater.check]
+      rescue Updater::Error => e
+        @queue << [:update, nil, e.message]
+      end
+    end
+
+    def update_checked(update, failure = nil)
+      @update = update
+      @snapshot.update = update&.notice
+      @update_status = failure ? "couldn't check for updates: #{failure}" : "up to date"
+    end
+
+    # The install prints on the real screen, and the relaunch replaces this
+    # process. A failed install relaunches this version instead, once its
+    # error has been read, rather than leave the shell showing.
+    def update_inbox
+      return notice(@update_status) unless @update
+      @terminal.release do
+        @out.puts @update.installing
+        applied = @updater.apply
+        @out.puts applied.output unless applied.output.empty?
+        @terminal.pause unless applied.success?
+        relaunch
+      end
+    end
+
+    def relaunch
+      @updater.relaunch(@argv)
+    rescue SystemCallError => e
+      @error = "relaunch failed: #{e.message}"
     end
 
     def filtered(sections = @store.sections) = sections.matching(@filter&.to_s)
@@ -227,7 +276,7 @@ module ClaudeInbox
 
     def select(selection)
       @selected = selection
-      @peek.select(selection, selected_session)
+      @peek.select(selected_session)
     end
 
     def session_for(key) = @store.sessions.find { |s| s.key == key }
@@ -349,6 +398,7 @@ module ClaudeInbox
       when :stop then open_confirm(:stop)
       when :delete then open_confirm(:delete)
       when :refresh then @poller.soon
+      when :update then update_inbox
       when :toggle_peek then toggle_peek
       when :new_session then open_new_session
       when :remote_pairing then @modal = @listener.pairing_dialog
@@ -538,6 +588,7 @@ module ClaudeInbox
         when :stop then stop_session(id)
         when :delete then delete_session(id)
         when :adopt then adopt_session(id)
+        when :install then install_pane
         end
       when :save then save_prompt
       when :copy then @listener.copy_pairing_url
@@ -576,6 +627,13 @@ module ClaudeInbox
       end
     end
 
+    def install_pane
+      @pane_offer.install
+      notice("added the pane — new Claude Code sessions load it; /inbox opens it")
+    rescue JSON::ParserError
+      notice("~/.claude/settings.json is not valid JSON, so it was left alone")
+    end
+
     def delete_session(id)
       notice("deleting #{id}…")
       in_background do

data/lib/claude_inbox/dialog.rb

@@ -1,6 +1,7 @@
 # frozen_string_literal: true
 
 require "tty-box"
+require_relative "text"
 require_relative "text_buffer"
 
 module ClaudeInbox
@@ -78,6 +79,45 @@ module ClaudeInbox
       end
     end
 
+    # The first launch without the Claude Code pane asks once whether to add
+    # it, and has to say what the pane is to someone who has never seen it.
+    class PaneOffer < Confirm
+      WIDTH = 60
+      SKETCH = [
+        "  ┌──────────────────────────┬─────────────────────┐",
+        "  │ > fix the flaky spec     │ 📥 Inbox            │",
+        "  │                          │ ● needs you   docs  │",
+        "  │ Reading app.rb…          │ ⠋ working     api   │",
+        "  │                          │ ✓ done        auth  │",
+        "  └──────────────────────────┴─────────────────────┘"
+      ].freeze
+
+      def initialize = super(:install, nil)
+
+      def title = " ✨ The inbox, inside Claude Code "
+
+      # Drawn by hand: TTY::Box measures an emoji as one column, which
+      # 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}┘"]
+      end
+
+      def lines(_width, _caret)
+        ["", *SKETCH, "",
+          "  • Every session, docked beside the transcript",
+          "  • Switch sessions without leaving the one you're in",
+          "  • Snooze, pin and settle with the same keys",
+          "  • /inbox opens it, ctrl+x tab focuses it",
+          "",
+          "  You can install this later with claude-inbox install",
+          "",
+          "      y  add it to Claude Code      esc  not now"]
+      end
+    end
+
     # `a` alias and `P` pull request: one line of text, read from `value`
     # once :save comes back. Empty means clear.
     class Prompt < Dialog

data/lib/claude_inbox/headless.rb

@@ -5,6 +5,7 @@ require_relative "poller"
 require_relative "pull_requests"
 require_relative "reaper"
 require_relative "snapshot"
+require_relative "updater"
 require_relative "writer_lock"
 
 module ClaudeInbox
@@ -13,18 +14,34 @@ module ClaudeInbox
   # reaps, since deleting sessions stays with the inbox you can see, and it
   # exits at once while an inbox holds the writer lock.
   class Headless
-    def initialize(client:, store:, lock: WriterLock.new)
+    def initialize(client:, store:, pull_requests: PullRequests.new, actions: Actions.new, snapshot: Snapshot.new,
+      lock: WriterLock.new, updater: nil)
       @lock = lock
+      @snapshot = snapshot
+      @updater = updater
       @queue = Queue.new
-      @poller = Poller.new(client: client, store: store, pull_requests: PullRequests.new, reaper: Reaper.disabled,
-        queue: @queue, snapshot: Snapshot.new, actions: Actions.new)
+      @poller = Poller.new(client: client, store: store, pull_requests: pull_requests, reaper: Reaper.disabled,
+        queue: @queue, snapshot: snapshot, actions: actions)
     end
 
     # False when the lock is held, by an inbox or another headless process.
     def run
       return false unless @lock.take(role: "headless")
       @poller.start
+      check_for_update if @updater
       loop { @queue.pop }
     end
+
+    private
+
+    # After the poller is off, since the check may wait on the network. The
+    # pane cannot swap the process under Claude Code, so the snapshot only
+    # says a newer one is out, and a check that cannot tell says nothing.
+    def check_for_update
+      @snapshot.update = @updater.check&.notice
+      @poller.soon
+    rescue Updater::Error
+      nil
+    end
   end
 end

data/lib/claude_inbox/images.rb

@@ -41,7 +41,7 @@ module ClaudeInbox
     # `index` orders the images one request brings; the random part keeps
     # two requests saving in the same millisecond apart. Readable by the
     # owner only: a photo can be anything.
-    def self.save(bytes, dir: DEFAULT_DIR, now: Time.now, index: 1)
+    def self.save(bytes, dir:, index:, now: Time.now)
       data = bytes.b
       ext = extension(data)
       raise Unsupported, "not a PNG, JPEG, GIF or WebP image" unless ext

data/lib/claude_inbox/job_state.rb

@@ -4,7 +4,8 @@ require "json"
 
 module ClaudeInbox
   # What the daemon writes about a background session in
-  # ~/.claude/jobs/<id>/state.json. The only reader of that file.
+  # ~/.claude/jobs/<id>/state.json. The only reader of that file, and the
+  # only writer: a new session's color.
   #
   # `claude agents --json` reports one word, `state`, and "working" covers two
   # different situations: the agent is thinking, or the agent is idle and
@@ -50,6 +51,19 @@ module ClaudeInbox
       nil
     end
 
+    # The job file is there by the time `claude --bg` returns, and the daemon
+    # updates it read-modify-write, so the color stays through work, stop and
+    # respawn (checked on 2.1.296). A color is cosmetic: failing to write one
+    # must not report a started session as failed.
+    # ponytail: a daemon write racing this one can drop the color; re-apply on poll if that shows up.
+    def self.write_color(id, color, jobs_dir:)
+      path = File.join(jobs_dir, id, "state.json")
+      File.write("#{path}.tmp", JSON.generate(JSON.parse(File.read(path)).merge("color" => color)))
+      File.rename("#{path}.tmp", path)
+    rescue JSON::ParserError, SystemCallError
+      nil
+    end
+
     attr_reader :pr_urls, :color, :intent, :bridge_id
 
     def initialize(hash)
@@ -59,7 +73,7 @@ module ClaudeInbox
       @tempo = hash["tempo"]
       @kinds = (hash["fan"] || []).filter_map { |f| f["kind"] }
       @tasks = (hash["inFlight"] || {})["tasks"].to_i
-      @pr_urls = (hash["children"] || []).select { |c| c["kind"] == "pr" && c["href"] }.map { |c| c["href"] }
+      @pr_urls = (hash["children"] || []).filter_map { |c| c["href"] if c["kind"] == "pr" }
       @color = hash["color"]
       @intent = hash["intent"]
       @bridge_id = hash["bridgeSessionId"]

data/lib/claude_inbox/keymap.rb

@@ -27,7 +27,7 @@ module ClaudeInbox
       "s" => :snooze, "u" => :wake, "a" => :alias, "x" => :settle, "X" => :stop,
       :ctrl_x => :delete,
       "o" => :open_pr, "P" => :link_pr, "t" => :toggle_pin, "w" => :open_remote,
-      "R" => :refresh, "p" => :toggle_peek, "n" => :new_session, "N" => :remote_pairing,
+      "R" => :refresh, "U" => :update, "p" => :toggle_peek, "n" => :new_session, "N" => :remote_pairing,
       :tab => :next_section, :back_tab => :prev_section,
       "/" => :filter, :escape => :escape,
       "q" => :quit, :ctrl_c => :quit

data/lib/claude_inbox/logs.rb

@@ -30,7 +30,6 @@ module ClaudeInbox
     end
 
     def want(id)
-      return if id.nil?
       @pending = id
       @pending_at = @clock.call
     end

data/lib/claude_inbox/mod.rb

@@ -11,6 +11,7 @@ module ClaudeInbox
     DIR = File.expand_path("../../mod", __dir__)
     LINK = File.join(Dir.home, ".config", "claude-inbox", "mod")
     NAME = "inbox-pane"
+    SETTINGS = File.join(Dir.home, ".claude", "settings.json")
     CHECKOUT = File.exist?(File.expand_path("../../.git", __dir__))
     # What the pane runs headless: a checkout's own, or the gem's from PATH.
     COMMAND = CHECKOUT ? File.expand_path("../../bin/claude-inbox", __dir__) : nil
@@ -38,7 +39,7 @@ module ClaudeInbox
     # drops the other folders holding this plugin, such as a worktree's, and
     # sets the command the pane runs to this copy's. Raises JSON::ParserError
     # rather than rewrite a settings file it cannot read.
-    def self.install(settings: File.join(Dir.home, ".claude", "settings.json"), link: LINK, dir: DIR, force: false, command: COMMAND)
+    def self.install(settings: SETTINGS, link: LINK, dir: DIR, force: false, command: COMMAND)
       self.link(link: link, dir: dir, force: true)
       json = File.exist?(settings) ? JSON.parse(File.read(settings)) : {}
       env = json["env"] ||= {}
@@ -61,6 +62,40 @@ module ClaudeInbox
       installed
     end
 
+    # Whether any folder in CLAUDE_CODE_PLUGIN_DIRS holds the pane, a
+    # worktree's included. A settings file it cannot read counts as yes, since
+    # install would refuse to touch it.
+    def self.installed?(settings: SETTINGS)
+      json = File.exist?(settings) ? JSON.parse(File.read(settings)) : {}
+      json.dig("env", "CLAUDE_CODE_PLUGIN_DIRS").to_s.split(File::PATH_SEPARATOR).any? { |d| plugin?(d.strip) }
+    rescue JSON::ParserError, Errno::EACCES
+      true
+    end
+
+    # Asks once, on the first launch that finds the pane missing, whether to
+    # add it. Whatever the answer, a marker file keeps it from asking again.
+    class Offer
+      MARKER = File.join(Dir.home, ".config", "claude-inbox", "pane-offered")
+
+      def self.disabled = new(marker: nil)
+
+      def initialize(marker: MARKER, settings: SETTINGS, link: LINK)
+        @marker = marker
+        @settings = settings
+        @link = link
+      end
+
+      # True once: the first time it is asked while the pane is missing.
+      def take
+        return false if @marker.nil? || File.exist?(@marker) || Mod.installed?(settings: @settings)
+        FileUtils.mkdir_p(File.dirname(@marker))
+        FileUtils.touch(@marker)
+        true
+      end
+
+      def install = Mod.install(settings: @settings, link: @link)
+    end
+
     def self.plugin?(folder)
       JSON.parse(File.read(File.join(folder, ".claude-plugin", "plugin.json")))["name"] == NAME
     rescue Errno::ENOENT, Errno::ENOTDIR, Errno::EACCES, JSON::ParserError

data/lib/claude_inbox/mouse.rb

@@ -14,7 +14,7 @@ module ClaudeInbox
     # "esc gg" glues onto one read (see App#split_keys), so this scans
     # rather than matching once.
     def self.events(raw)
-      raw.to_s.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, col.to_i) if kind
       end

data/lib/claude_inbox/new_session_form.rb

@@ -3,6 +3,7 @@
 require "pastel"
 require_relative "agents_client"
 require_relative "images"
+require_relative "palette"
 require_relative "session_request"
 require_relative "settings"
 require_relative "slash_commands"
@@ -37,19 +38,21 @@ module ClaudeInbox
     def initialize(cwd:, color:, dirs: [], home: Dir.home, clipboard: Images.method(:from_clipboard))
       @p = Pastel.new(enabled: color)
       @theme = Theme.new(enabled: color)
+      @palette = Palette.new(enabled: color)
       @home = home
       @clipboard = clipboard
       @places = dirs.map { |path| Place.new(path, SessionRequest.label(path, dirs), path.sub(/\A#{Regexp.escape(home)}(?=\/|\z)/, "~")) }
-      @dir_settled = cwd.to_s
+      @dir_settled = cwd
       @fields = [
         Field.new(:prompt, "Prompt", :multiline, TextBuffer.new),
         Field.new(:name, "Name", :text, TextBuffer.new),
-        Field.new(:cwd, "Directory", :text, TextBuffer.new(cwd.to_s)),
+        Field.new(:cwd, "Directory", :text, TextBuffer.new(cwd)),
         Field.new(:model, "Model", :choice, DEFAULT, AgentsClient::MODELS),
         Field.new(:effort, "Effort", :choice, DEFAULT, AgentsClient::EFFORTS),
         Field.new(:permission_mode, "Permissions", :choice, DEFAULT, AgentsClient::PERMISSION_MODES),
         Field.new(:worktree, "Worktree", :choice, "no", %w[no yes]),
-        Field.new(:remote, "Remote Control", :choice, DEFAULT, [DEFAULT, "no", "yes"])
+        Field.new(:remote, "Remote Control", :choice, DEFAULT, [DEFAULT, "no", "yes"]),
+        Field.new(:color, "Color", :choice, DEFAULT, AgentsClient::COLORS)
       ]
       @focus = 0
       @error = nil
@@ -320,6 +323,7 @@ module ClaudeInbox
         f.choices.map { |c|
           text = (c == DEFAULT) ? default_text(f) : c
           if c == f.value then (on ? @theme.pill(" #{text} ", :cyan) : @theme.cyan_bold(" #{text} "))
+          elsif f.key == :color then @palette.paint(" #{text} ", c)
           else @p.dim(" #{text} ")
           end
         }.join(" ")
@@ -327,6 +331,7 @@ module ClaudeInbox
     end
 
     def default_text(f)
+      return "none" if f.key == :color
       resolved = defaults[f.key]
       resolved ? "#{resolved} (settings)" : "auto (cli default)"
     end

data/lib/claude_inbox/palette.rb

@@ -22,7 +22,7 @@ module ClaudeInbox
 
     RESET = "\e[39m"
 
-    def initialize(enabled: true)
+    def initialize(enabled:)
       @enabled = enabled
     end