filecon 0.4.0 → 0.5.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 27fa8d3a100f9d752db3fde969136cb2c1435c809970691629e46e0c897b2a46
-  data.tar.gz: 87bd4e4845433cbda8c0c35f70c4e7dcc94ff95c026cfa0f84fd9cecc211201d
+  metadata.gz: 5974a832fd4c71067467f52e319ccbc571cac95c740e04ff5324699c1ed9644e
+  data.tar.gz: 825ea4d8a0c3ceef5741b05fda14cf1fb323423db521ce4d4f73dec731d4f97d
 SHA512:
-  metadata.gz: 9cc34718bdfdd72ebbadf9cf91cd3d654df2ac6b5350c9c9160ba03577d692541e8d117ead9452cba6f1a5b8f9a05a3195691a53caccce496b8790e53ed7e5eb
-  data.tar.gz: 4ddf3aefa8c71081089b61ebfc03a731c31f763478310091aa5cce43ff1aa16bc129a1e158c5620f7aad17b7a917090fd14ae22cb61ec435f61f44f8b6a372f8
+  metadata.gz: 8a10b9a8136a7582e08a2f5aa82483e34035781f01a16ca8a50705a2b4728dc70dca191da64272980888d8a8ba84f436493c40378c7b3399e3e751c465531402
+  data.tar.gz: fb1d09dc92c41f2165ee12f5f4089675dd4e28d414e02821a5eb74c4cb1c349130c0921a650f9d43ea322c3d21fc39acc169d17dd7b53cb35e049a8be469fd31

data/CHANGELOG.md

@@ -2,6 +2,34 @@
 
 ## [vx.y.z] — __DATE__
 
+## [v0.5.0] — 2026-09-30
+
+### Added
+- `x` — `execute` types a command line (with TAB completion from the shell) and runs it: `|` output goes to a status line with the last line shown until a keypress, plain commands run through the shell
+- `%` substitutions in command edits — alt-editing a command in the `open_file` list or in command history runs the substitution parser again on the result, so `%name`/`%str`/`%dir`/`%file`/`%cmd` work in edits (`%name` resolves to the current directory for history edits), and a cancelled substitution aborts the command
+- Command groups for a file are collected in a canonical order — `printable`, `executable`, subtype, type, `default` — so the printable and executable categories lead the picker (and the printable group's first command becomes the default action) ahead of MIME-derived groups
+- Interactive copy/move — `!transfer(:copy|:move, %name, %dir)` runs copy/move in Ruby with per-conflict pickers (skip/overwrite/older/smaller/size-differs/rename plus alt-number apply-to-all), a from/to info grid, rename prompts, progress and end tally; unreadable entries count as failed instead of aborting
+
+### Changed
+- `%file`/`%dir`/`%cmd` substitution tokens blink on the command line while browsing for a pick
+- `=` command output — the text area drops its border and shows the command string as a header one row higher, so the full height goes to the output
+- `e[x]ecute` (PATH browser) is now `[e]xecutables` on `e`, freeing `x` for the new command-line runner
+- Filecon is described as "a file and command manager that lives between terminal and shell" throughout the documentation (README, man page, help panel, config header, gemspec)
+- Conflicts are decided by name alone — a destination that exists (or is a dangling symlink) prompts, even when the content is identical; prompts are collected on the `@user` line via `Line#ask` instead of scattered `Typr.read_line` calls
+
+### Fixed
+- Key bindings whose value is a prefixed command (for example `+ls`) no longer raise `NameError` — the key was passed to the method dispatcher, which evaluated `+ls` as unary `+` on a method named `ls`; a prefixed binding is now looked up when the key is pressed and run through the same `build`/`run` procedure as a command from the file list, including `%` substitution, and without being added to the command history. `!method` and bare-name bindings keep dispatching to their method
+- Clicking a bottom-bar label whose binding is a prefixed command runs it like a keypress — the click path previously looked the binding up and dispatched the raw `+ls` to the method dispatcher, which raised `NameError` and did nothing
+- Commands that open a terminal window (`+` and any other prefix whose format is not Ruby) no longer block the browser when launched from `e[x]ecute` — the launcher used to be read to EOF, freezing the browser for the whole window and echoing every keypress and mouse report as `^[OB`/`^[[<0;…M` garbage on the screen; it is now left running unattended in its own process group, exactly as the command list and command history already did
+- The `term:` config setting is removed — a terminal window is opened by the prefix format itself (`$TERM --hold %s`), expanded by the shell from the environment
+- Filenames containing `'` or `$` no longer break command execution — `%name`/`%dir`/`%file`/`%cmd` values are escaped for their quoting context when `build` wraps them in double quotes (shell and Ruby `!` modes), and `run` escapes `\`/`'` when the prefix format wraps `%s` in single quotes (`|`, `=`) so the `eval` parses; intentional `$` expansion in typed commands (`|echo $HOME`) still works
+- Command editing prompts are fixed — `execute`, alt-edit in `open_file`, and command-history edits render a single `> ` prompt through `Line#cli` instead of the doubled `> > ` line `ask` produced, and the completion grid tints command candidates with `cmd_name` (red) and options with `cmd_options` (blue)
+- `%name` joins array ids with commas in `!` (Ruby) commands so multi-select builds to valid argument lists; shell commands keep space-joined quoting
+- Conflict picker drains stale input on open and the transfer shows its end tally with a keypress pause, so a buffered confirm can neither auto-answer overwrite nor vanish unseen
+- Commands spawned right after an auto-confirmed pick start with the terminal input queue drained, so keys overtyped at the selection cannot reach the editor or the launched window
+
+## [v0.4.1] — 2026-09-11
+
 ## [v0.4.0] — 2026-09-05
 
 ### Added
@@ -20,6 +48,9 @@
 - `cd` owns the path column flag — array `cd` sets `@show_path` (single dirs clear it), so `reset_view` preserves the path listing after `execute`/`recurse` instead of dropping it; `recurse` just builds the recursive directory array and delegates the loading to `cd`
 - Array `cd` fills the path column after the full load — previously only the first directory's rows got values (the rest stayed blank on `reset_view`), and custom Hash views dropped the column entirely; the trailing `change_view` now runs once on complete data, and computed views keep PATH too
 - Clickable header path — left-clicking the username goes home and each directory segment navigates there, while right-click opens the command list for that path without leaving the current directory
+- Alt+click opens the command list — Alt+left-click on a row or header path behaves like right-click, for touchscreens where right-click is hard to send (Termux)
+- Failed `cd` keeps history and the path flag — directory history, selection clearing, and `@show_path` only commit after a successful navigation, and array loads skip unreadable entries up front
+- Base colors definable in config — the eight basic names (`black`..`white`) accept Integer/RGB values under `colors:`, shipped mirroring `.Xresources` color0-7 with the terminal default pair; commenting them out restores terminal colors
 - A binding picked in help now runs — `fly` re-dispatches a String return from `send` (as it already did for mouse clicks), so pressing `h` and clicking e.g. `[R]ecurse` executes that action instead of just closing the help page
 - The help text panel sits flush with the terminal edge — the text panel's `right: -2` border now draws on the last column, matching the browser edge; the previous inset was caused by an off-by-one in the `draw_border` guard
 
@@ -61,12 +92,11 @@
 - `open_current` (`` ` ``) — opens the directory under the cursor in its default app
 - Full-path filenames: `cd` stores absolute paths in `@data`; `@procs[NAME]` displays basenames via `File.basename`; `build` uses `@data[id][NAME]` directly (no `@directory` prefix)
 - `@directory` accepts an Array (for multi-path listings like `execute`); `draw` joins Array entries with `": "` for the status display
-- `frequency_limit` config var (default 10) — only the top N most-used entries get frequency coloring in history popups, listed frequency-first then most-recent
+- `top_history` config var (default 10) — only the top N most-used entries get frequency coloring in history popups, listed frequency-first then most-recent
 - `filter_dirs` config flag (default true) — active filters also hide directories that don't match
 - Shell history importer — `import_shell_history` reads `~/.bash_history`/`~/.zsh_history` once at startup, validates commands against `$PATH` and built-ins, resolves aliases from `.zshrc`/`.bashrc`, and merges new entries into `cmd_history`; a `shell_sync` flag in the state dir prevents re-import
 - `open_file` status line now shows the picked command name first in `colors.commands` colors — `> name:display : output` (name in `colors.commands[0]`, the built command in `colors.commands[1]`; default `["green", "red"]`); the command picker popup uses the same configurable colors
 - `build` prompts for `%dir`/`%file`/`%str` prepend the colored command `name:` prefix, so the partial command stays identifiable while being filled in
-- `term_hold` config — hold flag appended to `@term` at init (e.g. `foot --hold`)
 
 ### Changed
 - Config location moved to `~/.config/filecon/config.yaml` — on first run the bundled `config.yaml` is copied there; state/history remain under `~/.local/share/filecon/`; string-keyed `colors:` settings (as loaded from YAML) are now honored

data/README.md

@@ -4,12 +4,12 @@
 
 ## Description
 
-Filecon is a terminal-based file manager built on the [Typr](https://codeberg.org/typr/typr) terminal UI toolkit. Every file, command, and directory is reachable in a few keystrokes, and the most common operations take the fewest key presses.
+Filecon is a file and command manager that lives between terminal and shell, built on the [Typr](https://codeberg.org/typr/typr) terminal UI toolkit. Every file, command, and directory is reachable in a few keystrokes, and the most common operations take the fewest key presses.
 
-Filecon is designed to be **intuitive**, **complete**, **powerful**, and the **fastest possible** file manager. The whole interface is built around that principle:
+Filecon is designed to be **intuitive**, **complete**, **powerful**, and **fast**. The whole interface is built around that principle:
 
 - **Hint navigation** — every visible row carries a number hint (1–9, 0); pressing it acts on that row immediately, no cursor movement needed.
-- **Live search in popups** — command and history popups open in `/` search mode; type to distill the list, then pick one of the few remaining results with a number.
+- **Live search in popups** — command and history popups open in `/` search mode; type to distill the list, then pick one of the few remaining results with a number. return select the first. auto selection of a single filter result.
 - **Frequency-ordered history** — directory and command history are ranked by use count, so the most likely choice is always near the top.
 
 Filecon runs on Typr, whose self-contained terminal layer ships its own precompiled terminfo key table and MIME-type database in the gem — no ncurses or external tooling required — so Filecon works on any raw, ANSI-capable terminal (including Termux).
@@ -17,14 +17,14 @@ Filecon runs on Typr, whose self-contained terminal layer ships its own precompi
 ## Features
 
 - **Directory browsing with MIME-type detection** — files are typed from a packaged MIME database and colored accordingly, with optional `file --mime-type` magic detection for unknowns
-- **Fastest possible navigation** — hint numbers (1–9, 0) open rows directly; TAB pages hints beyond the first ten
+- **Fast navigation** — hint numbers (1–9, 0) open rows directly; TAB pages hints beyond the first ten
 - **Default `[/]:search` in popups** — command and history popups open in search mode: start typing to distill the list down to the matches, then press a number hint to pick from the few remaining results. The listing itself searches the same way
 - **Mouse support** — click a row to open it with its default action, right-click to open its command list, click a binding on the bottom bar or a filter/sort/views column to run that action; the mouse wheel scrolls the listing (pointer-only mode is planned)
 - **Command execution modes** — commands run in one of four ways, chosen by prefix: `|` status line, `=` text viewer, `+` new terminal window, `!` Ruby eval; per-MIME-type command sets with `%name`, `%dir`, `%file`, `%cmd`, `%str` substitution
 - **Customizable column views** — view columns run shell commands with `%name` substitution (content preview, char/word/line counts, type info, disk usage, man-page descriptions)
-- **Directory and command history with a frequency counter** — entries stored as `[count, entry]` pairs, most-used first then most-recent; `frequency_limit` controls how many frequent entries lead the list
+- **Directory and command history with a frequency counter** — entries stored as `[count, entry]` pairs, most-used first then most-recent; `top_history` controls how many most-used entries lead the list
 - **Shell history import** — on first run, `~/.bash_history` and `~/.zsh_history` are validated, alias-resolved, and merged into the command history; directory paths referenced by those commands are collected into the directory history
-- **Power browsing** — recursive directory listing, `execute` ($PATH browser), marking, filtering, sorting, and switchable column views
+- **Power browsing** — recursive directory listing, `executables` ($PATH browser), typing a command line to run (`execute`), marking, filtering, sorting, and switchable column views
 - **Fully documented configuration** — a self-documenting `config.yaml` covers colors, commands, views, history, and terminal settings
 
 ## Installation
@@ -49,7 +49,8 @@ filecon [directory]
 
 **Actions**
 - `c` — Command history
-- `x` — List all executables from $PATH directories
+- `e` — List all executables from $PATH directories
+- `x` — Type a command line and run it in the shell (TAB completion)
 - `h` — Help
 - `v` — Views
 - `s` — Sort view
@@ -76,7 +77,7 @@ filecon [directory]
 
 ### Mouse
 
-Click a row to open it with its default action, right-click to open its command list; click a binding label on the bottom bar or a filter/sort/views column on the head to run that action; the mouse wheel scrolls the listing. Clicking outside a popup dismisses it. `h` shows a two-pane help with the keybinding grid (from the line's `list`) beside the help text — clicking a binding row returns its trigger key, and clicking outside both panes closes it. Mouse reporting is enabled automatically when Filecon starts.
+Click a row to open it with its default action, right-click (or Alt+click) to open its command list; click a binding label on the bottom bar or a filter/sort/views column on the head to run that action; the mouse wheel scrolls the listing. Clicking outside a popup dismisses it. `h` shows a two-pane help with the keybinding grid (from the line's `list`) beside the help text — clicking a binding row returns its trigger key, and clicking outside both panes closes it. Mouse reporting is enabled automatically when Filecon starts.
 
 ### Popups and search
 
@@ -86,17 +87,17 @@ Command and history popups open in `/` search mode. Type a few characters to **d
 
 Config is stored at `~/.config/filecon/config.yaml` (YAML). On first run the bundled, fully documented `config.yaml` is copied there. It includes:
 
-- Color settings (named colors, 8-bit palette, RGB triplets) — including the `colors.commands` pair used by the command picker and status line
+- Color settings (named colors, 8-bit palette, RGB triplets, base-palette overrides) — including the `colors.commands` pair used by the command picker and status line
 - Command definitions per MIME type, with execution-mode prefixes
 - View configurations (columns that run shell commands)
-- History limits and terminal settings
+- History limits
 
 State and history files live under `~/.local/share/filecon/`.
 
 **Command execution modes:**
 
 - `|` — pipe output to the status line
-- `+` — run in a new terminal window
+- `+` — run in a new terminal window (in its own process group; the browser stays responsive)
 - `=` — display output in the text viewer
 - `!` — evaluate as Ruby code
 

data/bin/filecon

@@ -25,9 +25,6 @@ begin
 
   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
 
@@ -40,9 +37,10 @@ begin
     colors: config["colors"] || {},
     views: config["views"] || {},
     commands: config["commands"] || {},
-    term: term,
+    prefixes: config["prefixes"],
+    bindings: config["bindings"],
     max_history: config["max_history"] || 100,
-    frequency_limit: config["frequency_limit"] || 10,
+    top_history: config["top_history"] || 10,
     filter_dirs: config["filter_dirs"] )
   Typr.on_resize { app.show }
   app.import_shell_history

data/config.yaml

@@ -2,28 +2,18 @@
 # Filecon Configuration
 # =============================================================================
 #
-# This is the default configuration file for Filecon, a terminal file manager.
+# This is the default configuration file for Filecon, a file and command manager that lives between terminal and shell.
 #
 # All settings are optional. Filecon will use sensible defaults if values
 # are not specified.
 #
 # =============================================================================
 
-# Terminal settings
-# -----------------
-# The terminal emulator to use for Filecon's interface.
-# Defaults to $TERM environment variable if not set.
-# term: "kitty"
-
-# Suffix appended to term for opening files in a new window.
-# Example: if term is "foot", term_hold becomes "foot --hold"
-# term_hold: " --hold"
-
 # Maximum number of history entries to retain.
 # Older entries beyond this limit are automatically pruned.
 max_history: 10000
 
-frequency_limit: 10
+top_history: 6
 # When true, active filters also hide directories that don't match.
 filter_dirs: true
 
@@ -43,6 +33,10 @@ filter_dirs: true
 #   - 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)
+#   - Base palette:  redefine black, red, green, yellow, blue, magenta,
+#                    cyan, white to override the terminal palette;
+#                    comment these lines out (or delete them) to use
+#                    the terminal colors instead
 #
 # Color settings passed to Typr spaces:
 #   default          global default foreground/background [fg, bg]
@@ -53,9 +47,14 @@ filter_dirs: true
 #   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"
+#   actions          named action colors: filter, sort, views
 #   commands         command picker and status line: [name, args] colors
 #   search           search-match highlight (text viewer)
+#   dir_history      directory history picker: [name, path] columns
+#   cmd_history      command history picker: [prefix, command] columns
+#   top_history      top-history field background color
+#   help             help text title color
+#   help_border      help text border: [fg, bg]
 #
 # Usage:
 #   Foreground color only:    "blue"
@@ -64,44 +63,97 @@ filter_dirs: true
 # =============================================================================
 
 colors:
-  default: ["white", "black"]
-  # [name, args] colors for the command picker and the status line
-  # shown while building/running a command
-  commands: ["green", "red"]
+  # Base palette (comment out to use terminal colors)
+  black: [21, 21, 21]
+  red: [172, 65, 66]
+  green: [126, 141, 80]
+  yellow: [229, 181, 102]
+  blue: [108, 153, 186]
+  magenta: [158, 78, 133]
+  cyan: [125, 213, 207]
+  white: [208, 208, 208]
+
+  default: [white, black]
+  commands: [green, red]
   types:
-    image: "blue"
-    audio: "green"
-    video: "cyan"
-    directory: "yellow"
-    "x-pie-executable": "red"
-    # executable: "red"
+    image: blue
+    audio: green
+    video: cyan
+    directory: yellow
+    executable: red
+  actions:
+    filter: red
+    sort: blue
+    views: green
+  dir_history: [yellow, brown]
+  cmd_history: [red, blue]
+  top_history: grey20
+  help: yellow
+  help_border: [white, grey10]
 
 
 # =============================================================================
-# COMMANDS
+# PREFIXES
 # =============================================================================
 #
-# Define commands available for different file types. Each file type (MIME type
-# category) maps to a set of named commands that can be executed on files of
-# that type.
+# Define command prefixes for the execute prompt. Each prefix character maps to
+# a format string. %s is replaced with the command body.
 #
-# COMMAND PREFIXES (execution type):
+# Format strings starting with ! are evaluated as Ruby and their result is
+# read; every other format is a terminal window, started in its own process
+# group through the shell (so $TERM and friends expand from the environment)
+# and left running while the browser keeps going.
+#
+# =============================================================================
+
+prefixes:
+  "!": "!StringIO.new((%s).to_s)"
+  "|": "!open('|%s 2>&1')"
+  "+": "$TERM --hold %s"
+  "=": "!Text.new(top: 1, right:-1, bottom:-2, header: '%s', input: open('|%s 2>&1')).pick :none"
+
+# =============================================================================
+# BINDINGS
+# =============================================================================
 #
-#   |  Pipe output to status line
-#      The command's stdout is displayed in the status bar at the bottom.
-#      Example: "|wc -l %name" shows line count in status
+# Key bindings for the status bar. Each binding maps a label (with the key
+# character in brackets) to either `!method` — a method call, dispatched
+# directly — or any prefixed command, which is substituted with `build` and run
+# like a command from the file list (`%name` resolves to the current directory).
+# Commands from bindings are never added to the command history.
 #
-#   =  Display output in text area
-#      The command's output replaces the file listing with a text view.
-#      Example: "=file %name" shows file info in the text area
+# Only printable single characters work as key bindings.
+# Non-printable keys (arrows, escape, return, etc.) are hardcoded.
 #
-#   +  Run in new terminal window
-#      Opens a new terminal window to run the command.
-#      Example: "+less %name" opens a pager in a new window
+# =============================================================================
+
+bindings:
+  "[h]elp": "!help"
+  "[/]:search": "!search"
+  "[f]ilter": "!filter_view"
+  "[s]ort": "!sort_view"
+  "[v]iews": "!views"
+  "[r]eset": "!reset_view"
+  "[d]irectories": "!dir_history"
+  "[c]ommands": "!cmd_history"
+  "[e]xecutables": "!executables"
+  "e[x]ecute": "!execute"
+  "[R]ecurse": "!recurse"
+  "[m]ark": "!mark"
+  "[M]ark_range": "!mark_range"
+  "mark_[a]ll": "!mark_all"
+  "[i]nvert_mark": "!mark_invert"
+  "[~]:home": "!home"
+  "[H]idden_files": "!toggle_hidden"
+  "[`]:open_current": "!open_current"
+
+# =============================================================================
+# COMMANDS
+# =============================================================================
 #
-#   !  Evaluate as Ruby code
-#      The command string is evaluated as Ruby code.
-#      Example: "!cd %name" executes Ruby's cd command
+# Define commands available for different file types. Each file type (MIME type
+# category) maps to a set of named commands that can be executed on files of
+# that type.
 #
 # SUBSTITUTION VARIABLES:
 #
@@ -119,43 +171,59 @@ colors:
 #
 # SPECIAL CATEGORIES:
 #
+#   Command groups for a file are collected in this order:
+#   printable, executable, subtype, type, default.
+#
 #   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).
 #
+#   printable   - Added to the command picker for any file whose content
+#                 is printable text (no NUL byte, valid UTF-8 in the first
+#                 8KB), regardless of its MIME type.
+#
 # =============================================================================
 
 commands:
   default:
     # copy: "|rsync --progress %name %dir"
     info: "=file %name"
-    view: "+moor %name"
-    edit: "+micro %name"
-    copy: "|cp -R %name %dir"
-    move: "|mv %name %dir"
+    symlink: "ln -s %name %dir"
+    copy: "!transfer(:copy, %name, %dir)"
+    move: "!transfer(:move, %name, %dir)"
+    # copy_shell: "|cp -R %name %dir"
+    # move_shell: "|mv %name %dir"
     rename: "|mv %name %str"
     delete: "|rm -rf %name"
     open_with: "|%cmd %name %str" 
-    open_with_terminal: "+%cmd %name %str" 
+    # open_with_terminal: "+%cmd %name %str" 
     xdg_open: "|xdg-open %name"
 
   executable:
-    run: "|%name %str"
-    run_terminal: "+%name %str"
+    whatis: "=whatis %name"
     help: "=%name --help"
     manual: "+man %name"
+    run: "|%name %str"
+    run_terminal: "+%name %str"
+
+  printable:
+    edit: "+micro %name"
+    view: "=cat %name"
+    count: "|wc -l %name | cut -wf1"
+    search: "=grep -n %str %name"
 
   directory:
     cd: "!cd %name"
     new_file: "|touch %name/%str"
     new_dir: "|mkdir %name/%str"
-    shell: "+$SHELL -c 'cd %name && exec $SHELL'"
+    shell: "+$SHELL "
+    # shell: "+$SHELL -c 'cd %name && exec $SHELL'"
     # zsh: "+zsh -c 'cd %name && exec zsh'"
     disk_use: "|du -hs %name | cut -wf1"
     play: "+mpv %name"
 
-  text:
-    count: "|wc -l %name | cut -wf1"
+  # text:
+    # count: "|wc -l %name | cut -wf1"
 
   troff:
     manual: "+man %name"
@@ -262,7 +330,7 @@ commands:
 # Prefix ! to evaluate as Ruby
 #
 # Available system fields:
-#   target, permissions, executable, owner, group, size,
+#   target, permissions, executable, printable, owner, group, size,
 #   accessed, modified, created, type, subtype
 #
 # When a view is activated, its columns are appended to the default file

data/filecon.1

@@ -1,12 +1,13 @@
-.TH FILECON 1 "2026-07-27" "filecon 0.1.1" "User Commands"
+.TH FILECON 1 "2026-09-30" "filecon 0.5.0" "User Commands"
 .SH NAME
-filecon \- interactive terminal file manager with hint-based navigation
+filecon \- a file and command manager that lives between terminal and shell
 .SH SYNOPSIS
 .B filecon
 .RI [ directory ]
 .SH DESCRIPTION
 .B filecon
-is a terminal-based file manager built on top of the
+is a file and command manager that lives between terminal and shell, built
+on top of the
 .B Typr
 Ruby library. It displays directory entries in a grid with columns for name,
 symlink target, permissions, owner, group, size, timestamps, and MIME type.
@@ -75,10 +76,20 @@ Quit
 .TP
 .B c
 Browse command history
+.TP
+.B e
+List all executables from all PATH directories, showing each binary's
+containing directory in the
+.B path
+column
+.TP
+.B x
+Type a command line and run it in the shell (TAB completes
+commands, arguments, and files from the shell configuration)
 .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
+.B top_history
 setting in config.yaml (default 10) controls how many frequent entries lead
 the list.
 .SH CONFIGURATION
@@ -89,7 +100,7 @@ On first run, the default
 .SS Config File Locations
 .TP
 .B ~/.config/filecon/config.yaml
-Main configuration (colors, commands, views, term)
+Main configuration (colors, commands, views)
 .TP
 .B ~/.config/filecon/dir_history
 Directory navigation history
@@ -102,7 +113,7 @@ Command execution history
 Pipe output to status line
 .TP
 .B +
-Run in a new terminal window
+Run in a new terminal window, in its own process group, so the browser stays responsive
 .TP
 .B =
 Display output in the text viewer
@@ -138,7 +149,8 @@ Custom views can be defined in config.yaml by adding entries to the views hash.
 .SH ENVIRONMENT
 .TP
 .B TERM
-Terminal type used for terminal initialization.
+Terminal type used for terminal initialization, and expanded by the shell in
+prefix formats that open a terminal window.
 .TP
 .B HOME
 Used to resolve ~ and config directory path (~/.config/filecon/).

data/lib/filecon/version.rb

@@ -1,3 +1,3 @@
 module Filecon
-  VERSION = "0.4.0"
+  VERSION = "0.5.0"
 end

data/lib/filecon.rb

@@ -4,39 +4,82 @@ rescue LoadError
   require "typr"
 end
 
+require "fileutils"
+require "find"
+
 require_relative "filecon/version"
 
 class Filecon::App < Typr::Browser
   include Typr
 
+  def directory
+    @directory.is_a?(Array) ? @directory.inject { |a, b|
+      common = []
+      a.split("/").zip(b.split("/")).each { |x, y|
+        break if x != y
+        common << x
+      }
+      common.join("/")
+    } : @directory
+  end
+
   def cd dir, append=false
     @selected[:rows] = [] unless append
     if dir.is_a? Array
       @show_path = true
-      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?
+      dirs = dir.filter_map { |d| d = File.expand_path(d.to_s);
+        Dir.exist?(d) && File.readable?(d) && File.executable?(d) ? d : nil }
+      prefix = dirs.inject { |a, b|
+        common = []
+        a.split("/").zip(b.split("/")).each { |x, y|
+          break if x != y
+          common << x
+        }
+        common.join("/")
       }
+      prefix = "/" if prefix.empty?
+      dirs.each_with_index { |d, i| super d, i.positive?, prefix.size }
       @directory = dirs
+      Dir.chdir(prefix)
       change_view @view if dirs.any?
       nil
     else
-      @show_path = false unless append
       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
+      saved = @show_path
+      @show_path = false unless append
+      if ( super dir, append ) == false
+        @show_path = saved
+      else
+        record :dir, File.expand_path(dir) unless append || [?/, ENV["HOME"]].include?(dir)
+      end
       nil
     end
   end
 
-  def execute; cd ENV["PATH"].split(":") end
+  def execute
+    cmd = @user.cli("> ", redraw: method(:show),
+      history: @cmd_history.map { |_, cmd| cmd },
+      prefixes: @prefixes&.keys&.join)
+    return unless cmd
+    record :cmd, cmd unless cmd[0..2] == '!cd'
+    io = run cmd
+    if io and @prefixes&.[](cmd[0].to_s)&.start_with? '!'
+      output = io.read.to_s.scrub.strip
+      nc = (@colors[:commands] || [:green, :red]).first
+      @user.show "> #{color_code(nc)}#{cmd[1..-1]}#{color_code(@colors[:default])} : #{output.lines.last}"
+      show
+      Typr.read_key
+    else
+      show
+    end
+  end
+
+  def executables; cd ENV["PATH"].split(":") end
 
   def pick type='file', **kw
     return super unless type == :cmd
     dir = @directory
-    execute
+    executables
     result = super
     cd dir
     result
@@ -46,7 +89,11 @@ class Filecon::App < Typr::Browser
     return unless id
     id = @views.keys[id] if id.is_a? Integer
     view = @views[id]
-    return super if view.is_a? Array
+    if view.is_a? Array
+      super
+      return
+    end
+    Typr.flush_overtype
     data = @data.map.with_index{ |row, id| row + view.values.map{ |cmd|
       next unless cmd.is_a?(String)
       built = build cmd, id
@@ -65,10 +112,7 @@ class Filecon::App < Typr::Browser
       @header.index(head.to_s) || (@header += [head.to_s]; @header.count-1) }
     clear
     self << data
-    if @show_path
-      @data.each { |row| row[PATH] = File.dirname(row[NAME]) } if @data.any?
-      @sequence.insert(@sequence.index(NAME) || 0, PATH) unless @sequence.include?(PATH)
-    end
+    @sequence.insert(0, PATH) if @show_path
     @current = id
     @view = id
   end
@@ -82,9 +126,9 @@ class Filecon::App < Typr::Browser
       eval id.map{ |id| @data[id].values_at(SUBTYPE,TYPE).to_s }.join(?&)
     else @data[id].values_at(SUBTYPE, TYPE)
     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
+    special = { printable: PRINTABLE, executable: EXECUTABLE }.filter_map { |f, col|
+      f.to_s if id && (id.is_a?(Array) ? id.all?{ |i| @data[i][col] } : @data[id][col]) }
+    types = special + types
 
     commands = @commands.values_at( *types ).map(&:to_a).flatten( 1 ).uniq
     alt = false
@@ -107,9 +151,11 @@ class Filecon::App < Typr::Browser
     cmd = build pair.last, id, pair.first
     return unless cmd
     if alt
-      edited = Typr.read_line "> ", left: left, top: @user.top, initial: cmd, completions: true, redraw: method(:show)
+      edited = @user.cli("> ", initial: cmd, redraw: method(:show),
+        prefixes: @prefixes&.keys&.join)
       return unless edited
-      cmd = edited
+      cmd = build(edited, id, pair.first)
+      return unless cmd
     end
     if cmd[0] == ?|
       display = cmd[1..-1]
@@ -154,47 +200,133 @@ class Filecon::App < Typr::Browser
     @selected[:rows] = []
   end
 
+  def transfer op, *args
+    dest, files = args.pop, args
+    return unless dest and files.any?
+    if files.any? { |f| dest.start_with?( f + ?/ ) }
+      @user.show "cannot #{op} into itself"
+      return Typr.read_key
+    end
+    pairs = files.flat_map { |src|
+      next [[src, File.join(dest, File.basename(src))]] unless
+        File.directory?( src ) and !File.symlink?( src )
+      [[src, File.join(dest, File.basename(src))]] +
+        Find.find( src ).filter_map { |path|
+          [path, File.join(dest, File.basename(src), path[(src.length + 1)..-1])] unless path == src }
+    }
+    policy, done, skipped, failed = nil, 0, 0, 0
+    pairs.each_with_index do |(src, dst), i|
+      @user.show "#{op} #{i + 1}/#{pairs.size}: #{File.basename(src)}"
+      exists = File.exist?( dst ) || File.symlink?( dst )
+      action = exists ? policy : nil
+      while action.nil? and exists
+        action, policy = resolve_conflict( src, dst )
+        if action.is_a?( String )
+          dst = action
+          action = :overwrite
+        end
+      end
+      action = case action ||= :overwrite
+        when :older then (File.mtime(dst) < File.mtime(src) rescue false) ? :overwrite : :skip
+        when :smaller then (File.size(dst) < File.size(src) rescue false) ? :overwrite : :skip
+        when :size_differs then (File.size(dst) != File.size(src) rescue false) ? :overwrite : :skip
+        else action end
+      case action
+      when :abort; break
+      when :skip; skipped += 1
+      else
+        dst = action if action.is_a?( String )
+        if File.directory?( src ) and !File.symlink?( src )
+          FileUtils.mkdir_p( dst )
+        elsif op == :move
+          FileUtils.mv( src, dst )
+        else
+          FileUtils.cp( src, dst )
+        end
+        done += 1
+      end
+    rescue SystemCallError
+      failed += 1
+    end
+    if op == :move
+      files.select { |f| File.directory?( f ) and !File.symlink?( f ) }.each do |d|
+        Find.find( d ).to_a.sort.reverse.each { |p| Dir.rmdir( p ) rescue nil }
+      end
+    end
+    tally = "#{op}: #{done} done, #{skipped} skipped" + ( failed > 0 ? ", #{failed} failed" : "" )
+    @user.show tally
+    show
+    Typr.read_key
+    tally
+  end
+
+  def resolve_conflict src, dst
+    Typr.drain_input
+    info_top = top + 1
+    info = Grid.new(left:left+1, top:info_top, right:-1, bottom:info_top+2, header:"file exists. overwrite?", input:[["from", File.basename(src), (File.size(src) rescue 0), (File.mtime(src).to_i rescue 0)], ["to", File.basename(dst), (File.size(dst) rescue 0), (File.mtime(dst).to_i rescue 0)]], format:[:min,:min,:min,:min], border: :light, alternate:false, procs:{2=>:magnitudes, 3=>proc{|s| Time.at(s).strftime("%Y-%m-%d %H:%M:%S") rescue "?" }}, colors:{columns:@colors[:commands] || [:green, :red]})
+    act_top = info.bottom + 2
+    choices = %w[skip overwrite older smaller size_differs rename]
+    picker = Grid.new(left:left+1, top:act_top, right:-1, bottom:[act_top+6, Typr.height].min, header:"alt-number remembers choice", input:choices, format:[:min], border: :light, alternate:false, colors:{columns:@colors[:commands] || [:green, :red]})
+    info.show
+    idx = picker.pick(:row, column:0)
+    show
+    return [:abort, nil] unless idx.is_a?(Integer)
+    mods = picker.modifier
+    choice = choices[idx]
+    if choice == "rename"
+      renamed = @user.ask("rename to: " => [:line, {initial: File.basename(dst)}])
+      renamed ? [File.join(File.dirname(dst), renamed), nil] : [:skip, nil]
+    else
+      sym = choice.to_sym
+      [sym, mods == :alt ? sym : nil]
+    end
+  end
+
   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|cmd|dir|file|str)/]
-      cmd += $`
-      case $&
-        when '%name'; cmd += ?"+( id.nil? ? @directory :
+      pre, tok, post = $`, $&, $'
+      cmd += pre
+      case tok
+        when '%name'; sep = cmd[0] == ?! ? '", "' : '" "'; esc = cmd[0] == ?! ? /[\\"$#]/ : /[\\"$`]/
+          cmd += ?"+( id.nil? ? @directory.gsub(esc){ |m| "\\#{m}" } :
           id.is_a?( Array ) ? id.map{ |id|
-          @data[id][NAME] }.join('" "') :
-          @data[id][NAME] )+?"
+          @data[id][NAME].gsub(esc){ |m| "\\#{m}" } }.join(sep) :
+          @data[id][NAME].gsub(esc){ |m| "\\#{m}" } )+?"
         when '%dir', '%file', '%cmd'
-          @user.show "> #{prefix}#{cmd}#{$&}#{$'}#{reset}"
-          result = pick( { '%dir' => :directory, '%file' => :file, '%cmd' => :cmd }[$&] )
+          @user.show "> #{prefix}#{cmd}\e[5m#{tok}\e[25m#{post}#{reset}"
+          result = pick( { '%dir' => :directory, '%file' => :file, '%cmd' => :cmd }[tok] )
           return unless result
-          cmd += ?" + result + ?"
+          esc = cmd[0] == ?! ? /[\\"$#]/ : /[\\"$`]/
+          cmd += ?" + result.gsub(esc){ |m| "\\#{m}" } + ?"
         when '%str'
           prompt = cmd.empty? || cmd.end_with?(' ') ? cmd : "#{cmd} "
-          query = Typr.read_line "> #{prefix}#{prompt}", left: left, top: @user.top
+          query = @user.ask("#{prefix}#{prompt}" => :line)
           return unless query
           cmd += query
       end
-      str = str[($`+$&).size..-1]
+      str = post
     end
-    cmd += $' || str
+    cmd += str
     return cmd
   end
 
   def run cmd=nil
     return unless cmd
     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
-      else io = open( ?| + @term +' '+ cmd + " 2>&1" )
+    Typr.flush_overtype
+    fmt = @prefixes&.[](cmd[0].to_s)
+    if fmt
+      body = cmd[1..-1]
+      body = body.gsub(/[\\']/) { |m| "\\#{m}" } if fmt =~ /'[^']*%s/
+      result = fmt.gsub('%s') { body }
+      result.start_with?('!') ? eval(result[1..-1]) : IO.popen(result, pgroup: true)
+    else
+      IO.popen(cmd + " 2>&1")
     end
-    return io
   end
 
   def cmd_history; history @cmd_history, :cmd end
@@ -205,7 +337,7 @@ class Filecon::App < Typr::Browser
     data = data.drop 1 unless is_cmd
     return unless data.any?
 
-    top = data.max_by(@frequency_limit) { |cnt, _| cnt }
+    top = data.max_by(@top_history) { |cnt, _| cnt }
     top_set = top.filter_map { |_, e| e }.to_h { |e| [e, true] }
     ordered = top + data.reject { |_, e| top_set[e] }
 
@@ -214,12 +346,12 @@ class Filecon::App < Typr::Browser
         [File.basename(e), e]
     }
 
-    fc = is_cmd ? [:red, :blue] : [:yellow, :brown]
+    fc = is_cmd ? (@colors[:cmd_history] || [:red, :blue]) : (@colors[:dir_history] || [: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]
+      fields[[i,0]] = [fc[0], @colors[:top_history] || :grey20]
+      fields[[i,1]] = [fc[1], @colors[:top_history] || :grey20]
     }
 
     picker = popup(input: pairs, format:[:min,:max],
@@ -230,10 +362,11 @@ class Filecon::App < Typr::Browser
 
     entry = ordered[n][1]
     if is_cmd and picker.modifier == :alt
-      edited = Typr.read_line "> ", left: left, top: @user.top, initial: entry,
-        completions: true, redraw: -> { picker.show }
+      edited = @user.cli("> ", initial: entry, redraw: -> { picker.show },
+        prefixes: @prefixes&.keys&.join)
       return unless edited
-      entry = edited
+      entry = build(edited, nil)
+      return unless entry
     end
     record type, entry
 
@@ -328,26 +461,27 @@ class Filecon::App < Typr::Browser
 
   def help
     grid = @user.list
-    y = color_code :yellow
+    y = color_code (@colors[:help] || :yellow)
     d = color_code @colors[:default]
-    text = Text.new( input: "\n#{y}FILECON#{d} - a terminal file manager\n\n" \
+    text = Text.new( input: "\n#{y}FILECON#{d} - a file and command manager that lives between terminal and shell\n\n" \
       "#{y}HINTS:#{d}\n  press a number (1-9,0) to open that file with its default action.\n" \
       "  Alt+number opens the command list for that file instead.\n" \
       "  Right-click a file to open its command list.\n" \
       "  Mark files with m, then Return opens their command list.\n" \
       "  TAB cycles pages of hints.\n\n" \
       "#{y}COMMANDS:#{d}\n" \
-      "  e[x]ecute      browse all executables on your PATH\n" \
+      "  [e]xecutables  browse all executables on your PATH\n" \
+      "  e[x]ecute      type a command line and run it in the shell\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" \
+      "  entries first, then the rest in most-recent order. The top_history\n" \
+      "  setting in config.yaml (default 10) controls how many most-used entries\n" \
       "  lead the list.\n\n" \
       "#{y}CONFIG:#{d}\n  ~/.config/filecon/config.yaml\n",
       top: 2, right: -2, bottom: -3,
-      colors: { border:[:white,:grey10] },
+      colors: { border: @colors[:help_border] || [:white, :grey10] },
       border: :light )
     text.left = -> { grid.right + 2 }
     loop do
@@ -375,18 +509,13 @@ class Filecon::App < Typr::Browser
 
   def initialize args={}
     super
+    $palette = @colors.filter_map { |k, v|
+      [k.to_sym, v] if %i[black red green yellow blue magenta cyan white].include?(k.to_s.to_sym) }.to_h
     @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 7, "[R]ecurse"
-    @user.bindings.insert 8, "[c]ommands"
-    @user.bindings.insert 9, "e[x]ecute"
-    @user.bindings.insert 11, "[`]:open_current"
+    @top_history = args[:top_history] || 10
     @user.reset
   end
 
@@ -404,20 +533,40 @@ class Filecon::App < Typr::Browser
     @directory = dir
   end
 
+  # The command of a prefixed binding picked by key or by clicking its label on
+  # the bottom bar, or nil when the input is neither.
+  def prefixed_binding key
+    if key.is_a? Typr::Mouse
+      return unless key.press? and key.left?
+      key = extract_key( @user&.data_at( key.x, key.y ) )
+    end
+    return unless key.is_a? String
+    act = @bindings&.find{ |label, _| extract_key( label ) == key }&.last
+    act if act and @prefixes&.key? act[0] and !act.start_with? '!'
+  end
+
   def fly
     loop do
       show
       draw_hints :rows
       key = Typr.read_key
       next unless key
+      if act = prefixed_binding( key )
+        cmd = build act, nil
+        next unless cmd
+        show
+        run cmd
+        next
+      end
       case key
         when KEY_ESCAPE; exit
         when Typr::Mouse
+          alt = key.alt?
           if key.press? and ( key.left? or key.right? ) and target = @head.path_at( key.x, key.y )
-            key.right? ? open_path( target ) : cd( target )
+            ( key.right? or alt ) ? open_path( target ) : cd( target )
           else
             value = send( key )
-            open_file( value, !key.right? ) if value.is_a?( Integer )
+            open_file( value, !( key.right? or alt ) ) if value.is_a?( Integer )
           end
           @user.reset
         else

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: filecon
 version: !ruby/object:Gem::Version
-  version: 0.4.0
+  version: 0.5.0
 platform: ruby
 authors:
 - Kilian Reitmayr
 bindir: bin
 cert_chain: []
-date: 1980-01-02 00:00:00.000000000 Z
+date: 2026-09-30 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: typr
@@ -65,8 +65,9 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '13.0'
-description: A terminal-based file manager with customizable views, commands, and
-  MIME-type based file operations, built on the Typr terminal UI toolkit.
+description: A file and command manager that lives between terminal and shell, with
+  customizable views, commands, and MIME-type based file operations, built on the
+  Typr terminal UI toolkit.
 email:
 - reitmayr@protonmail.com
 executables:
@@ -103,5 +104,5 @@ required_rubygems_version: !ruby/object:Gem::Requirement
 requirements: []
 rubygems_version: 3.6.9
 specification_version: 4
-summary: Terminal file manager built on Typr
+summary: A file and command manager that lives between terminal and shell
 test_files: []