rufio 0.21.0 → 0.31.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 2273fb7a1731d8d60e7a617d9055bdff0f7f5cd92f85eaa36d91dd266cf01773
-  data.tar.gz: e599d21775fd19631fca769972977f3a98771afae998b2523e16cf84d2b30d12
+  metadata.gz: a7c5ebea1d23ee7dfd964bdfa8b3ed9a99fa404b6c1f4fc5f1af3afaa2567f42
+  data.tar.gz: 3f74121e14480e2d75a12cccca5c2984f6e7da5f894a89d8fb782a9a3fd9428e
 SHA512:
-  metadata.gz: 7c66f9c83af723f5a993bfdec6e68b801320394e0912d94431986747e36f86cceea8afc0fa63fc345f2f1a045c1eb8753fb9e1cc238762a49e4f4d5f162f8cb4
-  data.tar.gz: 36c12657770e86c3f36054a735761db1e0207bbf70b2a89588b988f33fffc42ed2c00e00ace7595a7f9cc93ed95c3ad1097bbafb732db14d488727417b859345
+  metadata.gz: 410b4b98fd4ea4ba3ef077fb31432f7974377be3e971bba1b60f390be99a8547e1cd5afb7b0209d631ed85cd5b87d519571b0fe1f1d6fb76ef58801be2911895
+  data.tar.gz: 345156bf65cae10f7a64756c9882d065e483519fb2f3ec6360dfbe729e0c88a7d42ada9c9b920b25dfa5ce2e81e216281677c239ae4b21672996535bb3799912

data/CHANGELOG_v0.30.0.md

@@ -0,0 +1,148 @@
+# Changelog - v0.30.0
+
+## Release Date: 2025-12-30
+
+## New Features & Improvements
+
+### Help System Overhaul
+
+#### Help Mode (Press `?`)
+- **Full-screen help mode** instead of popup dialog
+  - Browse help documentation files in `info/` directory
+  - Uses normal file manager UI for navigation
+  - Navigation restricted to `info/` directory (cannot go to parent)
+  - Press `ESC` to exit help mode and return to previous directory
+
+#### Help Documentation
+- Converted all help files to **Markdown format** (`.md`)
+- **Unified language**: All documentation now in English
+- Created comprehensive help files:
+  - `info/welcome.md` - Introduction and quick start guide
+  - `info/help.md` - Complete feature documentation with table of contents
+  - `info/keybindings.md` - Full keybindings reference organized by category
+
+### Preview Pane Scrolling
+
+#### Enter Key Behavior Change
+- Press `Enter` on a **file** to focus preview pane (instead of doing nothing)
+- Press `Enter` on a **directory** to navigate into it (unchanged)
+- Preview pane shows `[PREVIEW MODE]` indicator when focused
+
+#### Scroll Controls in Preview Mode
+- `j` / `↓` : Scroll down one line
+- `k` / `↑` : Scroll up one line
+- `Ctrl+D` : Scroll down half page (20 lines)
+- `Ctrl+U` : Scroll up half page (20 lines)
+- `ESC` : Exit preview mode and return focus to directory list
+
+#### Smart Scroll Management
+- Scroll position automatically resets when changing files
+- Scroll position cannot go below zero
+- Works in both **normal mode** and **help mode**
+
+### UI Improvements
+
+#### Footer Enhancements
+- **Bookmark list with numbers**: `0.dirname 1.bookmark1 2.bookmark2 ...`
+- **Bookmark 0**: Jump to startup directory with `0` key
+- **Processing time**: Display render time in milliseconds
+- **Help hint**: `?:help` shown on the right side
+- Removed time and version display from footer (simplified layout)
+
+#### Project Mode Improvements
+- Bookmark list displays with numbers: `1. project1`, `2. project2`, etc.
+- Improved consistency with bookmark number navigation
+
+### Header Improvements
+- Help mode indicator: `[Help Mode - Press ESC to exit]`
+- Version information moved to help dialog
+
+## Technical Changes
+
+### New Methods
+
+**KeybindHandler**:
+- `help_mode?` - Check if help mode is active
+- `enter_help_mode` - Enter help mode (navigate to `info/` directory)
+- `exit_help_mode` - Exit help mode and return to previous directory
+- `navigate_parent_with_restriction` - Navigate parent with `info/` directory restriction
+- `preview_focused?` - Check if preview pane is focused
+- `focus_preview_pane` - Focus preview pane (file only)
+- `unfocus_preview_pane` - Unfocus preview pane
+- `preview_scroll_offset` - Get current scroll offset
+- `scroll_preview_down` - Scroll preview down one line
+- `scroll_preview_up` - Scroll preview up one line
+- `scroll_preview_page_down` - Scroll preview down half page (Ctrl+D)
+- `scroll_preview_page_up` - Scroll preview up half page (Ctrl+U)
+- `reset_preview_scroll` - Reset scroll position
+- `handle_enter_key` - Handle Enter key (focus preview or navigate)
+- `handle_preview_focus_key` - Handle keys in preview mode
+
+**TerminalUI**:
+- `draw_header` - Updated to show help mode indicator
+- `draw_footer` - Updated to show bookmarks with numbers and processing time
+- `draw_file_preview` - Updated to apply scroll offset and show preview mode indicator
+
+### Modified Behavior
+
+**Keybindings**:
+- `?` - Enter help mode (was: show help dialog)
+- `Enter` - Focus preview pane on files / Navigate on directories (was: navigate only)
+- `h` - Navigate parent with restriction in help mode (was: unrestricted)
+- `ESC` - Exit help mode or unfocus preview pane (was: clear filter only)
+
+**Directory Navigation**:
+- `DirectoryListing#initialize` - Save startup directory as `start_directory`
+- `KeybindHandler#goto_start_directory` - Jump to startup directory with `0` key
+
+### Layout Constants
+- `HEADER_FOOTER_MARGIN = 3` - Header + Footer (2-line layout)
+
+## Usage Guide
+
+### Help Mode
+1. Press `?` to enter help mode
+2. Navigate help files using `j/k/h/l` keys
+3. Press `Enter` or `l` to view a help file
+4. Press `h` to go back (restricted to `info/` directory)
+5. Press `ESC` to exit help mode
+
+### Preview Scrolling
+1. Select a file with `j/k` keys
+2. Press `Enter` to focus preview pane
+3. Use `j/k` or arrow keys to scroll line by line
+4. Use `Ctrl+D` / `Ctrl+U` for page scrolling
+5. Press `ESC` to return to directory list
+
+### Bookmarks
+- `b` - Add current directory to bookmarks
+- `0` - Jump to startup directory
+- `1-9` - Jump to bookmarks 1-9
+- `p` - Enter project mode (browse all bookmarks)
+
+## Testing
+
+### New Test Files
+- `test/test_help_mode.rb` - Help mode functionality tests
+- `test/test_preview_scroll.rb` - Preview scrolling tests
+
+### Test Results
+- **329 tests** passing
+- **1444 assertions**
+- **0 failures**
+- **0 errors**
+
+## Compatibility
+
+- Ruby 3.0 or higher
+- Maintains compatibility with existing configuration files
+- Maintains compatibility with existing bookmark data
+- All help files now in English (breaking change for Japanese users)
+
+## Known Issues
+
+None
+
+---
+
+**Full Changelog**: v0.21.0...v0.30.0

data/CHANGELOG_v0.31.0.md

@@ -0,0 +1,125 @@
+# Changelog - v0.31.0
+
+## 🚀 New Features
+
+### Experimental Native Scanner Implementation
+
+Added high-performance directory scanning with Rust/Go implementations. By default, uses stable Ruby implementation with optional native implementations available via command-line options.
+
+#### Implementation Languages
+- **Rust implementation** (`lib_rust/scanner/`): Fastest, memory-safe
+- **Go implementation** (`lib_go/scanner/`): Fast, excellent concurrency
+- **Ruby implementation** (default): Stable, no dependencies
+
+#### NativeScanner Abstraction Layer
+- `lib/rufio/native_scanner.rb`: Unified interface independent of implementation
+- Automatic fallback (falls back to Ruby if native implementation unavailable)
+
+#### Launch Options
+```bash
+# Default (Ruby implementation)
+rufio
+
+# Enable native implementation (auto-detect: Rust > Go > Ruby)
+rufio --native
+rufio --native=auto
+
+# Force Rust implementation
+rufio --native=rust
+
+# Force Go implementation
+rufio --native=go
+
+# Environment variable control
+RUFIO_NATIVE=rust rufio
+```
+
+#### Priority
+- **Default**: Ruby (stability focused)
+- **`--native=auto`**: Rust > Go > Ruby
+- **`--native=rust`**: Rust (fallback to Ruby if unavailable)
+- **`--native=go`**: Go (fallback to Ruby if unavailable)
+
+## 🔧 Improvements
+
+### GitHub Actions CI/CD
+- **Build**: Automatically build native libraries on 3 OSes (Linux, macOS, Windows)
+- **Test**: Run tests on all platforms (both Ruby fallback and native implementations)
+- **Release**: Auto-build and publish gem on tag push, attach binaries
+
+### Development Environment
+- `.gitignore`: Ignore build artifacts (`target/`, `*.dylib`, `*.so`, `*.dll`, etc.)
+- gemspec: Configure to include native libraries in gem (optional)
+
+### Command-Line Argument Processing
+- Added `--native` option
+- Improved argument parser (accurate path and option discrimination)
+- Added native scanner description to `--help`
+
+## 📦 Dependencies
+
+### Ruby Dependencies (unchanged)
+- io-console ~> 0.6
+- pastel ~> 0.8
+- tty-cursor ~> 0.7
+- tty-screen ~> 0.8
+- ffi (only when using native scanner)
+
+### Build-time Dependencies (optional)
+- **Rust**: cargo, rustc (to build Rust implementation)
+- **Go**: go 1.21+ (to build Go implementation)
+
+## 🧪 Tests
+
+Added new tests:
+- `test/test_rust_scanner.rb`: Rust scanner tests
+- `test/test_go_scanner.rb`: Go scanner tests
+- `test/test_native_scanner.rb`: NativeScanner abstraction layer tests
+  - Verify default mode is Ruby
+  - Mode switching tests
+  - Auto-detection tests
+  - Fallback behavior tests
+
+All tests passing: 279+ runs, 1299+ assertions, 0 failures, 0 errors
+
+## 📝 Documentation
+
+- README.md: Added launch options documentation
+- Help message: Detailed `--native` option description
+
+## 🔒 Compatibility
+
+- **Backward compatibility**: Fully maintained (default is Ruby implementation)
+- **Native libraries**: Optional (works without them)
+- **Platforms**: Linux, macOS, Windows supported
+
+## 📌 Notes
+
+### Experimental Feature
+Rust/Go implementations are experimental:
+- Not used by default (requires `--native` option)
+- Thorough testing recommended for production use
+- Use default Ruby implementation if issues occur
+
+### Build Instructions
+
+#### Rust Implementation
+```bash
+cd lib_rust/scanner
+cargo build --release
+make install
+```
+
+#### Go Implementation
+```bash
+cd lib_go/scanner
+make install
+```
+
+## 🙏 Acknowledgments
+
+Native Rust/Go implementations enable faster scanning of large directories. We welcome your feedback.
+
+---
+
+Release Date: 2026-01-01

data/README.md

@@ -21,6 +21,9 @@ rufioは、Yaziにインスパイアされたターミナル上で動作する
 - **マルチプラットフォーム**: macOS、Linux、Windowsで動作
 - **外部エディタ連携**: お気に入りのエディタでファイルを開く
 - **ヘルスチェック**: システム依存関係の確認機能
+- **ステータスバー**: 処理時間、現在時刻、バージョン情報をリアルタイム表示
+- **ブックマーク一覧表示**: フッタに1-9のブックマークを番号付きで表示
+- **統合ヘルプシステム**: ？キーでキーバインド一覧とお知らせを表示
 
 ## インストール
 
@@ -43,6 +46,61 @@ rufio           # カレントディレクトリで起動
 rufio /path/to  # 指定したディレクトリで起動
 ```
 
+### ネイティブスキャナー（実験的機能）
+
+rufio v0.31.0以降では、高速なディレクトリスキャンのためのネイティブ実装（Rust/Go）をサポートしています。デフォルトは安定したRuby実装を使用し、オプションでネイティブ実装に切り替え可能です。
+
+#### 起動オプション
+
+```bash
+# デフォルト（Ruby実装 - 安定）
+rufio
+
+# ネイティブ実装を有効化（自動検出: Rust > Go > Ruby）
+rufio --native
+rufio --native=auto
+
+# Rust実装を強制使用
+rufio --native=rust
+rufio --native rust /path/to/dir
+
+# Go実装を強制使用
+rufio --native=go
+rufio --native go /path/to/dir
+
+# 環境変数でも制御可能
+RUFIO_NATIVE=rust rufio
+RUFIO_NATIVE=go rufio /path/to/dir
+```
+
+#### ネイティブ実装について
+
+- **Rust実装**: 最も高速でメモリ安全。推奨。
+- **Go実装**: 高速で並行処理に優れる。
+- **Ruby実装** (デフォルト): 依存なし、安定動作保証。
+
+#### ビルド方法
+
+ネイティブ実装を使用するには、事前にビルドが必要です：
+
+```bash
+# Rust実装のビルド
+cd lib_rust/scanner
+cargo build --release
+make install
+
+# Go実装のビルド
+cd lib_go/scanner
+make install
+```
+
+#### 注意事項
+
+- ネイティブ実装は実験的機能です
+- デフォルトではRuby実装を使用（`--native`オプションなし）
+- ネイティブライブラリがない場合、自動的にRuby実装にフォールバック
+- gemインストール時はネイティブライブラリが含まれます（ビルド不要）
+
 ### ヘルスチェック
 
 ```bash
@@ -113,6 +171,7 @@ rufio --help           # ヘルプメッセージを表示
 | --------- | ------------------------------------ |
 | `b`       | 現在のディレクトリをブックマークに追加 |
 | `p`       | プロジェクトモードに入る             |
+| `0`       | 起動したディレクトリに移動           |
 | `1`-`9`   | 対応する番号のブックマークに移動     |
 
 #### zoxide連携機能
@@ -130,6 +189,12 @@ rufio --help           # ヘルプメッセージを表示
 | `Enter`| コマンドを実行（コマンドモード中）       |
 | `ESC`  | コマンドモードをキャンセル（コマンドモード中） |
 
+#### ヘルプ
+
+| キー | 機能                               |
+| ---- | ---------------------------------- |
+| `?`  | キーバインド一覧とお知らせを表示 |
+
 #### システム操作
 
 | キー | 機能         |

data/bin/rufio

@@ -6,27 +6,98 @@ require_relative '../lib/rufio'
 # プラグインを読み込む
 Rufio::PluginManager.load_all
 
-# コマンドライン引数の処理
+# コマンドライン引数のパース
+native_mode = nil
+start_directory = nil
+skip_next = false
+
+ARGV.each_with_index do |arg, idx|
+  if skip_next
+    skip_next = false
+    next
+  end
+
+  case arg
+  when '--native'
+    # 次の引数がモード指定かチェック
+    if idx + 1 < ARGV.length && !ARGV[idx + 1].start_with?('--') && !ARGV[idx + 1].start_with?('/')
+      next_arg = ARGV[idx + 1]
+      if %w[rust go auto ruby].include?(next_arg)
+        native_mode = next_arg
+        skip_next = true
+      else
+        native_mode = 'auto'
+      end
+    else
+      native_mode = 'auto'
+    end
+  when /^--native=(rust|go|auto|ruby)$/
+    native_mode = $1
+  when '-c', '--check-health', '--help', '-h'
+    # これらは後で処理
+  when /^--/
+    # 未知のオプションは無視
+  else
+    # 最初の非オプション引数をディレクトリとして扱う
+    start_directory ||= arg
+  end
+end
+
+# ネイティブスキャナーモードを設定（native_scannerが存在する場合のみ）
+if native_mode && defined?(Rufio::NativeScanner)
+  Rufio::NativeScanner.mode = native_mode
+end
+
+# 環境変数でも制御可能
+if ENV['RUFIO_NATIVE'] && defined?(Rufio::NativeScanner)
+  Rufio::NativeScanner.mode = ENV['RUFIO_NATIVE']
+end
+
+# コマンド処理
 if ARGV.include?('--check-health') || ARGV.include?('-c')
   # ヘルスチェック実行
   health_checker = Rufio::HealthChecker.new
   success = health_checker.run_check
   exit(success ? 0 : 1)
-elsif ARGV.include?('--help')
+elsif ARGV.include?('--help') || ARGV.include?('-h')
   puts "rufio - Terminal-based file manager"
   puts ""
   puts "Usage:"
-  puts "  rufio [DIRECTORY]     Start rufio in specified directory"
-  puts "  rufio -c, --check-health  Check system dependencies"
-  puts "  rufio --help          Show this help message"
+  puts "  rufio [OPTIONS] [DIRECTORY]"
+  puts ""
+  puts "Options:"
+  puts "  -c, --check-health        Check system dependencies"
+  puts "  -h, --help                Show this help message"
+  if defined?(Rufio::NativeScanner)
+    puts "  --native[=MODE]           Enable native scanner (experimental)"
+    puts "                            MODE: auto|rust|go (default: auto)"
+    puts ""
+    puts "Native Scanner:"
+    puts "  By default, rufio uses Ruby implementation for stability."
+    puts "  Native scanners (Rust/Go) are experimental and can be enabled with --native."
+    puts ""
+    puts "  --native                  Auto-detect (Rust > Go > Ruby)"
+    puts "  --native=rust             Use Rust implementation"
+    puts "  --native=go               Use Go implementation"
+    puts "  --native=auto             Same as --native"
+    puts "  --native=ruby             Use Ruby implementation (default)"
+    puts ""
+    puts "  Environment variable: RUFIO_NATIVE=rust|go|auto"
+  end
   puts ""
   puts "Examples:"
-  puts "  rufio                 # Start in current directory"
-  puts "  rufio /path/to/dir    # Start in specific directory"
-  puts "  rufio -c              # Check if all dependencies are available"
+  puts "  rufio                     # Start in current directory"
+  puts "  rufio /path/to/dir        # Start in specific directory"
+  if defined?(Rufio::NativeScanner)
+    puts "  rufio --native            # Use native scanner (auto-detect)"
+    puts "  rufio --native=rust       # Use Rust scanner"
+    puts "  rufio --native rust /tmp  # Use Rust scanner in /tmp"
+    puts "  RUFIO_NATIVE=rust rufio   # Use Rust via environment variable"
+  end
+  puts "  rufio -c                  # Check dependencies"
   exit(0)
 else
-  start_directory = ARGV[0] || Dir.pwd
+  start_directory ||= Dir.pwd
 
   # アプリケーション開始
   app = Rufio::Application.new(start_directory)

data/info/help.md

@@ -0,0 +1,111 @@
+# rufio Help
+
+**rufio** is a terminal-based file manager inspired by Yazi.
+
+## Table of Contents
+
+- [Basic Operations](#basic-operations)
+- [Navigation](#navigation)
+- [File Operations](#file-operations)
+- [File Selection & Bulk Operations](#file-selection--bulk-operations)
+- [Filtering & Search](#filtering--search)
+- [Bookmarks](#bookmarks)
+- [Other Features](#other-features)
+
+---
+
+## Basic Operations
+
+### Navigation
+
+| Key | Action |
+|-----|--------|
+| `j` or `↓` | Move down one item |
+| `k` or `↑` | Move up one item |
+| `h` or `←` | Go to parent directory |
+| `l`, `Enter`, or `→` | Enter directory / Select file |
+| `g` | Jump to top of list |
+| `G` | Jump to bottom of list |
+
+### File Operations
+
+| Key | Action |
+|-----|--------|
+| `o` | Open file with external editor |
+| `e` | Open in file explorer |
+| `R` | Refresh directory contents |
+| `r` | Rename file or directory |
+| `d` | Delete file or directory (with confirmation) |
+| `a` | Create new file |
+| `A` | Create new directory |
+
+### File Selection & Bulk Operations
+
+| Key | Action |
+|-----|--------|
+| `Space` | Toggle file/directory selection |
+| `m` | Move selected items to current directory |
+| `c` | Copy selected items to current directory |
+| `x` | Delete selected items |
+
+### Filtering & Search
+
+| Key | Action |
+|-----|--------|
+| `f` | Start filter mode |
+| `s` | Search file names with fzf |
+| `F` | Search file contents with rga (ripgrep-all) |
+
+**Filter Mode:**
+- Type characters to filter files in real-time
+- Press `Enter` to apply filter and exit filter mode
+- Press `ESC` to cancel and clear filter
+
+### Bookmarks
+
+| Key | Action |
+|-----|--------|
+| `b` | Add current directory to bookmarks |
+| `0` | Jump to startup directory |
+| `1-9` | Jump to bookmark 1-9 |
+| `p` | Enter project mode (browse bookmarks) |
+
+**Project Mode:**
+- Browse all bookmarks with normal navigation keys
+- Press `Space` to select a bookmark and jump to it
+- Press `ESC` to exit project mode
+
+### Other Features
+
+| Key | Action |
+|-----|--------|
+| `z` | Navigate using zoxide history |
+| `:` | Enter command mode |
+| `?` | Enter help mode (this mode) |
+| `ESC` | Exit help mode / Cancel filter |
+| `q` | Quit rufio |
+
+---
+
+## Help Mode
+
+You are currently in **Help Mode**. In this mode:
+
+- Navigate through help files using normal keys (`j/k/h/l`)
+- Press `l` or `Enter` to view a help file
+- Press `h` to go back (restricted to `info/` directory)
+- Press `ESC` to exit help mode and return to your previous directory
+
+---
+
+## Tips
+
+1. **Quick navigation**: Use `g` and `G` to jump to top/bottom
+2. **Bulk operations**: Select multiple files with `Space`, then use `m/c/x`
+3. **Filter + Search**: Use `f` for real-time filtering, `s` for fuzzy search
+4. **Bookmarks**: Save frequently used directories with `b`, access with `1-9`
+5. **Project mode**: Press `p` to see all bookmarks at once
+
+---
+
+For more information, visit: https://github.com/masisz/rufio

data/info/keybindings.md

@@ -0,0 +1,102 @@
+# Keybindings Reference
+
+Complete reference of all keyboard shortcuts in **rufio**.
+
+## Navigation
+
+| Key | Action |
+|-----|--------|
+| `j` / `↓` | Move down |
+| `k` / `↑` | Move up |
+| `h` / `←` | Go to parent directory |
+| `l` / `→` / `Enter` | Enter directory or select file |
+| `g` | Jump to top of list |
+| `G` | Jump to bottom of list |
+
+## File Operations
+
+| Key | Action |
+|-----|--------|
+| `o` | Open file with external editor |
+| `e` | Open in file explorer (system default) |
+| `R` | Refresh directory contents |
+| `r` | Rename file or directory |
+| `d` | Delete file or directory (with confirmation) |
+| `a` | Create new file |
+| `A` | Create new directory |
+
+## File Selection
+
+| Key | Action |
+|-----|--------|
+| `Space` | Toggle selection on current item |
+| `m` | Move selected items to current directory |
+| `c` | Copy selected items to current directory |
+| `x` | Delete selected items |
+
+## Filtering & Search
+
+| Key | Action |
+|-----|--------|
+| `f` | Enter filter mode (type to filter) |
+| `s` | Search file names with fzf |
+| `F` | Search file contents with rga |
+
+## Bookmarks
+
+| Key | Action |
+|-----|--------|
+| `b` | Add current directory to bookmarks |
+| `0` | Jump to startup directory |
+| `1` | Jump to bookmark 1 |
+| `2` | Jump to bookmark 2 |
+| `3` | Jump to bookmark 3 |
+| `4` | Jump to bookmark 4 |
+| `5` | Jump to bookmark 5 |
+| `6` | Jump to bookmark 6 |
+| `7` | Jump to bookmark 7 |
+| `8` | Jump to bookmark 8 |
+| `9` | Jump to bookmark 9 |
+| `p` | Enter project mode (browse all bookmarks) |
+
+## Other
+
+| Key | Action |
+|-----|--------|
+| `z` | Navigate using zoxide history |
+| `:` | Enter command mode |
+| `?` | Enter help mode |
+| `ESC` | Exit current mode (help/filter/project) |
+| `q` | Quit rufio |
+
+---
+
+## Mode-Specific Keys
+
+### Filter Mode
+- **Any character**: Add to filter query
+- **Backspace**: Remove last character
+- **Enter**: Apply filter and exit filter mode
+- **ESC**: Cancel filter and exit filter mode
+
+### Project Mode
+- **j/k**: Navigate through bookmarks
+- **Space**: Select bookmark and jump to directory
+- **ESC**: Exit project mode
+
+### Help Mode
+- **j/k/h/l**: Navigate help files
+- **ESC**: Exit help mode and return to previous directory
+
+---
+
+## Tips
+
+- **Vim users**: Navigation keys (`hjkl`) work exactly like Vim
+- **Selection**: Use `Space` to mark multiple files, then operate on all at once
+- **Quick access**: Number keys `1-9` provide instant access to bookmarks
+- **Filtering**: Press `f` and start typing for real-time filtering
+
+---
+
+*Press `?` anytime to return to help mode*