hiiro 0.1.0

data/docs/h-pane.md

@@ -0,0 +1,71 @@
+# h-pane
+
+Tmux pane management.
+
+[← Back to docs](README.md) | [← Back to main README](../README.md)
+
+## Usage
+
+```sh
+h pane <subcommand> [args...]
+```
+
+## Subcommands
+
+| Command | Description | Tmux equivalent |
+|---------|-------------|-----------------|
+| `ls` | List panes in current window | `tmux list-panes` |
+| `lsa` | List all panes in all sessions | `tmux list-panes -a` |
+| `split` | Split pane (default: vertical) | `tmux split-window` |
+| `splitv` | Split pane vertically | `tmux split-window -v` |
+| `splith` | Split pane horizontally | `tmux split-window -h` |
+| `kill` | Kill current pane | `tmux kill-pane` |
+| `swap` | Swap panes | `tmux swap-pane` |
+| `zoom` | Toggle pane zoom | `tmux resize-pane -Z` |
+| `capture` | Capture pane contents | `tmux capture-pane` |
+| `select` | Select a pane | `tmux select-pane` |
+| `move` | Move pane to another window | `tmux move-pane` |
+| `break` | Break pane into new window | `tmux break-pane` |
+| `join` | Join pane from another window | `tmux join-pane` |
+| `resize` | Resize pane | `tmux resize-pane` |
+
+## Examples
+
+```sh
+# List panes in current window
+h pane ls
+
+# Split horizontally (side by side)
+h pane splith
+
+# Split vertically (top/bottom)
+h pane splitv
+
+# Toggle zoom on current pane
+h pane zoom
+
+# Kill current pane
+h pane kill
+
+# Swap with the next pane
+h pane swap -D
+
+# Select pane by index
+h pane select -t 2
+
+# Resize current pane
+h pane resize -D 10    # Grow down by 10 lines
+h pane resize -R 20    # Grow right by 20 columns
+
+# Break current pane into a new window
+h pane break
+
+# Join pane from window 3 into current window
+h pane join -s :3
+```
+
+## Notes
+
+- Pane indices start at 0
+- Use `-t` to target specific panes (e.g., `-t 0`, `-t :.1`)
+- All subcommands pass additional arguments directly to the underlying tmux command

data/docs/h-plugin.md

@@ -0,0 +1,58 @@
+# h-plugin
+
+Hiiro plugin management and exploration.
+
+[← Back to docs](README.md) | [← Back to main README](../README.md)
+
+## Usage
+
+```sh
+h plugin <subcommand> [args...]
+```
+
+## Subcommands
+
+| Command | Description |
+|---------|-------------|
+| `path` | Print the plugins directory path |
+| `ls` | List all plugin files |
+| `edit` | Edit plugin file(s) in your editor |
+| `rg` | Search plugin code (smart-case) |
+| `rgall` | Search plugin code (include VCS-ignored files) |
+
+## Examples
+
+```sh
+# Get the plugins directory
+h plugin path
+# => ~/.config/hiiro/plugins
+
+# List all plugins
+h plugin ls
+
+# Edit the h-plugin script itself
+h plugin edit
+
+# Edit specific plugin(s) by prefix
+h plugin edit pins          # Edit pins.rb
+h plugin edit task project  # Edit task.rb and project.rb
+
+# Search for a method across all plugins
+h plugin rg "def load"
+
+# Search with regex
+h plugin rg "add_subcmd.*:session"
+
+# Include normally-ignored files
+h plugin rgall "TODO"
+```
+
+## Plugin Location
+
+Plugins are stored in `~/.config/hiiro/plugins/`. Files in this directory are automatically loaded by Hiiro.
+
+## Notes
+
+- The `rg` command uses ripgrep with smart-case matching (`-S`)
+- The `edit` command uses `$EDITOR` or falls back to `safe_nvim`
+- Plugin names are matched by prefix, so `h plugin edit pi` would match `pins.rb`

data/docs/h-session.md

@@ -0,0 +1,63 @@
+# h-session
+
+Tmux session management.
+
+[← Back to docs](README.md) | [← Back to main README](../README.md)
+
+## Usage
+
+```sh
+h session <subcommand> [args...]
+```
+
+## Subcommands
+
+| Command | Description | Tmux equivalent |
+|---------|-------------|-----------------|
+| `ls` | List all sessions | `tmux list-sessions` |
+| `new` | Create a new session | `tmux new-session` |
+| `kill` | Kill a session | `tmux kill-session` |
+| `attach` | Attach to a session | `tmux attach-session` |
+| `rename` | Rename a session | `tmux rename-session` |
+| `switch` | Switch to another session | `tmux switch-client` |
+| `detach` | Detach from current session | `tmux detach-client` |
+| `has` | Check if session exists | `tmux has-session` |
+| `info` | Show current session info | `tmux display-message` |
+
+## Examples
+
+```sh
+# List all sessions
+h session ls
+
+# Create a new session named "work"
+h session new -s work
+
+# Create detached session
+h session new -d -s background
+
+# Attach to a session
+h session attach -t work
+
+# Kill a session
+h session kill -t old-session
+
+# Rename current session
+h session rename newname
+
+# Switch to another session
+h session switch -t other
+
+# Check if session exists (useful in scripts)
+h session has -t mysession && echo "exists"
+
+# Show current session info
+h session info
+# => mysession: 5 windows, 1 attached
+```
+
+## Notes
+
+- Use `-t` to target specific sessions
+- All subcommands pass additional arguments directly to the underlying tmux command
+- The `info` command shows session name, window count, and attach count

data/docs/h-video.md

@@ -0,0 +1,172 @@
+# h-video
+
+FFmpeg wrapper for common video operations.
+
+[← Back to docs](README.md) | [← Back to main README](../README.md)
+
+## Usage
+
+```sh
+h video <subcommand> <input_file> [args...]
+```
+
+## Requirements
+
+- FFmpeg and FFprobe must be installed
+
+## Subcommands
+
+### Info / Inspection
+
+| Command | Description |
+|---------|-------------|
+| `info <file>` | Human-readable video summary |
+| `streams <file>` | List all streams (video, audio, subs) |
+| `duration <file>` | Get video duration |
+| `metadata <file>` | Show metadata as JSON |
+| `list_subs <file>` | List subtitle tracks |
+| `help` | Show full command reference |
+
+### Resizing
+
+| Command | Description |
+|---------|-------------|
+| `resize <file> [height] [out]` | Resize to height (default 720) |
+| `resize720 <file> [out]` | Resize to 720p |
+| `resize1080 <file> [out]` | Resize to 1080p |
+
+### Format Conversion
+
+| Command | Description |
+|---------|-------------|
+| `convert <file> <format> [out]` | Convert to format (mp4, mkv, webm, etc.) |
+| `to_mp4 <file> [out]` | Convert to MP4 (H.264/AAC) |
+| `to_webm <file> [out]` | Convert to WebM (VP9/Opus) |
+| `to_mkv <file> [out]` | Remux to MKV container |
+
+### Audio Extraction
+
+| Command | Description |
+|---------|-------------|
+| `audio <file> [out]` | Extract audio as MP3 |
+| `audio_wav <file> [out]` | Extract audio as WAV |
+| `audio_aac <file> [out]` | Extract audio as AAC |
+| `audio_flac <file> [out]` | Extract audio as FLAC |
+| `mute <file> [out]` | Remove audio track |
+| `replace_audio <video> <audio> [out]` | Replace audio track |
+| `volume <file> <level> [out]` | Adjust volume (2.0 = 2x, 0.5 = half) |
+
+### Clipping
+
+| Command | Description |
+|---------|-------------|
+| `clip <file> <start> <duration> [out]` | Extract clip by duration |
+| `clip_to <file> <start> <end> [out]` | Extract clip by end time |
+| `clip_precise <file> <start> <dur> [out]` | Re-encoded clip (more accurate) |
+
+### Subtitles
+
+| Command | Description |
+|---------|-------------|
+| `subs <file> [stream_idx] [out]` | Extract subtitle track (default: first) |
+| `subs_all <file>` | Extract all subtitle tracks |
+
+### Images / Thumbnails
+
+| Command | Description |
+|---------|-------------|
+| `thumbnail <file> [time] [out]` | Extract single frame |
+| `thumbnails <file> [interval] [pattern]` | Extract frames every N seconds |
+
+### GIF Creation
+
+| Command | Description |
+|---------|-------------|
+| `gif <file> [start] [duration] [out]` | Create GIF (standard quality) |
+| `gif_hq <file> [start] [duration] [out]` | Create high-quality GIF |
+
+### Transformation
+
+| Command | Description |
+|---------|-------------|
+| `speed <file> <factor> [out]` | Change speed (2.0 = 2x faster) |
+| `rotate <file> [dir] [out]` | Rotate (cw, ccw, 180) |
+| `flip_h <file> [out]` | Flip horizontally |
+| `flip_v <file> [out]` | Flip vertically |
+| `crop <file> <w:h:x:y> [out]` | Crop video |
+| `fps <file> <rate> [out]` | Change frame rate |
+
+### Compression
+
+| Command | Description |
+|---------|-------------|
+| `compress <file> [crf] [out]` | Compress (crf: 18-28, higher = smaller) |
+| `compress_small <file> [out]` | Aggressive compression + 480p |
+
+### Other
+
+| Command | Description |
+|---------|-------------|
+| `concat <file1> <file2> ... <out>` | Join multiple videos |
+| `strip_metadata <file> [out]` | Remove all metadata |
+
+## Examples
+
+```sh
+# Get video info
+h video info movie.mp4
+
+# Resize to 720p
+h video resize720 movie.mp4
+
+# Convert MKV to MP4
+h video to_mp4 movie.mkv
+
+# Extract 60 seconds starting at 1:30
+h video clip movie.mp4 00:01:30 60
+
+# Extract clip from 1:30 to 2:30
+h video clip_to movie.mp4 00:01:30 00:02:30
+
+# Create a GIF from the first 10 seconds
+h video gif movie.mp4 00:00:00 10
+
+# Extract audio as MP3
+h video audio movie.mp4
+
+# Double the playback speed
+h video speed movie.mp4 2.0
+
+# Rotate 90 degrees clockwise
+h video rotate movie.mp4 cw
+
+# Compress with CRF 28 (more compression)
+h video compress movie.mp4 28
+
+# Concatenate videos
+h video concat part1.mp4 part2.mp4 part3.mp4 output.mp4
+
+# Extract thumbnail at 30 seconds
+h video thumbnail movie.mp4 00:00:30
+```
+
+## Time Format
+
+Time can be specified as:
+- `HH:MM:SS` (e.g., `01:30:00` for 1 hour 30 minutes)
+- `MM:SS` (e.g., `05:30` for 5 minutes 30 seconds)
+- Seconds (e.g., `90` for 1 minute 30 seconds)
+
+## Output Files
+
+If no output file is specified, files are automatically named based on the operation:
+- `movie.720p.mp4` for resize operations
+- `movie.clip_00-01-30.mp4` for clip operations
+- `movie.audio.mp3` for audio extraction
+- etc.
+
+## Notes
+
+- All commands pass through to FFmpeg
+- The `clip` commands use stream copy (`-c copy`) for speed; use `clip_precise` for frame-accurate cuts
+- GIF operations use palette generation for better quality

data/docs/h-window.md

@@ -0,0 +1,77 @@
+# h-window
+
+Tmux window management.
+
+[← Back to docs](README.md) | [← Back to main README](../README.md)
+
+## Usage
+
+```sh
+h window <subcommand> [args...]
+```
+
+## Subcommands
+
+| Command | Description | Tmux equivalent |
+|---------|-------------|-----------------|
+| `ls` | List windows in current session | `tmux list-windows` |
+| `lsa` | List all windows in all sessions | `tmux list-windows -a` |
+| `new` | Create a new window | `tmux new-window` |
+| `kill` | Kill current window | `tmux kill-window` |
+| `rename` | Rename current window | `tmux rename-window` |
+| `swap` | Swap windows | `tmux swap-window` |
+| `move` | Move window | `tmux move-window` |
+| `select` | Select a window | `tmux select-window` |
+| `next` | Go to next window | `tmux next-window` |
+| `prev` | Go to previous window | `tmux previous-window` |
+| `last` | Go to last active window | `tmux last-window` |
+| `link` | Link window to another session | `tmux link-window` |
+| `unlink` | Unlink window from session | `tmux unlink-window` |
+
+## Examples
+
+```sh
+# List windows in current session
+h window ls
+
+# List all windows across all sessions
+h window lsa
+
+# Create a new window
+h window new
+
+# Create window with a name
+h window new -n editor
+
+# Create window running a command
+h window new -n logs "tail -f /var/log/syslog"
+
+# Kill window by index
+h window kill -t 3
+
+# Rename current window
+h window rename mywindow
+
+# Navigate windows
+h window next
+h window prev
+h window last
+
+# Select window by index
+h window select -t 2
+
+# Swap current window with window 1
+h window swap -t 1
+
+# Move window to index 5
+h window move -t 5
+
+# Link window 2 to session "other"
+h window link -s :2 -t other:
+```
+
+## Notes
+
+- Window indices typically start at 0 or 1 depending on `base-index` setting
+- Use `-t` to target specific windows (e.g., `-t 0`, `-t :2`, `-t session:window`)
+- All subcommands pass additional arguments directly to the underlying tmux command

data/exe/hiiro

@@ -0,0 +1,13 @@
+#!/usr/bin/env ruby
+
+require "hiiro"
+
+Hiiro.load_env
+
+hiiro = Hiiro.init(*ARGV, cwd: Dir.pwd)
+
+hiiro.add_subcommand(:ping) { |*args|
+  puts "pong"
+}
+
+hiiro.run

data/hiiro.gemspec

@@ -0,0 +1,30 @@
+require_relative "lib/hiiro/version"
+
+Gem::Specification.new do |spec|
+  spec.name          = "hiiro"
+  spec.version       = Hiiro::VERSION
+  spec.authors       = ["Joshua Toyota"]
+  spec.email         = ["jearsh+rubygems@gmail.com"]
+
+  spec.summary       = "A lightweight CLI framework for Ruby"
+  spec.description   = "Build multi-command CLI tools with subcommand dispatch, abbreviation matching, and a plugin system. Similar to git or docker command structure."
+  spec.homepage      = "https://github.com/unixsuperhero/hiiro"
+  spec.license       = "MIT"
+  spec.required_ruby_version = ">= 2.7.0"
+
+  spec.metadata["homepage_uri"] = spec.homepage
+  spec.metadata["source_code_uri"] = spec.homepage
+  spec.metadata["changelog_uri"] = "#{spec.homepage}/blob/main/CHANGELOG.md"
+
+  spec.files = Dir.chdir(__dir__) do
+    `git ls-files -z`.split("\x0").reject do |f|
+      (File.expand_path(f) == __FILE__) ||
+        f.start_with?(*%w[test/ spec/ features/ .git .github .circleci appveyor Gemfile])
+    end
+  end
+  spec.bindir = "exe"
+  spec.executables = spec.files.grep(%r{\Aexe/}) { |f| File.basename(f) }
+  spec.require_paths = ["lib"]
+
+  spec.add_dependency "pry", "~> 0.14"
+end

data/lib/hiiro/version.rb

@@ -0,0 +1,3 @@
+class Hiiro
+  VERSION = "0.1.0"
+end