hiiro 0.1.351 → 0.1.353

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: '0586a9cc0e070785c9a0ef12282146ed71172875e706480d3dca6d663f5a46e8'
-  data.tar.gz: ffec55f5b2ce8882cb06189dedf5e29ccb75a3b8214a76fc72e7dc460851f2cd
+  metadata.gz: bbd7598e65b8521905ec67a960f09700d7260c5329e066e6cfcbb4661c180c99
+  data.tar.gz: 189ca275fa4cc2af210c1d67c8976bc4b90343e68eb4a0fe86ebedea1421bb9f
 SHA512:
-  metadata.gz: e40c167924bce7ac225b17e0fd7c82855c0d6034e66814c4b3e4897ee00dc80b9214b52dafe4d3a98c7916b0194c0a7d4b234e9f55a5a51fd0d73329315132ee
-  data.tar.gz: 994e44431c7a4dc5a15a2eaaa0ffa6c9b0382229b5d84dac1521c56129b599c08316e124511e6f5cf830e7189ab326672e599c228c11b7ddb7776be42c86bfdc
+  metadata.gz: 50b6f3d077471531303d04f9ef234ff4ade40dbea85b52f575e6c9e3c48088ba1318dd0798eaeef15acdeb4ce0ca8fcf13100d4963fb5174dccdefaf87de228f
+  data.tar.gz: 4c852f5cea47667811dd2dd461b5c1bdfe3935cc7fecad2c95c7d3d43f28d3c7aea0554ea415cfda812e776b047bf4dee9ef77b34fdb0ffc5b806170864e2705

data/AGENTS.md

@@ -0,0 +1 @@
+CLAUDE.md

data/CHANGELOG.md

@@ -2,9 +2,22 @@
 
 ## [Unreleased]
 
+## [0.1.353] - 2026-04-26
+
+### Added
+- `Hiiro::Tui::ListScreen` for building keyboard-driven full-screen list interfaces
+- `Hiiro::Config.load_yaml` and `Hiiro::Config.yaml_dig` helpers for YAML file loading with nested key access
+
+## [0.1.352] - 2026-04-24
+
+### Added
+- `h claude all|agents|commands|skills` now support `--absolute/-a` to print absolute tool paths; skill matches resolve to `SKILL.md`
+
 ### Fixed
 - `h capture path <num>` now prints the path of the Nth most recent capture (was always printing the captures dir regardless of args)
 - `h capture new` / `h capture file` now record to the DB even when interrupted (Ctrl-C, exception) so partial captures show up in `h capture ls`. Interrupted captures display with the existing `?` glyph and `(exit interrupted)` message.
+- `h pane splitv/splith` subcommand mappings corrected
+- Corrected `REPO_PATH` constant from `.bare` to `.git`
 
 ## [0.1.350] - 2026-04-18
 

data/README.md

@@ -8,6 +8,7 @@ A lightweight, extensible CLI framework for Ruby. Build your own multi-command t
 - **Abbreviation matching** - Type `h ex hel` instead of `h example hello`
 - **Plugin system** - Extend functionality with reusable modules
 - **Per-command storage** - Each command gets its own pin/config namespace
+- **TUI helpers** - Build keyboard-driven list screens with `Hiiro::Tui::ListScreen`
 
 See [docs/](docs/) for detailed documentation on all subcommands.
 
@@ -93,6 +94,8 @@ h ping
 | `h window` | Tmux window management |
 | `h wtree` | Git worktree management |
 
+`h claude agents|commands|skills -a` prints the absolute file path for each matching `.claude` tool, including `SKILL.md` for skills.
+
 ## Abbreviations
 
 Any subcommand can be abbreviated as long as the prefix uniquely matches:
@@ -152,6 +155,10 @@ h example hello  # => Hi!
 h example bye    # => Goodbye!
 ```
 
+### Building TUIs
+
+Use `Hiiro::Tui::ListScreen` for simple full-screen list interfaces. Subclass it, override `header_lines`, `format_row`, and `handle_key`, then run it from a normal `Hiiro.run` subcommand.
+
 ### Method 2: Inline Subcommands
 
 Modify `exe/h` directly to add subcommands to the base `h` command:

data/bin/h-claude

@@ -17,11 +17,26 @@ opts = Hiiro::Options.setup {
 
 tool_opts = Hiiro::Options.setup {
   flag(:full, short: :f, default: false, desc: 'fulltext search - full grep file or dir')
+  flag(:absolute, short: :a, default: false, desc: 'print absolute path to matching tool file')
   flag(:verbose, short: :v, default: false, desc: 'display claude dirs in stderr')
   flag(:veryverbose, short: :V, default: false, desc: 'display all stderr messages')
 }
 
-def glob_path(glob, bname=nil, opts:)
+def tool_file(path, skill: false)
+  return path unless skill
+
+  path / 'SKILL.md'
+end
+
+def display_tool_path(path, bname: nil, opts:, skill: false)
+  target = tool_file(path, skill: skill)
+  return target if opts.absolute
+  return path.basename if skill
+
+  target.basename(bname.to_s)
+end
+
+def glob_path(glob, bname=nil, opts:, skill: false)
   filters = opts.args
   fulltext = opts.full
   bname ||= ''
@@ -46,6 +61,7 @@ def glob_path(glob, bname=nil, opts:)
       cmd = ['egrep', *more_args, '-m1', re_s, f.to_s]
       kwcmd = { out: File.open('/dev/null', 'w') }
       base_f = f.basename(bname)
+      display_f = display_tool_path(f, bname: bname, opts: opts, skill: skill)
 
       matches = 
         if fulltext
@@ -55,7 +71,7 @@ def glob_path(glob, bname=nil, opts:)
         end
 
       if matches
-        puts base_f
+        puts display_f
       else
         $stderr.puts "SKIPPING #{base_f}" if opts.veryverbose
       end
@@ -74,7 +90,7 @@ def collect_files(glob, bname=nil, opts:, skill: false)
   claude_paths.flat_map { |path| path.glob(glob) }.filter_map do |f|
     base_f = f.basename(bname.to_s)
     next unless base_f.to_s.match?(re)
-    target = skill ? f / 'SKILL.md' : f
+    target = tool_file(f, skill: skill)
     target if target.exist?
   end
 end
@@ -171,7 +187,7 @@ add_subcmd(:env) { |*args|
     opts = tool_opts.parse(args)
     glob_path('agents/*.md', '.md', opts: opts)
     glob_path('commands/*.md', '.md', opts: opts)
-    glob_path('skills/*/', opts: opts)
+    glob_path('skills/*/', opts: opts, skill: true)
   }
 
   add_subcmd(:agents) { |*args|
@@ -186,7 +202,7 @@ add_subcmd(:env) { |*args|
 
   add_subcmd(:skills) { |*args|
     opts = tool_opts.parse(args)
-    glob_path('skills/*/', opts: opts)
+    glob_path('skills/*/', opts: opts, skill: true)
   }
 
   add_subcmd(:vim) { |*args|

data/bin/h-pane

@@ -61,7 +61,7 @@ Hiiro.run(*ARGV, plugins: [Pins]) do
     system('tmux', 'split-window', *args)
   }
 
-  add_subcmd(:splitv) { |*args|
+  add_subcmd(:hsplit, :splith) { |*args|
     if args.empty?
       tmux.split_window(horizontal: false)
     else
@@ -69,7 +69,7 @@ Hiiro.run(*ARGV, plugins: [Pins]) do
     end
   }
 
-  add_subcmd(:splith) { |*args|
+  add_subcmd(:vsplit, :splitv) { |*args|
     if args.empty?
       tmux.split_window(horizontal: true)
     else

data/docs/h-claude.md

@@ -77,6 +77,7 @@ List agent, command, and skill files found in `.claude/` directories from the cu
 | Flag | Short | Description |
 |------|-------|-------------|
 | `--full` | `-f` | Full text search (grep inside files) |
+| `--absolute` | `-a` | Print the absolute path to each matching tool file (`SKILL.md` for skills) |
 | `--verbose` | `-v` | Show `.claude` paths being searched |
 | `--veryverbose` | `-V` | Show all paths including skipped |
 
@@ -85,7 +86,9 @@ List agent, command, and skill files found in `.claude/` directories from the cu
 ```bash
 h claude all
 h claude agents fetch
+h claude agents -a fetch
 h claude commands refactor
+h claude skills -a review
 h claude skills -f "pull request"
 ```
 
@@ -333,7 +336,7 @@ h claude vadd "Write tests for foo"
 
 ### vim
 
-Open matching agent, command, and skill files in your editor. Uses the same filter logic as `all`.
+Open matching agent, command, and skill files in your editor. Uses the same filter logic and search flags as `all`; matches are opened via their absolute file paths.
 
 **Examples**
 

data/lib/hiiro/config.rb

@@ -1,3 +1,5 @@
+require 'yaml'
+
 class Hiiro
   class Config
     BASE_DIR = File.join(Dir.home, '.config/hiiro')
@@ -15,6 +17,36 @@ class Hiiro
         File.join(BASE_DIR, relpath)
       end
 
+      def load_yaml(relpath = 'config.yml', default: {}, permitted_classes: [Symbol])
+        file = path(relpath)
+        return default unless File.exist?(file)
+
+        YAML.safe_load_file(file, permitted_classes: permitted_classes) || default
+      rescue StandardError
+        default
+      end
+
+      def yaml_dig(relpath = 'config.yml', *keys, default: nil, permitted_classes: [Symbol])
+        value = load_yaml(relpath, default: {}, permitted_classes: permitted_classes)
+
+        keys.flatten.each do |key|
+          return default unless value.is_a?(Hash)
+
+          value =
+            if value.key?(key)
+              value[key]
+            elsif value.key?(key.to_s)
+              value[key.to_s]
+            elsif key.respond_to?(:to_sym) && value.key?(key.to_sym)
+              value[key.to_sym]
+            else
+              return default
+            end
+        end
+
+        value.nil? ? default : value
+      end
+
       def data_path(relpath='')
         File.join(DATA_DIR, relpath)
       end

data/lib/hiiro/tui.rb

@@ -0,0 +1,216 @@
+require 'io/console'
+
+class Hiiro
+  module Tui
+    module Terminal
+      def with_screen
+        input = $stdin
+        $stdout.write("\e[?1049h\e[?25l")
+        $stdout.flush
+
+        input.raw do
+          yield input
+        end
+      ensure
+        $stdout.write("\r\e[0m\e[?25h\e[?1049l")
+        $stdout.flush
+      end
+
+      def read_key(input)
+        char = input.getch
+        return :ctrl_c if char == "\u0003"
+        return :enter if char == "\r" || char == "\n"
+
+        if char == "\e"
+          first = read_escape_char(input)
+          return :escape if first.nil?
+          return :escape unless first == '['
+
+          case read_escape_char(input)
+          when 'A' then :up
+          when 'B' then :down
+          when 'C' then :right
+          when 'D' then :left
+          else :escape
+          end
+        else
+          char
+        end
+      end
+
+      def read_escape_char(input)
+        return nil unless IO.select([input], nil, nil, 0.02)
+
+        input.getch
+      end
+
+      def terminal_rows
+        env_dimension('LINES') || IO.console.winsize[0]
+      rescue StandardError
+        24
+      end
+
+      def terminal_cols
+        env_dimension('COLUMNS') || IO.console.winsize[1]
+      rescue StandardError
+        80
+      end
+
+      def terminal_line(text, cols)
+        truncate(text, cols) + "\e[K"
+      end
+
+      def center_text(text, cols)
+        truncated = truncate(text, cols)
+        return truncated if truncated.length >= cols
+
+        left_padding = [(cols - truncated.length) / 2, 0].max
+        (' ' * left_padding) + truncated
+      end
+
+      def truncate(text, cols)
+        return text if text.length <= cols
+        return text[0, cols] if cols <= 1
+
+        text[0, cols - 1] + '…'
+      end
+
+      def visible_text(text, cols, offset = 0)
+        return truncate(text, cols) if offset <= 0
+
+        clipped = text[offset..] || ''
+        return truncate(clipped, cols) if cols <= 1
+
+        truncate("«#{clipped}", cols)
+      end
+
+      def env_dimension(name)
+        value = ENV[name].to_i
+        return nil unless value.positive?
+
+        value
+      end
+    end
+
+    class ListScreen
+      include Terminal
+
+      attr_reader :items, :cursor, :top, :horizontal_offset
+
+      def initialize(items:, empty_message: 'No items.')
+        @items = items
+        @empty_message = empty_message
+        @cursor = 0
+        @top = 0
+        @horizontal_offset = 0
+      end
+
+      def run
+        if items.empty?
+          puts @empty_message
+          return false
+        end
+
+        with_screen do |input|
+          loop do
+            render
+
+            result = handle_key(read_key(input))
+            return result unless result == :continue
+          end
+        end
+      end
+
+      def handle_key(key)
+        case key
+        when :up, 'k'
+          move(-1)
+        when :down, 'j'
+          move(1)
+        when :left, 'h'
+          scroll_horizontal(-4)
+        when :right, 'l'
+          scroll_horizontal(4)
+        when 'q', :escape, :ctrl_c
+          return false
+        end
+
+        :continue
+      end
+
+      def render
+        rows = terminal_rows
+        cols = terminal_cols
+        line_cols = [cols - 1, 1].max
+        headers = header_lines
+        visible_rows = [rows - headers.length - footer_height, 1].max
+        visible = items[@top, visible_rows] || []
+        @horizontal_offset = [horizontal_offset, max_horizontal_offset(line_cols, visible)].min
+
+        lines = headers.map { |line| terminal_line(line, line_cols) }
+        visible.each_with_index do |item, idx|
+          lines << format_row(item, @top + idx == cursor, line_cols)
+        end
+
+        (visible_rows - visible.length).times { lines << terminal_line('', line_cols) }
+        footer_lines.each { |line| lines << terminal_line(line, line_cols) }
+
+        $stdout.write("\e[H\e[2J")
+        $stdout.write(lines.join("\r\n"))
+        $stdout.write("\r")
+        $stdout.flush
+      end
+
+      def header_lines
+        []
+      end
+
+      def footer_lines
+        ["Showing #{@top + 1}-#{@top + visible_items.length} of #{items.length}"]
+      end
+
+      def footer_height
+        1
+      end
+
+      def format_row(item, current, line_cols)
+        prefix = current ? '> ' : '  '
+        style = current ? "\e[7m" : "\e[0m"
+        text = (prefix + visible_text(item.to_s, [line_cols - prefix.length, 1].max, horizontal_offset)).ljust(line_cols)
+
+        "#{style}#{text}\e[0m\e[K"
+      end
+
+      def move(delta)
+        @cursor = [[cursor + delta, 0].max, items.length - 1].min
+        visible_rows = body_rows_budget
+        @top = cursor if cursor < top
+        @top = cursor - visible_rows + 1 if cursor >= top + visible_rows
+        @horizontal_offset = [horizontal_offset, max_horizontal_offset].min
+      end
+
+      def scroll_horizontal(delta)
+        @horizontal_offset = [[horizontal_offset + delta, 0].max, max_horizontal_offset].min
+      end
+
+      def visible_items
+        items[top, body_rows_budget] || []
+      end
+
+      def body_rows_budget
+        [terminal_rows - header_lines.length - footer_height, 1].max
+      end
+
+      def max_horizontal_offset(line_cols = nil, visible = nil)
+        line_cols ||= [terminal_cols - 1, 1].max
+        visible ||= visible_items
+        return 0 if visible.empty?
+
+        longest_visible_item = visible.map { |item| item.to_s.length }.max || 0
+        min_visible_chars = [5, line_cols].min
+
+        [longest_visible_item - min_visible_chars, 0].max
+      end
+    end
+  end
+end

data/lib/hiiro/version.rb

@@ -1,3 +1,3 @@
 class Hiiro
-  VERSION = "0.1.351"
+  VERSION = "0.1.353"
 end

data/lib/hiiro.rb

@@ -47,6 +47,7 @@ require_relative "hiiro/pane_home"
 require_relative "hiiro/pin_record"
 require_relative "hiiro/reminder"
 require_relative 'hiiro/registry'
+require_relative 'hiiro/tui'
 
 class String
   def underscore(camel_cased_word=self)
@@ -63,7 +64,7 @@ end
 
 class Hiiro
   WORK_DIR = File.join(Dir.home, 'work')
-  REPO_PATH = File.join(WORK_DIR, '.bare')
+  REPO_PATH = File.join(WORK_DIR, '.git')
 
   def self.init(*oargs, plugins: [], logging: false, tasks: false, task_scope: nil, **values, &block)
     load_env

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: hiiro
 version: !ruby/object:Gem::Version
-  version: 0.1.351
+  version: 0.1.353
 platform: ruby
 authors:
 - Joshua Toyota
@@ -119,6 +119,7 @@ extra_rdoc_files: []
 files:
 - ".DS_Store"
 - ".config/.keep"
+- AGENTS.md
 - CHANGELOG.md
 - CLAUDE.md
 - LICENSE
@@ -376,6 +377,7 @@ files:
 - lib/hiiro/tmux/window.rb
 - lib/hiiro/tmux/windows.rb
 - lib/hiiro/todo.rb
+- lib/hiiro/tui.rb
 - lib/hiiro/version.rb
 - notes
 - obsidian_slides.md