rtfm-filemanager 8.2.6 → 8.5.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 7ba9bb8fbd17a51b1016eef29ceb5718dba8f6819bb24c6aee7b78aa7d8e7b83
-  data.tar.gz: 3ce4361180ee23a2e446d1fb0d26f4d7d144517cef841bee9444e871f922c4e8
+  metadata.gz: f884960bd43345ca3368b1213be174efecf43943d20be674d722b70b848a7edf
+  data.tar.gz: 5c3b0d4c294ee89015df17b5b5adc4ba78b7080fee34fa5825d1a7a88f92531c
 SHA512:
-  metadata.gz: 9303820f8f84adfb87b589925d16fb9b02102fd1c7df9a4a845b04b5854558e0910231b3d286488aa0d905252845794a5030ac7c72ff25b5ce3637af418db68f
-  data.tar.gz: 82dbd79b2fc59c33001f3436a53bd9ad0f3ddcfafc112e8bc618788e47e6f88f2b40646d73189cedc3f7f0535302577b63cd959a4ed60731f8df5ab79dcf30e9
+  metadata.gz: ef00e7d08a4b579bb5a989cdbac6c30d02a77462401faeddaf30de42a464ccbbb547dcca7f369d050f0e64b83a8be8e4930eb38500d548bd010f4b77815f72c3
+  data.tar.gz: c063661025b9887def4c49f146042a78cc6dd3cf0dbc7fd5b42b929f3219fc64e5e79412bb2a6afa9cc2cfaa3188cf7f2f5380102573ecd4cd5ef0f07bd56544

data/CHANGELOG.md

@@ -5,6 +5,19 @@ 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.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,46 @@
 #             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.5.0' # Crash log, persistent per-dir cursor, Claude AI, non-blocking `:` commands
 
 # 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
 
 # ENCODING {{{1
 # encoding: utf-8
@@ -616,6 +641,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 +892,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 +934,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 +4885,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 +4911,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 +4938,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 +5460,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
 
@@ -6574,7 +6667,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 +7157,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 +7197,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 +7233,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.5.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: []