rtfm-filemanager 8.2.6 → 8.6.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 7ba9bb8fbd17a51b1016eef29ceb5718dba8f6819bb24c6aee7b78aa7d8e7b83
-  data.tar.gz: 3ce4361180ee23a2e446d1fb0d26f4d7d144517cef841bee9444e871f922c4e8
+  metadata.gz: 7d97437ca84138aaa2ad3fc03b54c2d607f39cda4e1d6fead69bef9d83278a9d
+  data.tar.gz: feb00468052819fdbb1c7c109406db875eba2be13c98273f0d16cbd90fb968ce
 SHA512:
-  metadata.gz: 9303820f8f84adfb87b589925d16fb9b02102fd1c7df9a4a845b04b5854558e0910231b3d286488aa0d905252845794a5030ac7c72ff25b5ce3637af418db68f
-  data.tar.gz: 82dbd79b2fc59c33001f3436a53bd9ad0f3ddcfafc112e8bc618788e47e6f88f2b40646d73189cedc3f7f0535302577b63cd959a4ed60731f8df5ab79dcf30e9
+  metadata.gz: 59981f04215c73a44f4821d1dbf3dddb74db5590521e746567c0970c157c96aca84b48c9c2ee3afa20037537734937e7b59c56b9a23c2cee8d947e67c0cefa2f
+  data.tar.gz: ac25468b6d11effefb11b5debd5e006c9d11aa689e623f638d5ee35a06e798b93343481b8b8b4f7f3950ae7acf046f117cdaecc37de43e050abc2b2a39100de2

data/CHANGELOG.md

@@ -5,6 +5,27 @@ All notable changes to RTFM will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [8.6.0] - 2026-05-19
+
+### Added
+- **`Terminal=true` in `.desktop` files honored** - When opening a file, if the resolved `.desktop` file declares `Terminal=true`, RTFM treats the program as interactive even when it isn't in `@interactive`. Newly installed TUI tools now "just work" without editing config. The `@interactive` whitelist still wins for programs whose `.desktop` files lie about being terminal apps
+
+### Fixed
+- **LS_COLORS fallback via `dircolors -b`** - When `$LS_COLORS` is unset or empty (cron launches, minimal login envs, some macOS setups), RTFM now seeds it from `dircolors -b` at startup so `ls --color` still emits ANSI. Directory listings stay colored in environments that don't export LS_COLORS
+
+## [8.5.0] - 2026-05-19
+
+### Added
+- **Crash log** - Unhandled exceptions now append to `~/.rtfm/crash.log` with timestamp, version, Ruby/platform info, cwd, exception class/message, and full backtrace. The `at_exit` handler skips `SystemExit`/`Interrupt` so normal quits stay silent. Makes bug reports actionable instead of guesswork from terminal scrollback
+- **Persistent per-directory cursor** - The in-memory `@directory` hash that tracks selected index per directory is now saved to `~/.rtfm/conf` on quit (capped at 200 entries, prunes deleted dirs). Re-enter a directory in a later session and the cursor lands where you left it
+- **`--fresh` CLI flag** - Launch with `rtfm --fresh` to ignore the saved cursor map for one session (useful when the saved positions are stale or you want a clean slate)
+- **File-path argument** - `rtfm /etc/hosts` now cd's into `/etc` and places the cursor on `hosts`. Previously only directory arguments worked
+- **Claude (Anthropic) support for AI features** - Set `@aimodel = "claude-sonnet-4-6"` (or any `claude-*` model) in `~/.rtfm/conf` and both `I` (file description) and `Ctrl-a` (chat) route to the Anthropic API via curl. OpenAI continues to work for non-`claude-*` model names. Same `@ai` config field holds either key
+- **Non-blocking `:` commands** - Non-interactive shell commands now run in a background thread. Launching GUI apps (`xdg-open`, `firefox`, `evince`, etc.) no longer freezes RTFM until they exit. Output drops into the right pane when the command completes. The bottom pane shows running/done status
+
+### Fixed
+- **Bootsnap optional** - Missing `bootsnap` gem no longer crashes RTFM on startup. It was always intended as a startup-speed optimization; now `require 'bootsnap/setup'` is wrapped in a `LoadError` rescue and RTFM continues without it
+
 ## [8.2.6] - 2026-04-21
 
 ### Added

data/bin/rtfm

@@ -18,21 +18,58 @@
 #             get a great understanding of the code itself by simply sending
 #             or pasting this whole file into you favorite AI for coding with
 #             a prompt like this: "Help me understand every part of this code".
-@version    = '8.2.6' # Add `hyper` to the default @interactive TUI-app list
+@version    = '8.6.0' # LS_COLORS fallback (dircolors -b) + Terminal=true in .desktop honored
 
 # SAVE & STORE TERMINAL {{{1
 ORIG_STTY = `stty -g`.chomp
 
 at_exit do
+  # Log unhandled exceptions to ~/.rtfm/crash.log so users can file bug reports
+  # without losing the backtrace to terminal scrollback.
+  if $! && !$!.is_a?(SystemExit) && !$!.is_a?(Interrupt)
+    begin
+      log = File.join(Dir.home, '.rtfm', 'crash.log')
+      require 'fileutils'
+      FileUtils.mkdir_p(File.dirname(log))
+      File.open(log, 'a') do |f|
+        f.puts '=' * 60
+        f.puts "RTFM v#{@version} crash at #{Time.now}"
+        f.puts "Ruby #{RUBY_VERSION} on #{RUBY_PLATFORM}"
+        f.puts "PWD: #{Dir.pwd rescue 'unknown'}"
+        f.puts "#{$!.class}: #{$!.message}"
+        f.puts($!.backtrace.join("\n")) if $!.backtrace
+      end
+    rescue StandardError
+      # never crash inside the crash handler
+    end
+  end
   system("stty #{ORIG_STTY} < /dev/tty") rescue nil
 end
 
 # BOOTSNAP {{{1
+# Optional startup speedup. If the gem isn't installed, RTFM just starts
+# a bit slower instead of refusing to run.
 cache_dir = ENV.fetch('BOOTSNAP_CACHE_DIR', File.join(Dir.home, '.rtfm', 'bootsnap-cache'))
 ENV['BOOTSNAP_CACHE_DIR'] = cache_dir
 require 'fileutils'
 FileUtils.mkdir_p(cache_dir)
-require 'bootsnap/setup' # Speed up subsequent requires
+begin
+  require 'bootsnap/setup'
+rescue LoadError
+  # bootsnap not installed — proceed without compile cache
+end
+
+# LS_COLORS FALLBACK {{{1
+# RTFM relies on `ls --color` ANSI output for left/right pane colors, and
+# `ls` itself reads $LS_COLORS. If the user's shell never exports it (cron
+# launches, minimal login environments, some macOS setups) the listing
+# comes back colorless. Seed it from `dircolors -b` when available.
+if (ENV['LS_COLORS'].nil? || ENV['LS_COLORS'].empty?) && !`which dircolors 2>/dev/null`.strip.empty?
+  dc = `dircolors -b 2>/dev/null`
+  if (m = dc.match(/LS_COLORS='([^']*)'/))
+    ENV['LS_COLORS'] = m[1]
+  end
+end
 
 # ENCODING {{{1
 # encoding: utf-8
@@ -616,6 +653,13 @@ $stdin.set_encoding(Encoding::UTF_8)
 @file_op_complete = false        # Flag when operation finishes
 @file_op_result = nil            # Result message when operation finishes
 
+## Async shell command (`:` mode, non-interactive branch)
+@shell_cmd_thread   = nil        # Current background shell-command thread
+@shell_cmd_running  = false      # True while a background `:` cmd is running
+@shell_cmd_label    = nil        # Command string for status display
+@shell_cmd_complete = false      # Set by worker when output is ready
+@shell_cmd_output   = nil        # Captured stdout+stderr
+
 ## Recently accessed files/directories
 @recent_files = []      # Last 50 accessed files
 @recent_dirs = []       # Last 20 accessed directories  
@@ -860,11 +904,33 @@ if (pick_arg = ARGV.find { |a| a.start_with?('--pick=') })
   ARGV.delete(pick_arg)
 end
 
+# --fresh: ignore any saved per-directory cursor positions for this session.
+# @directory is still tracked in-memory, but startup restoration is skipped.
+@fresh = false
+if ARGV.delete('--fresh')
+  @fresh = true
+  @directory = {}
+end
+
 # Handle start dir {{{2
-Dir.chdir(ARGV.shift) if ARGV[0] && File.directory?(ARGV[0])
+# Accept either a directory or a file path. With a file path, cd into its
+# parent and queue the basename for cursor restoration after load_dir runs.
+@startup_select = nil
+if (arg = ARGV[0]) && !arg.start_with?('-')
+  if File.directory?(arg)
+    Dir.chdir(ARGV.shift)
+  elsif File.exist?(arg)
+    @startup_select = File.basename(arg)
+    Dir.chdir(File.dirname(File.expand_path(arg)))
+    ARGV.shift
+  end
+end
 
 # Initialize first tab {{{2
 create_tab(Dir.pwd, "Main")
+# Seed the first tab's per-tab directory_memory with the persisted @directory
+# so switching tabs and back doesn't lose the saved cursor map.
+@tabs[0][:directory_memory] = @directory.dup if @tabs[0]
 
 # OPENAI SETUP {{{1
 def chat_history # {{{2
@@ -880,6 +946,33 @@ def openai_client # {{{2
   @openai_client ||= OpenAI::Client.new(access_token: @ai)
 end
 
+# AI dispatch: routes to Anthropic when @aimodel starts with 'claude-',
+# otherwise OpenAI. Returns the assistant message text, or nil on failure.
+# Anthropic uses curl (no extra gem dependency); OpenAI uses ruby-openai.
+def ai_request(messages, max_tokens = 600) # {{{2
+  if @aimodel.to_s.start_with?('claude-')
+    require 'json'
+    # Anthropic expects "system" as a top-level field, not a message role.
+    sys = messages.find { |m| (m[:role] || m['role']).to_s == 'system' }
+    msgs = messages.reject { |m| (m[:role] || m['role']).to_s == 'system' }
+    body = { model: @aimodel, max_tokens: max_tokens, messages: msgs }
+    body[:system] = sys[:content] || sys['content'] if sys
+    out = `curl -sS -X POST https://api.anthropic.com/v1/messages \
+      -H 'content-type: application/json' \
+      -H 'anthropic-version: 2023-06-01' \
+      -H #{Shellwords.escape("x-api-key: #{@ai}")} \
+      -d #{Shellwords.escape(body.to_json)} 2>/dev/null`
+    return nil if out.empty?
+    json = JSON.parse(out) rescue nil
+    json && json.dig('content', 0, 'text')
+  else
+    resp = openai_client.chat(
+      parameters: { model: @aimodel, messages: messages, max_tokens: max_tokens }
+    ) rescue nil
+    resp&.dig('choices', 0, 'message', 'content')
+  end
+end
+
 # SET UP VIEWER SYSTEM {{{1
 # rubocop:disable Style/StringLiterals
 preview_specs = {
@@ -4804,16 +4897,19 @@ end
 
 def openai_description # {{{3
   clear_image
-  begin
-    require 'ruby/openai'
-  rescue LoadError
-    @pB.say('To enable AI-descriptions: `gem install ruby-openai` and set @ai in ~/.rtfm/conf')
-    return
-  end
   unless @ai && !@ai.empty?
-    @pB.say("Set your API key in ~/.rtfm/conf: @ai = 'your-secret-openai-key'")
+    @pB.say("Set your API key in ~/.rtfm/conf: @ai = 'your-api-key'")
     return
   end
+  # ruby-openai is only needed for OpenAI models; Anthropic uses curl.
+  unless @aimodel.to_s.start_with?('claude-')
+    begin
+      require 'ruby/openai'
+    rescue LoadError
+      @pB.say('For OpenAI models: `gem install ruby-openai`. For Claude, set @aimodel to a claude-* model.')
+      return
+    end
+  end
   # Context
   path    = File.join(Dir.pwd, @selected.to_s)
   is_dir  = File.directory?(path)
@@ -4827,27 +4923,26 @@ def openai_description # {{{3
   parts << "Git-Aware Diff Explanation: summarize the most recent `git diff` touching #{path}, explaining what changed." if Dir.exist?(File.join(Dir.pwd, '.git'))
   parts << "Existing preview text: #{preview}" unless preview.empty?
   prompt = parts.join(' ')
-  # Send to OpenAI
-  client = OpenAI::Client.new(access_token: @ai)
   @pR.say('Thinking...'.fg(244))
-  response = client.chat(
-    parameters: {
-      model:      @aimodel,
-      messages:   [{ role: 'user', content: prompt }],
-      max_tokens: 600
-    }
-  ) rescue nil
-  answer = response&.dig('choices', 0, 'message', 'content') ||
-           '⚠️ Error or empty response from OpenAI.'
+  answer = ai_request([{ role: 'user', content: prompt }], 600) ||
+           '⚠️ Error or empty response from AI provider.'
   @pR.say(answer.fg(230))
 end
 
 def chat_mode # {{{3
   clear_image
-  unless defined?(OpenAI) && @ai && !@ai.empty?
-    @pB.say("To make OpenAI work in RTFM, run `gem install ruby-openai` and add to ~/.rtfm/conf:\n  @ai = 'your-secret-openai-key'")
+  unless @ai && !@ai.empty?
+    @pB.say("Set your API key in ~/.rtfm/conf: @ai = 'your-api-key'")
     return
   end
+  unless @aimodel.to_s.start_with?('claude-')
+    begin
+      require 'ruby/openai'
+    rescue LoadError
+      @pB.say('For OpenAI models: `gem install ruby-openai`. For Claude, set @aimodel to a claude-* model.')
+      return
+    end
+  end
 
   @pB.clear; @pB.update = true
   question = @pAI.ask('Chat> ', '').strip
@@ -4855,15 +4950,7 @@ def chat_mode # {{{3
 
   chat_history << { role: 'user', content: question }
   @pR.say('Thinking...'.fg(230))
-  reply = openai_client.chat(
-    parameters: {
-      model:    @aimodel,
-      messages: chat_history,
-      max_tokens: 400
-    }
-  ) rescue nil
-  answer = reply&.dig('choices', 0, 'message', 'content') ||
-           '⚠️ API error or empty response'
+  answer = ai_request(chat_history, 400) || '⚠️ API error or empty response'
   chat_history << { role: 'assistant', content: answer }
   @pR.say(answer.fg(230))
   @pB.clear; @pB.update = true
@@ -5385,15 +5472,33 @@ def command_mode # {{{3
     refresh
     render
   else
-    # Check if it's a GUI application that should run without timeout
-    gui_apps = ['evince', 'xdg-open', 'firefox', 'chrome', 'chromium', 'eog', 'nautilus', 'thunar', 'gedit', 'code', 'subl']
-    prog_base = File.basename(prog.to_s)
-    is_gui = gui_apps.include?(prog_base)
-    
-    # Use nil timeout (wait forever) for GUI apps, 10 seconds for others
-    shellexec(cmd, timeout: is_gui ? nil : 10)
-    @pR.refresh
-    @pR.update = false
+    # Run non-interactive commands in a background thread so GUI apps
+    # (xdg-open, firefox, evince, …) and long-running tools don't freeze
+    # the TUI. The main loop polls @shell_cmd_complete and drops output
+    # into the right pane when ready.
+    if @shell_cmd_running
+      @pB.say("A background command is still running: #{@shell_cmd_label}".fg(214))
+      return
+    end
+    @shell_cmd_running  = true
+    @shell_cmd_complete = false
+    @shell_cmd_output   = nil
+    @shell_cmd_label    = cmd
+    cmd_str = cmd.dup
+    @shell_cmd_thread = Thread.new do
+      begin
+        out, err, _status = Open3.capture3('sh', '-c', cmd_str)
+        combined = out.dup
+        combined << "\n" << err.fg(196) unless err.empty?
+        @shell_cmd_output = combined
+      rescue StandardError => e
+        @shell_cmd_output = "Error: #{e.class}: #{e.message}".fg(196)
+      ensure
+        @shell_cmd_complete = true
+      end
+    end
+    @pB.say(" Running: #{cmd}".fg(244))
+    @pB.update = true
   end
 end
 
@@ -6415,11 +6520,18 @@ def get_interactive_program(file_path) # HELPER FOR OPEN_SELECTED TO USE @intera
         if desktop_path
           content = File.read(desktop_path)
           exec_line = content[/^Exec=(.*)$/m, 1]
+          # Honor Terminal=true in the .desktop file: any app declaring
+          # itself a terminal program is treated as interactive even if
+          # the user hasn't manually added it to @interactive. Lets newly
+          # installed TUI tools "just work" without editing config.
+          terminal_true = content =~ /^Terminal\s*=\s*true\b/i
           if exec_line
-            # Extract the program name (first word, remove path)
             prog = exec_line.split.first
             prog = File.basename(prog) if prog
-            return prog if prog && inter_list.include?(prog)
+            if prog
+              return prog if inter_list.include?(prog)
+              return prog if terminal_true
+            end
           end
         end
       end
@@ -6574,7 +6686,8 @@ def conf_write(all: false) # WRITE TO ~/.rtfm/conf {{{2
     'history'     => "@history     = #{@pCmd.history.reverse.uniq.reverse.last(40)}",
     'rubyhistory' => "@rubyhistory = #{@pRuby.history.reverse.uniq.reverse.last(40)}",
     'aihistory'   => "@aihistory   = #{@pAI.history.reverse.uniq.reverse.last(40)}",
-    'sshhistory'  => "@sshhistory  = #{@pSsh.history.reverse.uniq.reverse.last(40)}"
+    'sshhistory'  => "@sshhistory  = #{@pSsh.history.reverse.uniq.reverse.last(40)}",
+    'directory'   => "@directory   = #{@directory.select { |d, _| Dir.exist?(d) }.to_a.last(200).to_h}"
   }
   if all
     assignments.merge!(
@@ -7063,6 +7176,13 @@ end
 @pSsh.record    = true
 @pSsh.history   = @sshhistory
 
+# Restore startup cursor from saved per-directory positions (unless --fresh).
+# A file-path argument is applied after the first render in the main loop,
+# since @files isn't populated until render() runs.
+if !@fresh && @directory[Dir.pwd]
+  @index = @directory[Dir.pwd]
+end
+
 # Report plugin errors {{{2
 @pR.say("Plugin load errors:\n" + @plugin_errors.join("\n").fg(196)) if @plugin_errors.any? 
 
@@ -7096,6 +7216,23 @@ loop do
     @pB.update = false
   end
 
+  # Check async `:` shell command (non-interactive branch in command_mode)
+  if @shell_cmd_complete
+    @shell_cmd_complete = false
+    @shell_cmd_running  = false
+    @shell_cmd_thread = nil
+    if @shell_cmd_output && !@shell_cmd_output.empty?
+      clear_image
+      @pR.say(@shell_cmd_output)
+    end
+    @pB.say(" Done: #{@shell_cmd_label}".fg(156))
+    @shell_cmd_label = nil
+    @shell_cmd_output = nil
+    # Directory may have changed (file created/removed); invalidate cache
+    @dir_cache.delete_if { |key, _| key.start_with?("#{Dir.pwd}:") }
+    @pL.update = @pR.update = @pB.update = true
+  end
+
   # Handle pending terminal resize (debounced from SIGWINCH)
   if @winch_pending && !@external_program_running
     @winch_pending = false
@@ -7115,6 +7252,15 @@ loop do
   rescue Errno::EIO
     # Note: rcurses 4.9.0+ has enhanced error handling, reducing need for this
   end
+  # Apply file-argument cursor selection on first render (when @files is populated)
+  if @startup_select && @files && !@files.empty?
+    ix = @files.index(@startup_select)
+    if ix
+      @index = ix
+      @pL.update = @pR.update = true
+    end
+    @startup_select = nil
+  end
   # read key, but ignore TTY-focus errors
   begin
     getkey

metadata

@@ -1,14 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: rtfm-filemanager
 version: !ruby/object:Gem::Version
-  version: 8.2.6
+  version: 8.6.0
 platform: ruby
 authors:
 - Geir Isene
-autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-04-21 00:00:00.000000000 Z
+date: 1980-01-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rcurses
@@ -104,7 +103,6 @@ licenses:
 - Unlicense
 metadata:
   source_code_uri: https://github.com/isene/RTFM
-post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -119,8 +117,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.4.20
-signing_key:
+rubygems_version: 3.6.7
 specification_version: 4
 summary: RTFM - Ruby Terminal File Manager
 test_files: []