rufio 0.20.0 → 0.30.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 0b83ee6642477115c1a4590c5e0dd5194277eb5cc893e66fa8f59467a8768bec
-  data.tar.gz: 674b4c809669a17fcfc94a068e13a1524977cda466b610a75cd94f85995cbfbb
+  metadata.gz: 8f639904d46c7c6cff1424a06e22df2ec476aab1e575a442a47a329af208c555
+  data.tar.gz: 4f682afe7f35715ae18b4fcdc08efef03d00677c621d0422567a23d897b6b30b
 SHA512:
-  metadata.gz: 8e72520a40a2315b963d1c9a04f0071f35732696bbbf56d83a8d990025fb334fb6c834ec73bbe97b18fe27122c878771fc9710c33eda3293aa0dd0478946cd1e
-  data.tar.gz: 26089800c3bb70e4b63d698ffdb8c87c5f4827229769bddef6e18c76cfa78984e9dbbacdf7bf14de2c201396c390b714b89ec74a170fda157ea5a7297c7b0293
+  metadata.gz: 8f6ee453b1868123c11d987244735ce092088f7b720dc6f445e21aed0b191e25b47501ff003720647dc17343accdefd88a72b0dfaf69ca644a160e693ec1a1cf
+  data.tar.gz: d1ddf57189b941111a314f11c5b6dbcddbda54d96e6fef4eccb8b7a7fec27a9903ca6b29d66e62181a2d98fe5009026ca2609620cef370eba680851cb710ec31

data/CHANGELOG_v0.21.0.md

@@ -0,0 +1,175 @@
+# Changelog v0.21.0 - Copy Feature & Code Refactoring
+
+## [0.21.0] - 2025-12-28
+
+### 🎨 Enhanced - File Operations & Code Quality
+
+Complete implementation of copy functionality with floating dialog UI, cross-directory selection improvements, and major code refactoring for better maintainability.
+
+### Added
+
+#### Copy Feature
+- **`c` key**: Copy selected files to current directory
+  - Uses floating confirmation dialog (green border)
+  - Shows source and destination paths
+  - Supports cross-directory operations
+  - Silent completion (no result dialog)
+- **`SelectionManager#source_directory`**: Track directory where files were selected
+  - Enables selecting files in one directory and copying/moving to another
+  - Automatically set on first selection
+  - Cleared when all selections are removed
+- **Copy confirmation dialog**: Green-bordered floating window
+  - Displays source and destination paths with smart truncation
+  - Consistent with move/delete confirmation UI
+  - `[Y]es` / `[N]o` / `ESC` to cancel
+
+#### Multiple Selection Delete
+- **Enhanced `x` key**: Delete multiple selected files
+  - Checks for selected items first
+  - Falls back to single file deletion if no selection
+  - Uses floating confirmation dialog showing source path
+  - Red border for warning (dangerous operation)
+
+#### UI Improvements
+- **Cross-directory selection display**: Selection marks only show in source directory
+  - `is_selected?` method checks current directory matches source directory
+  - Prevents confusion when navigating to different directories
+  - Selection internally maintained for operations
+
+### Changed
+
+#### File Operations
+- **Move operation** (`m` key): Uses source directory from SelectionManager
+  - Select files → navigate to destination → press `m` to move
+  - Blue-bordered confirmation dialog with paths
+  - Silent completion
+- **Delete operation** (`x` key):
+  - Multiple selection support added
+  - Shows source path in confirmation
+  - Red-bordered warning dialog
+- **All file operations** now use consistent floating dialog pattern:
+  - Red: Delete (dangerous)
+  - Blue: Move (informational)
+  - Green: Copy (safe)
+
+#### Code Quality
+- **terminal_ui.rb refactored**: Reduced from 1139 to 1048 lines (-91 lines)
+  - Removed duplicate text utility methods
+  - Uses `TextUtils` module for all text operations
+  - Better separation of concerns
+- **TextUtils module enhanced**: Added `wrap_preview_lines` method
+  - Centralized text display width calculation
+  - Multi-byte character support (Japanese, etc.)
+  - Consistent truncation and wrapping logic
+- **Method call updates**: All `display_width`, `truncate_to_width` calls use `TextUtils.` prefix
+  - Proper module method invocation
+  - Fixed runtime errors from refactoring
+
+#### Keybind Handler
+- **Removed duplicate method definition**: `show_delete_confirmation`
+  - Fixed warning about method redefinition
+  - Single source of truth for delete confirmation
+- **Unified confirmation methods**:
+  - `show_move_confirmation(count, source_path, dest_path)`
+  - `show_copy_confirmation(count, source_path, dest_path)`
+  - `show_delete_confirmation(count, source_path)`
+
+### Technical Changes
+
+#### SelectionManager Enhancement
+- **`@source_directory` tracking**: Remember where files were selected
+- **`toggle_selection` updated**: Accepts `current_directory` parameter
+  - Sets source directory on first selection
+  - Maintains source directory for subsequent selections
+  - Clears source when all items deselected
+- **Cross-directory operation support**:
+  - Select in `/path/A`
+  - Navigate to `/path/B`
+  - Execute move/copy/delete from original location
+
+#### TextUtils Module
+- **New method**: `wrap_preview_lines(lines, max_width)`
+  - Intelligent line wrapping for preview pane
+  - Preserves empty lines
+  - Character-by-character width calculation
+- **Improved display width calculation**: Handles full-width and half-width characters
+- **Smart truncation**: Adds ellipsis when space permits
+
+#### KeybindHandler Updates
+- **`move_selected_to_current`**: Uses `@selection_manager.source_directory`
+- **`copy_selected_to_current`**: New method following same pattern as move
+- **`delete_current_file_with_confirmation`**: Checks for selected items first
+- **`is_selected?(entry_name)`**: Validates current directory matches source
+- **Path display helper**: `shorten_path(path, max_length)` for dialog display
+
+### Bug Fixes
+
+- **Fixed undefined method error**: `display_width` in terminal_ui.rb
+  - Changed to `TextUtils.display_width`
+  - Fixed all text utility method calls
+- **Fixed method redefinition warning**: Removed duplicate `show_delete_confirmation`
+- **Fixed cross-directory selection display**: Selection marks only show in source directory
+  - Prevents showing same filename selected in different directories
+  - Internal selection state maintained correctly
+
+### Documentation
+
+- **README.md updated**: Added copy operation documentation
+  - Updated File Operations table with Copy row
+  - Updated Operation Workflow with `c` key
+  - Added copy to File Operations section
+- **README_EN.md updated**: Same updates for English documentation
+
+### Key Bindings Summary
+
+#### File Selection & Operations
+- `SPACE`: Select/deselect files and directories
+- `m`: Move selected items to current directory (blue dialog)
+- `c`: Copy selected items to current directory (green dialog)
+- `x`: Delete selected items (red dialog)
+
+#### Operation Workflow
+```
+1. SPACE → Select files/directories (multiple selection possible)
+2. Choose operation key:
+   - m → Move to current directory
+   - c → Copy to current directory
+   - x → Delete
+3. Floating Dialog → Confirm with Y/N, ESC to cancel
+```
+
+#### Cross-Directory Operations
+```
+1. Navigate to source directory
+2. SPACE → Select files
+3. Navigate to destination directory (selection marks hidden)
+4. m/c → Move or copy from source to current
+   OR navigate back to source
+5. x → Delete selected files
+```
+
+### UI Color Scheme
+
+- **Copy dialog**: Green border (`\e[32m`) - safe operation
+- **Move dialog**: Blue border (`\e[34m`) - informational
+- **Delete dialog**: Red border (`\e[31m`) - warning/danger
+- **Selection mark**: `✓` with green background (`\e[42m\e[30m`)
+- **Selection visibility**: Only in source directory
+
+### Code Metrics
+
+- **Lines of code reduction**: terminal_ui.rb: 1139 → 1048 lines (-8%)
+- **Test coverage**: 309 runs, 1407 assertions, 0 failures
+- **Warnings fixed**: Method redefinition warning eliminated
+- **Module organization**: Better separation with TextUtils module
+
+### Migration Notes
+
+- **No breaking changes**: All existing functionality preserved
+- **New feature**: `c` key for copy operation
+- **Behavior improvement**: Selection display now directory-aware
+- **Code quality**: Internal refactoring with no user-facing changes
+
+---
+
+**Full Changelog**: [v0.20.0...v0.21.0](https://github.com/masisz/rufio/compare/v0.20.0...v0.21.0)

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/README.md

@@ -16,12 +16,14 @@ rufioは、Yaziにインスパイアされたターミナル上で動作する
 - **コマンドモード**: Tab補完とフローティングウィンドウを備えた強力なコマンドシステム
 - **ファイルプレビュー**: テキストファイルの内容をその場で確認
 - **ファイル選択・操作**: 複数ファイルの選択、移動、コピー、削除が可能
-- **ベースディレクトリ操作**: 起動ディレクトリへの一括ファイル移動・コピー
 - **リアルタイムフィルター**: sキーでファイル名の絞り込み表示
 - **高度な検索機能**: fzfとrgaを使った強力な検索
 - **マルチプラットフォーム**: macOS、Linux、Windowsで動作
 - **外部エディタ連携**: お気に入りのエディタでファイルを開く
 - **ヘルスチェック**: システム依存関係の確認機能
+- **ステータスバー**: 処理時間、現在時刻、バージョン情報をリアルタイム表示
+- **ブックマーク一覧表示**: フッタに1-9のブックマークを番号付きで表示
+- **統合ヘルプシステム**: ？キーでキーバインド一覧とお知らせを表示
 
 ## インストール
 
@@ -87,8 +89,8 @@ rufio --help           # ヘルプメッセージを表示
 | キー    | 機能                                                 |
 | ------- | ---------------------------------------------------- |
 | `Space` | ファイル・ディレクトリを選択・選択解除（複数選択可） |
-| `m`     | 選択したアイテムをベースディレクトリに移動           |
-| `p`     | 選択したアイテムをベースディレクトリにコピー         |
+| `m`     | 選択したアイテムをカレントディレクトリに移動         |
+| `c`     | 選択したアイテムをカレントディレクトリにコピー       |
 | `x`     | 選択したアイテムを削除                               |
 
 #### リアルタイムフィルター機能
@@ -114,6 +116,7 @@ rufio --help           # ヘルプメッセージを表示
 | --------- | ------------------------------------ |
 | `b`       | 現在のディレクトリをブックマークに追加 |
 | `p`       | プロジェクトモードに入る             |
+| `0`       | 起動したディレクトリに移動           |
 | `1`-`9`   | 対応する番号のブックマークに移動     |
 
 #### zoxide連携機能
@@ -131,6 +134,12 @@ rufio --help           # ヘルプメッセージを表示
 | `Enter`| コマンドを実行（コマンドモード中）       |
 | `ESC`  | コマンドモードをキャンセル（コマンドモード中） |
 
+#### ヘルプ
+
+| キー | 機能                               |
+| ---- | ---------------------------------- |
+| `?`  | キーバインド一覧とお知らせを表示 |
+
 #### システム操作
 
 | キー | 機能         |
@@ -144,17 +153,14 @@ rufio --help           # ヘルプメッセージを表示
 - **選択・選択解除**: `Space`キーでファイルやディレクトリを選択・選択解除
 - **複数選択**: 複数のファイルやディレクトリを同時に選択可能
 - **視覚的表示**: 選択されたアイテムは✓マークと緑色の背景で表示
-- **選択状態の表示**: 画面上部2行目に選択中のアイテム数が表示
-
-#### ベースディレクトリ操作
 
-rufio起動時のディレクトリが**ベースディレクトリ**として設定され、選択したファイルの移動・コピー先となります。
+#### ファイル操作
 
-| 操作     | キー | 機能                                     |
-| -------- | ---- | ---------------------------------------- |
-| **移動** | `m`  | 選択したアイテムをベースディレクトリに移動 |
-| **コピー** | `p`  | 選択したアイテムをベースディレクトリにコピー |
-| **削除** | `x`  | 選択したアイテムを削除                   |
+| 操作       | キー | 機能                                     |
+| ---------- | ---- | ---------------------------------------- |
+| **移動**   | `m`  | 選択したアイテムをカレントディレクトリに移動 |
+| **コピー** | `c`  | 選択したアイテムをカレントディレクトリにコピー |
+| **削除**   | `x`  | 選択したアイテムを削除                   |
 
 #### 削除操作の詳細
 
@@ -171,11 +177,11 @@ rufio起動時のディレクトリが**ベースディレクトリ**として
 ```
 1. Space → ファイル・ディレクトリを選択（複数選択可）
 2. 操作キーを選択:
-   - m → ベースディレクトリに移動
-   - p → ベースディレクトリにコピー
+   - m → カレントディレクトリに移動
+   - c → カレントディレクトリにコピー
    - x → 削除
 3. フローティングダイアログ → Y/Nで確認、ESCでキャンセル
-4. 結果表示 → フローティングウィンドウで操作結果を確認
+4. 操作完了 → 選択解除、画面更新
 ```
 
 #### 安全機能

data/README_EN.md

@@ -14,8 +14,7 @@ rufio is a terminal-based file manager inspired by Yazi. It's implemented in Rub
 - **Intuitive Operation**: Vim-like key bindings
 - **Plugin System**: Extensible plugin architecture
 - **File Preview**: View text file contents on the fly
-- **File Selection & Operations**: Select multiple files, move, copy, and delete
-- **Base Directory Operations**: Batch file operations to startup directory
+- **File Selection & Operations**: Select multiple files, move, and delete
 - **Real-time Filter**: Filter files by name using s key
 - **Advanced Search**: Powerful search using fzf and rga
 - **Multi-platform**: Runs on macOS, Linux, and Windows
@@ -85,8 +84,8 @@ rufio --help           # Show help message
 | Key     | Function                                    |
 | ------- | ------------------------------------------- |
 | `Space` | Select/deselect files and directories      |
-| `m`     | Move selected items to base directory      |
-| `p`     | Copy selected items to base directory      |
+| `m`     | Move selected items to current directory   |
+| `c`     | Copy selected items to current directory   |
 | `x`     | Delete selected items                       |
 
 #### Real-time Filter
@@ -132,16 +131,13 @@ rufio --help           # Show help message
 - **Select/Deselect**: Use `Space` key to select or deselect files and directories
 - **Multiple Selection**: Select multiple files and directories simultaneously
 - **Visual Display**: Selected items are marked with ✓ and highlighted in green
-- **Selection Counter**: The number of selected items is shown on the second line of the screen
 
-#### Base Directory Operations
-
-The directory where rufio starts becomes the **base directory**, which serves as the destination for move and copy operations.
+#### File Operations
 
 | Operation | Key | Function                                |
 | --------- | --- | --------------------------------------- |
-| **Move**  | `m` | Move selected items to base directory  |
-| **Copy**  | `p` | Copy selected items to base directory  |
+| **Move**  | `m` | Move selected items to current directory |
+| **Copy**  | `c` | Copy selected items to current directory |
 | **Delete** | `x` | Delete selected items                   |
 
 #### Delete Operation Details
@@ -159,8 +155,8 @@ The directory where rufio starts becomes the **base directory**, which serves as
 ```
 1. Space → Select files/directories (multiple selection possible)
 2. Choose operation key:
-   - m → Move to base directory
-   - p → Copy to base directory
+   - m → Move to current directory
+   - c → Copy to current directory
    - x → Delete
 3. Floating Dialog → Confirm with Y/N, ESC to cancel
 4. Result Display → Review operation results in floating window

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*