filecon 0.1.1 → 0.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 7f656a074b7160a9c362539e004b02f9e5d474cfafa6dd009df97040cc4398bf
-  data.tar.gz: 28f6a13ebf1aa1d536b69928f0f0e279cb0a5f60adadbf17e6bfbeb30d0213e1
+  metadata.gz: 47e7fc518a42a7037832b88feb1e3c7d3b23c64968de970928104d1fe5c47ef1
+  data.tar.gz: e7cc5f0746c241fc6b3d3866b1efb3220b1274870c7446f7a6c48ac8abd0aa10
 SHA512:
-  metadata.gz: aee107ce9e33a5529ce0b574079d22471e7f96b5e42b246bb8b547730b40676a87d5f99f8f9988d108610af0d2c7d922bdefd0d8593b22cf8ce8027942304d7b
-  data.tar.gz: b4ca16e0cb4b8b5de25f0cc8088db0178894afe92f270176f6cb39cac7edd2a2f168470376357a85eba183fbfa7c827f547971840322f42bb10e8003b0b87f6a
+  metadata.gz: f34237e27ff2d45a8aee3e577afd2f6aa5e0bca8e1fbc03fcec77615500aab08b459575ac17715ed89a5c20eac959388e78d7afd0c446281e01fb502d8f41e5b
+  data.tar.gz: 9c639e9634aa690a09d4bad83732f16153b6852ffaee84967b55dc140e97ba27a151cd904ff93633c24d12b1dbeadd466c7021b8b75af7050bee87087f66facc

data/README.md

@@ -1,3 +1,5 @@
+![Filecon](logo_alpha_small.png)
+
 # Filecon
 
 A terminal-based file manager built on the [Typr](https://codeberg.org/typr/typr) terminal UI toolkit.
@@ -16,12 +18,6 @@ A terminal-based file manager built on the [Typr](https://codeberg.org/typr/typr
 gem install filecon
 ```
 
-Or add to your Gemfile:
-
-```ruby
-gem "filecon", "~> 0.1"
-```
-
 ## Usage
 
 ```bash
@@ -39,12 +35,13 @@ filecon [directory]
 **Actions**
 - `o` — Open list of all commands for selected file
 - `c` — Command history
+- `x` — List all executables from $PATH directories
 - `h` — Help
 - `v` — Views
 - `s` — Sort view
 - `f` — Filter view
 - `r` — Reset view
-- `R` — Toggle recursive listing
+- `R` — Recursive file listing
 
 **Marking**
 - `m` — Mark file
@@ -54,7 +51,7 @@ filecon [directory]
 
 **Directory**
 - `~` — Go to home directory
-- `` ` `` — Go to root directory
+- `` ` `` — Open commands for current directory
 - `d` — Directory history
 
 **Other**
@@ -63,19 +60,29 @@ filecon [directory]
 
 ### Configuration
 
-Config is stored at `~/.config/filecon/config.yaml` and includes:
+Config is stored at `~/.config/filecon/config.yaml` (YAML format) and includes:
 
-- Color settings
-- Command definitions per file type
+- Color settings (named colors, 8-bit palette, RGB triplets)
+- Command definitions per MIME type
 - View configurations
-- History limits
+- History limits and terminal settings
+
+**Command prefixes:**
+
+- `|` — pipe output to status line
+- `+` — run in a new terminal window
+- `=` — display output in the text viewer
+- `!` — evaluate as Ruby code
+
+**Substitution variables:** `%name` (file path), `%dir` (directory picker), `%file` (file picker), `%str` (text input)
+
+See `filecon(1)` or the installed `filecon.yaml` for full details.
 
 ## Development
 
 ```bash
 git clone https://codeberg.org/typr/filecon
 cd filecon
-bundle install
 rake test
 ```
 

data/bin/filecon

@@ -1,29 +1,52 @@
 #!/usr/bin/ruby
 
+require "fileutils"
+require "yaml"
+require_relative "../lib/filecon"
+
 begin
-  require "filecon"
-rescue LoadError
-  require_relative "../lib/filecon"
-end
+  config_dir = File.expand_path("~/.config/filecon")
+  config_path = File.join(config_dir, "config.yaml")
+  unless File.exist?(config_path)
+    FileUtils.mkpath config_dir
+    FileUtils.cp File.join(__dir__, "../config.yaml"), config_path
+  end
+  state_dir = File.expand_path("~/.local/share/filecon")
+  FileUtils.mkpath state_dir
 
-Filecon.setup_config
+  dh_path = File.join(state_dir, "dir_history")
+  ch_path = File.join(state_dir, "cmd_history")
 
-begin
-  config = Filecon.config
-  term = config[:term] || ENV["TERM"] || ""
-  term_hold = term + (config[:term_hold] || " --hold")
-  Typr.init( color: config[:colors][:default] )
+  [dh_path, ch_path].each { |f| FileUtils.touch f }
+
+  parse = ->(p) { File.readlines(p).map { |l| s = l.chomp.split(",", 2); [s[0].to_i, s[1]] } rescue [] }
+
+  config = YAML.safe_load(File.read(config_path), permitted_classes: [Symbol]) || {}
+
+  term = config["term"] || ENV["TERM"] || ""
+  term += config["term_hold"] if config["term_hold"]
+
+  Typr.init config["colors"]["default"]
   Typr.clear
-  Filecon::App.new( right: -1, bottom: -1,
-    dir_history: File.read(Filecon.dir_history_path).split($/),
-    cmd_history: File.read(Filecon.cmd_history_path).split($/),
-    directory: ARGV.first, keymap: { open_file: ?o, cmd_history: ?c },
-    colors: { cmd_history: :red }.merge( config[:colors] || {} ),
-    views: config[:views] || {},
-    commands: config[:commands] || {},
+
+  app = Filecon::App.new( right: -1, bottom: -1,
+    dir_history: parse[dh_path],
+    cmd_history: parse[ch_path],
+    path: { config: config_path, state: state_dir, dir_history: dh_path,
+            cmd_history: ch_path },
+    directory: ARGV.first || ?., keymap: { open_file: ?o, cmd_history: ?c, dir_history: ?d, recurse: ?R, open_current: ?` },
+    colors: config["colors"] || {},
+    views: config["views"] || {},
+    commands: config["commands"] || {},
     term: term,
-    term_hold: term_hold ).fly
+    max_history: config["max_history"] || 100,
+    frequency_limit: config["frequency_limit"] || 10,
+    filter_dirs: config["filter_dirs"] )
+  Typr.on_resize { app.show }
+  app.import_shell_history
+  app.fly
 rescue => e
+  $stderr.puts "#{e.class}: #{e.message}\n#{e.backtrace.first(10).join("\n")}"
   File.write File.join(Dir.tmpdir, "filecon_error.log"),
     "#{e.class}: #{e.message}\n#{e.backtrace.first(10).join("\n")}"
 ensure

data/config.yaml

@@ -3,7 +3,6 @@
 # =============================================================================
 #
 # This is the default configuration file for Filecon, a terminal file manager.
-# Copy this file to ~/.config/filecon/config.yaml and customize as needed.
 #
 # All settings are optional. Filecon will use sensible defaults if values
 # are not specified.
@@ -22,7 +21,11 @@ term_hold: " --hold"
 
 # Maximum number of history entries to retain.
 # Older entries beyond this limit are automatically pruned.
-max_history: 100
+max_history: 10000
+
+frequency_limit: 10
+# When true, active filters also hide directories that don't match.
+filter_dirs: true
 
 
 # =============================================================================
@@ -32,11 +35,28 @@ max_history: 100
 # Customize the color scheme for different file types in the browser view.
 #
 # Color values can be:
-#   - Named colors:  black, red, green, yellow, blue, magenta, cyan, white, grey
+#   - Named colors:
+#       Basic:   black, red, green, yellow, blue, magenta, cyan, white, grey
+#       Shades:  brown, orange, lime, pink, maroon, navy, teal, olive, coral, tan
+#       Dark:    dark_red, dark_green, dark_yellow, dark_blue,
+#                dark_magenta, dark_cyan
 #   - Grey shades:   grey0 through grey100 (e.g., grey62 for 62% grey)
 #   - 8-bit palette: 0 - 255 (maps to terminal's 256-color palette)
 #   - RGB triplets:  [0-255, 0-255, 0-255] (true color terminals)
 #
+# Color settings passed to Typr spaces:
+#   default          global default foreground/background [fg, bg]
+#   border           widget borders
+#   header           column/panel headers
+#   question         prompt question text
+#   answer           typed input text
+#   selected         highlighted / selected row background
+#   alternate        alternating row background in lists
+#   hints            hint numbers/digits
+#   actions          named action colors: "[f]ilter", "[s]ort", "[v]iews"
+#   commands         command picker and status line: [name, args] colors
+#   search           search-match highlight (text viewer)
+#
 # Usage:
 #   Foreground color only:    "blue"
 #   Foreground + background:  ["white", "black"]
@@ -45,12 +65,16 @@ max_history: 100
 
 colors:
   default: ["white", "black"]
+  # [name, args] colors for the command picker and the status line
+  # shown while building/running a command
+  commands: ["green", "red"]
   types:
     image: "blue"
     audio: "green"
     video: "cyan"
     directory: "yellow"
     "x-pie-executable": "red"
+    # executable: "red"
 
 
 # =============================================================================
@@ -91,37 +115,58 @@ colors:
 #
 #   %str   - Prompts for text input, inserts the string
 #
+# SPECIAL CATEGORIES:
+#
+#   executable  - Added to the command picker for any file whose
+#                 executable bit is set for the current user, regardless
+#                 of its MIME type (e.g. shell scripts with shebangs).
+#
 # =============================================================================
 
 commands:
   default:
-    open: "|xdg-open %name"
-    diskuse: "|du -hs %name"
+    # copy: "|rsync --progress %name %dir"
     info: "=file %name"
-    copy: "+rsync --progress %name %dir"
+    copy: "|cp -R %name %dir"
     move: "|mv %name %dir"
-    delete: "|rm %name"
+    rename: "|mv %name %str"
+    delete: "|rm -rf %name"
+    open_with: "|%file %name %str" 
+    open_with_terminal: "+%file %name %str" 
+    xdg_open: "|xdg-open %name"
+
+  executable:
+    run: "|%name %str"
+    run_terminal: "+%name %str"
+    help: "=%name --help"
+    manual: "+man %name"
 
   directory:
     cd: "!cd %name"
-
+    new_file: "|touch %name/%str"
+    new_dir: "|mkdir %name/%str"
+    shell: "+$SHELL -c 'cd %name && exec $SHELL'"
+    # zsh: "+zsh -c 'cd %name && exec zsh'"
+    disk_use: "|du -hs %name | cut -wf1"
+    
   text:
     view: "+moor %name"
     edit: "+micro %name"
-    count: "|wc -l %name"
+    count: "|wc -l %name | cut -wf1"
 
   troff:
     manual: "+man %name"
 
   "x-ruby":
-    run: "+ruby %name"
+    run: "|ruby %name"
+    run_terminal: "+ruby %name"
 
   html:
     terminal: "+cha %name"
     graphics: "|vimb %name"
 
   image:
-    play: "|mpv %name"
+    view: "|pqiv %name"
 
   video:
     play: "|mpv %name"
@@ -132,12 +177,6 @@ commands:
   pdf:
     view: "|mupdf %name"
 
-  "x-pie-executable":
-    run: "|%name"
-    run_terminal: "+%name"
-    help: "=%name --help"
-    manual: "+man %name"
-
   "x-python":
     run: "+python3 %name"
 
@@ -176,23 +215,23 @@ commands:
     view: "=cat %name | jq ."
 
   "zip":
-    list: "|unzip -l %name"
+    list: "=unzip -l %name"
     extract: "|unzip %name -d %dir"
 
   "x-gzip":
-    list: "|tar -tzf %name"
+    list: "=tar -tzf %name"
     extract: "|tar -xzf %name -C %dir"
 
   "x-bzip2":
-    list: "|tar -tjf %name"
+    list: "=tar -tjf %name"
     extract: "|tar -xjf %name -C %dir"
 
   "x-xz":
-    list: "|tar -tJf %name"
+    list: "=tar -tJf %name"
     extract: "|tar -xJf %name -C %dir"
 
   "x-tar":
-    list: "|tar -tf %name"
+    list: "=tar -tf %name"
     extract: "|tar -xf %name -C %dir"
 
   "epub+zip":
@@ -217,10 +256,10 @@ commands:
 #   - A string Command to execute (with %name substitution)
 #   - A symbol Reference to a system field (e.g., :size, :type, :subtype)
 #
-# Prefix ! to evaluate as Ruby, prefix | for shell commands.
+# Prefix ! to evaluate as Ruby
 #
 # Available system fields:
-#   target, permissions, owner, group, size,
+#   target, permissions, executable, owner, group, size,
 #   accessed, modified, created, type, subtype
 #
 # When a view is activated, its columns are appended to the default file
@@ -232,13 +271,18 @@ views:
   content:
     content: "head -n 50 %name"
 
-  filetype:
+  types:
     type: true
     subtype: true
     description: "file -b %name"
 
-  lines:
-    lines: "wc -l %name"
+  disk_use:
+    du: "du -hs %name | cut -wf1"
+
+  count:
+    chars: "wc -m %name | cut -wf1"
+    words: "wc -w %name | cut -wf1"
+    lines: "wc -l %name | cut -wf1"
 
   whatis:
-    whatis: "!open('|whatis %name 2>&1').read.match(/[-:]\\s(.*)$/)[1]"
+    whatis: "whatis $(basename %name) 2>&1 | sed 's/.* - //'"

data/filecon.1

@@ -1,4 +1,4 @@
-.TH FILECON 1 "2026-07-26" "filecon" "User Commands"
+.TH FILECON 1 "2026-07-27" "filecon 0.1.1" "User Commands"
 .SH NAME
 filecon \- interactive terminal file manager with hint-based navigation
 .SH SYNOPSIS
@@ -60,7 +60,7 @@ Filter rows
 Recurse directory tree
 .TP
 .B `
-Navigate to root directory
+Open commands for current directory
 .TP
 .B ~
 Navigate to home directory
@@ -77,10 +77,16 @@ Open list of all commands for selected file
 .TP
 .B c
 Browse command history
+.PP
+Directory and command history popups list the most frequently used entries
+first, then the remaining entries in most-recent order. The
+.B frequency_limit
+setting in config.yaml (default 10) controls how many frequent entries lead
+the list.
 .SH CONFIGURATION
 On first run, the default
 .B config.yaml
-is copied from the installation directory to
+(YAML format) is copied from the installation directory to
 .BR ~/.config/filecon/ .
 .SS Config File Locations
 .TP
@@ -92,6 +98,19 @@ Directory navigation history
 .TP
 .B ~/.config/filecon/cmd_history
 Command execution history
+.SS Command Prefixes
+.TP
+.B |
+Pipe output to status line
+.TP
+.B +
+Run in a new terminal window
+.TP
+.B =
+Display output in the text viewer
+.TP
+.B !
+Evaluate as Ruby code
 .SS Command Substitutions
 .TP
 .B %name

data/lib/filecon/version.rb

@@ -1,3 +1,3 @@
 module Filecon
-  VERSION = "0.1.1"
+  VERSION = "0.2.0"
 end

data/lib/filecon.rb

@@ -1,7 +1,3 @@
-require "fileutils"
-require "open3"
-require "yaml"
-
 begin
   require_relative "../../typr/lib/typr"
 rescue LoadError
@@ -10,54 +6,30 @@ end
 
 require_relative "filecon/version"
 
-module Filecon
-  PATH = File.join(ENV["HOME"], ".config/filecon/")
-
-  def self.dir_history_path
-    File.join(PATH, "dir_history")
-  end
-
-  def self.cmd_history_path
-    File.join(PATH, "cmd_history")
-  end
-
-  def self.setup_config
-    FileUtils.mkpath PATH unless File.exist? PATH
-    FileUtils.cp File.join(__dir__, "../config.yaml"), PATH unless File.exist? File.join(PATH, "config.yaml")
-    FileUtils.touch dir_history_path
-    FileUtils.touch cmd_history_path
-  end
-
-  def self.deep_symbolize_keys(obj)
-    case obj
-    when Hash
-      obj.each_with_object({}) { |(k, v), h| h[k.to_sym] = deep_symbolize_keys(v) }
-    when Array
-      obj.map { |v| deep_symbolize_keys(v) }
-    else
-      obj
-    end
-  end
+class Filecon::App < Typr::Browser
+  include Typr
 
-  def self.config
-    config_path = File.join(PATH, "config.yaml")
-    if File.exist?(config_path)
-      deep_symbolize_keys(YAML.safe_load(File.read(config_path), permitted_classes: [Symbol]))
+  def cd dir, append=false
+    if dir.is_a? Array
+      dirs = dir.filter_map { |d| d = File.expand_path(d.to_s); Dir.exist?(d) ? d : nil }
+      dirs.each_with_index { |d, i|
+        @directory = d if i.positive?
+        Dir.chdir(d) if i.positive?
+        super d, i.positive?
+      }
+      @directory = dirs
+      nil
     else
-      {}
+      dir = @dir_history[dir+1][1] if dir.is_a? Integer
+      record :dir, File.expand_path(dir) unless append || [?/, ENV["HOME"]].include?(dir)
+      super dir, append
+      nil
     end
   end
-end
 
-class Filecon::App < Typr::Browser
-  include Typr
-
-  def cd dir, append=false; super
-    File.write Filecon.dir_history_path,
-    	@dir_history[0..Filecon.config["max_history"]].join($/)
-    return
-  end
+  def execute; cd ENV["PATH"].split(":"); add_path_column end
 
+#switch_view
   def switch_to id=nil
     return unless id
     id = @views.keys[id] if id.is_a? Integer
@@ -66,9 +38,13 @@ class Filecon::App < Typr::Browser
     data = @data.map.with_index{ |row, id| row + view.values.map{ |cmd|
       next unless cmd.is_a?(String)
       built = build cmd, id
-      io = built[0] == ?! ?
-        StringIO.new( eval( built[1..-1] ).to_s ) :
-        open( ?| + built + " 2>&1" )
+      next unless built
+      io = if built[0] == ?!
+        StringIO.new eval( built[1..-1] ).to_s
+      else
+        cmd = built[0] == ?| ? built : ?| + built
+        open cmd + " 2>&1"
+      end
       io.read(width).to_s.scrub.gsub(/[\n\t]/, ?|)
     }.compact }
     @sequence = [ NAME ] + view.keys.map{ |head|
@@ -76,51 +52,79 @@ class Filecon::App < Typr::Browser
     clear
     self << data
     @current = id
+    @view = id
   end
 
-  def open_file id=nil, default=false
-    return unless id ||= @selected[:rows].empty? ?
-      @user.ask( open:[self, :row] ) : @selected[:rows]
-    types = if id.is_a? Array
+  def open_file id=nil, default=false, types=nil
+    unless id || types
+      return unless id ||= @selected[:rows].empty? ?
+        @user.ask( open:[self, :row, NAME] ) : @selected[:rows]
+    end
+    types ||= if id.is_a? Array
       eval id.map{ |id| @data[id].values_at(SUBTYPE,TYPE).to_s }.join(?&)
     else @data[id].values_at(SUBTYPE, TYPE)
-    end - [??] + [:default]
+    end - [??] + ["default"]
+    if id && (id.is_a?(Array) ? id.all?{ |i| @data[i][EXECUTABLE] } : @data[id][EXECUTABLE])
+      types.insert(types.index("default") || types.size, "executable")
+    end
 
-    commands = @commands.values_at( *types.map(&:to_sym) ).map(&:to_a).flatten 1
-    cmd = if default; commands.first.last
+    commands = @commands.values_at( *types ).map(&:to_a).flatten( 1 ).uniq
+    pair = if default; commands.first
     else move left+1,top+1
-      if id.is_a?(Array); show "#{id.count.to_s} files: (#{ 
+      if id.is_a?(Array); draw "#{id.count.to_s} files: (#{ 
         types.join ?, })".ljust width
       else print id end
-      return unless cmd = Grid.new( left:1, top:3, right: -1,
+      pop = id ? top+2 : top
+      return unless cmd = Grid.new( left:left+1, top: pop, right: -1,
+      bottom: [ pop + commands.count - 1, Typr.height ].min,
       input:commands, border: :light, format: [:min, :max],
-      borders: { top: nil }, alternate: false,
-      colors: {columns: [:green, :red] }  ).pick( :row )
-      commands[ cmd ].last
+      borders: { top: nil }, alternate: false, hints: "1234567890",
+      colors: {columns: @colors[:commands] || [:green, :red] }  ).pick( :row, column: 0 )
+      commands[ cmd ]
+    end
+    cmd = build pair.last, id, pair.first
+    return unless cmd
+    if cmd[0] == ?|
+      display = cmd[1..-1]
+      record :cmd, cmd
+      io = run( cmd )
+      output = io.read.to_s.scrub.strip
+      nc, ac = @colors[:commands] || [:green, :red]
+      @user.show "> #{color_code(nc)}#{pair.first}#{color_code(ac)}:#{display}" \
+        "#{color_code(@colors[:default])} : #{output.lines.last}"
+      Typr.read_key
+    else
+      record :cmd, cmd unless cmd[0..2] == '!cd'
+      run( cmd )
+      show
     end
-    cmd = build cmd, id
-    if cmd.start_with? ?|
-      fork { io = run( cmd, true )
-        until io.eof?
-          @user.draw io.readline.strip.scrub
-          sleep 0.1
-        end
-      }
-    else run( cmd, cmd[0..2] != '!cd' ) end
-    draw
   end
 
-  def build str, id
+  def build str, id, name=nil
+    nc, ac = @colors[:commands] || [:green, :red]
+    reset = color_code( @colors[:default] )
+    prefix = name ? "#{color_code(nc)}#{name}#{color_code(ac)}:" : ""
     cmd = ""
     while str[/\%(name|dir|file|str)/]
-      @user.draw( cmd += $` )
+      cmd += $`
       case $&
-        when '%name'; cmd += ?"+( id.is_a?( Array ) ? id.map{ |id|
-          @directory + @data[id][NAME] }.join('" "') :
-          @directory + @data[id][NAME] )+?"
-        when '%dir';  cmd += ?"+(pick :directory)+?"
-        when '%file'; cmd += ?"+(pick :file)+?"
-        when '%str';  cmd += Typr.read :line
+        when '%name'; cmd += ?"+( id.nil? ? @directory :
+          id.is_a?( Array ) ? id.map{ |id|
+          @data[id][NAME] }.join('" "') :
+          @data[id][NAME] )+?"
+        when '%dir'
+          @user.show "> #{prefix}#{cmd}#{$&}#{$'}#{reset}"
+          return unless dir = pick(:directory)
+          cmd += ?" + dir + ?"
+        when '%file'
+          @user.show "> #{prefix}#{cmd}#{$&}#{$'}#{reset}"
+          return unless file = pick(:file)
+          cmd += ?" + file + ?"
+        when '%str'
+          prompt = cmd.empty? || cmd.end_with?(' ') ? cmd : "#{cmd} "
+          query = Typr.read_line "> #{prefix}#{prompt}", left: left, top: @user.top
+          return unless query
+          cmd += query
       end
       str = str[($`+$&).size..-1]
     end
@@ -128,46 +132,207 @@ class Filecon::App < Typr::Browser
     return cmd
   end
 
-  def run cmd=nil, store=false
+  def run cmd=nil
     return unless cmd
-    cmd = @cmd_history[cmd] if cmd.is_a? Integer
+    cmd = @cmd_history[cmd][1] if cmd.is_a? Integer
     case cmd[0]
       when ?! then io = StringIO.new eval( cmd[1..-1] ).to_s
       when ?| then io = open( cmd + " 2>&1" )
       when ?+ then io = open( ?| + @term +' '+ cmd[1..-1] + " 2>&1" )
       when ?= then Text.new(top: 2, right:-1, bottom:-2, border: :light,
         input:open( ?|+cmd[1..-1]+" 2>&1" ) ).pick :none
-    end
-    if store
-      @cmd_history.unshift cmd
-      @cmd_history.uniq!
-      File.write Filecon.cmd_history_path, @cmd_history[0..Filecon.config["max_history"]].join($/)
+      else io = open( ?| + @term +' '+ cmd + " 2>&1" )
     end
     return io
   end
 
-  def cmd_history; run popup( { input: @cmd_history, align:[:left], left:left,
-    colors: { columns: [ @colors[:cmd_history] ] } } ).pick(:row), true
+  def cmd_history; history @cmd_history, :cmd end
+  def dir_history; history @dir_history, :dir end
+
+  def history data, type
+    is_cmd = type == :cmd
+    data = data.drop 1 unless is_cmd
+    return unless data.any?
+
+    top = data.max_by(@frequency_limit) { |cnt, _| cnt }
+    top_set = top.filter_map { |_, e| e }.to_h { |e| [e, true] }
+    ordered = top + data.reject { |_, e| top_set[e] }
+
+    pairs = ordered.map { |_, e|
+      is_cmd ? [e.split(' ', 2)[0], e.split(' ', 2)[1] || ""] :
+        [File.basename(e), e]
+    }
+
+    fc = is_cmd ? [:red, :blue] : [:yellow, :brown]
+    fields = {}
+    ordered.each_with_index { |(cnt, e), i|
+      next unless top_set[e]
+      fields[[i,0]] = [fc[0], :grey20]
+      fields[[i,1]] = [fc[1], :grey20]
+    }
+
+    n = popup(input: pairs, hints:"1234567890", format:[:min,:max],
+      alternate: true, left: left, bottom: -2,
+      colors: { columns: fc, fields: fields }).pick(:row, column: :all)
+    return unless n
+
+    entry = ordered[n][1]
+    record type, entry
+
+    if is_cmd
+      begin; run entry; rescue => e; Text.new(top: 2, right:-1, bottom:-2, border: :light,
+        input: StringIO.new(e.message + "\n" + e.backtrace.first(3).join("\n"))).pick :none; end
+    else
+      unless Dir.exist? entry
+        @user.show "no such directory: #{entry}"; Typr.read_key; return
+      end
+      cd entry
+      nil
+    end
+  end
+
+  def import_shell_history
+    sync = File.join(@path[:state], "shell_sync"); return if File.exist?(sync)
+
+    @user.show "importing shell history..."
+    valid = ENV["PATH"].split(":").each_with_object({}) { |d, v|
+      Dir.entries(d).each { |e| v[e] = true } rescue nil }
+
+    builtins = %w[cd . alias bg break builtin command continue declare dirs echo
+      eval exec exit export false fc fg getopts hash history jobs kill let limit
+      local logoff logout mapfile popd printf pushd pwd read readonly return set
+      shift shopt source suspend test times trap true type typeset ulimit umask
+      unalias unset wait whence which]
+
+    aliases = {}
+    [".zshrc", ".bashrc"].each { |rc|
+      File.readlines(File.join(ENV["HOME"], rc)).each { |l|
+        l =~ /\A\s*alias\s+(\w+)=(?:'([^']*)'|"([^"]*)"|(\S+))/ &&
+          aliases[$1] = ($2 || $3 || $4 || "").split.first } rescue nil }
+
+    last = 0
+    lines = 0
+    [File.expand_path("~/.bash_history"), File.expand_path("~/.zsh_history")].each { |p|
+      next unless File.exist?(p)
+      @user.show "importing shell history: #{File.basename(p)}..."
+      File.readlines(p).each { |l|
+        c = l.chomp.scrub(''); next if c.empty? || c[0] == '#'
+        if p.end_with?('zsh_history')
+          ts = c[/\A: (\d+):\d+;(.*)/, 1]&.to_i
+          c = c[/\A: \d+:\d+;(.*)/, 1] || c
+          last = ts if ts && ts > last
+        end
+        next if c.empty?
+        first = c.split.first; next unless first
+        r = first; 10.times { break unless aliases[r]; r = aliases[r] }
+        c = r + c[first.size..] if r != first
+        next unless valid[r] || builtins.include?(r)
+        record :cmd, c, write: false unless %w[cd pushd].include?(r)
+        c.split.each { |t|
+          t = t.delete_prefix('"').delete_prefix("'").delete_suffix('"').delete_suffix("'")
+          next unless t.start_with?('/', '~')
+          t = File.expand_path(t) rescue nil
+          record :dir, t, write: false if t && Dir.exist?(t)
+        }
+        lines += 1
+        @user.show "importing shell history: #{lines} lines..." if lines % 500 == 0
+      }
+    }
+    File.write(@path[:cmd_history], @cmd_history.map { |c, e| "#{c},#{e}" }.join($/))
+    File.write(@path[:dir_history], @dir_history.map { |c, e| "#{c},#{e}" }.join($/))
+    File.write(sync, last.to_s)
+    @user.reset
+  end
+
+  def record type, entry, write: true
+    h = type == :cmd ? @cmd_history : @dir_history
+    idx = h.index { |_, e| e == entry }
+    cnt = idx ? (h.delete_at(idx)[0] + 1) : 1
+    h.unshift [cnt, entry]
+    h.slice!(@max_history..) if h.size > @max_history
+    File.write @path[:"#{type}_history"], h.map { |c, e| "#{c},#{e}" }.join($/) if write
+  end
+
+  def recurse
+    return if @directory.is_a?(Array)
+    root = File.expand_path(@directory)
+    clear
+    cd root
+    Dir.glob("**/*", File::FNM_DOTMATCH, base: root).sort.each { |p|
+      next if !@show_hidden && p.split(?/).any? { |c| c.start_with?(?.) }
+      next unless File.directory?(File.join(root, p))
+      d = File.expand_path(p, root)
+      @directory = d
+      Dir.chdir d
+      cd d, true
+    }
+    Dir.chdir root
+    @directory = root
+    add_path_column
+    @current = 0
+    nil
+  end
+
+  def add_path_column
+    Typr.const_set :PATH, @header.size unless Typr.const_defined?(:PATH)
+    @header << "path" unless @header.include?("path")
+    @data.each { |row| row[PATH] = File.dirname(row[NAME]) }
+    @sequence.insert(@sequence.index(NAME) || 0, PATH) unless @sequence.include?(PATH)
+    # @align[@header.size-1] = :right
+  end
+
+  def help
+    info = "\nFILECON - a terminal file manager\n\n" \
+      "HINTS: press a number (1-9,0) to open that file with its default action.\n" \
+      "       TAB cycles pages of hints.\n\n" \
+      "COMMANDS:\n" \
+      "  e[x]ecute      browse all executables on your PATH\n" \
+      "  [R]ecurse      expand the current directory tree (subdirectories listed inline)\n" \
+      "  [d]irectories  jump to a recently visited directory\n" \
+      "  [c]ommands     re-run a recent command\n\n" \
+      "  Directory and command history popups list the most frequently used\n" \
+      "  entries first, then the rest in most-recent order. The frequency_limit\n" \
+      "  setting in config.yaml (default 10) controls how many frequent entries\n" \
+      "  lead the list.\n\n" \
+      "CONFIG: ~/.config/filecon/config.yaml\n\n" \
+      "KEYBINDINGS:\n\n" + @user.bindings.join(?\n)
+    Text.new( input: info, top:2, left:3, right: -3, bottom: -3, header: "HELP",
+      colors: { header: [:black,:white], border:[:white,:grey10] },
+      border: :light ).pick :none
   end
 
   def initialize args={}
     super
+    @rawsort[NAME] = false
+    @cmd_history ||= []
+    @dir_history ||= []
+    @path ||= {}
+    @frequency_limit = args[:frequency_limit] || 10
+    @keymap[:open_current] = ?`
+    @keymap[:execute] = ?x
+    @keymap[:recurse] = ?R
     @user.bindings.insert 1, "[o]pen"
-    @user.bindings.insert 7, "[c]ommands"
-    @user.draw
+    @user.bindings.insert 7, "[R]ecurse"
+    @user.bindings.insert 8, "[c]ommands"
+    @user.bindings.insert 9, "e[x]ecute"
+    @user.bindings.insert 11, "[`]:open_current"
+    @user.reset
   end
 
+  def open_current; open_file nil, false, ["directory", "inode"] - [??] + ["default"] end
+
   def fly
     loop do
-      draw
+      show
       draw_hints :rows
-      key = Typr.read :key
-      @user.reset
+      key = Typr.read_key
+      next unless key
       case key
         when KEY_ESCAPE; exit
         else
           id = send( key )
-          open_file id, true if id.is_a? Integer
+          open_file( id, true) if id.is_a? Integer
+          @user.reset
       end
     end
   end

metadata

@@ -1,14 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: filecon
 version: !ruby/object:Gem::Version
-  version: 0.1.1
+  version: 0.2.0
 platform: ruby
 authors:
 - Kilian Reitmayr
-autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-07-26 00:00:00.000000000 Z
+date: 1980-01-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: typr
@@ -16,14 +15,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.0'
+        version: '1.2'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.0'
+        version: '1.2'
 - !ruby/object:Gem::Dependency
   name: unicode-display_width
   requirement: !ruby/object:Gem::Requirement
@@ -82,11 +81,11 @@ files:
 - filecon.1
 - lib/filecon.rb
 - lib/filecon/version.rb
+- logo_alpha_small.png
 homepage: https://codeberg.org/typr/filecon
 licenses:
 - GPL-2.0-only
 metadata: {}
-post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -101,8 +100,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.3.15
-signing_key:
+rubygems_version: 3.6.9
 specification_version: 4
 summary: Terminal file manager built on Typr
 test_files: []