beniya 0.5.0 → 0.6.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 33133a54577671b4c46cb252c7cfc37361b6ec3023ce172b719d8013cbb376a8
-  data.tar.gz: 474519fcc81a04375103ef96a8c356f7ba00057e42c13b4779ec3dc78c462662
+  metadata.gz: 8e920583f6645634b10889369089e81e114db44a01be5b0baa177dc8279ca1bc
+  data.tar.gz: 7c3ec6afa823e45700e26fa02c50076cbdc268d136d11403599a6befc858aebf
 SHA512:
-  metadata.gz: a4150553b51268cc0e8e9c73d4c5fc47907859f3c3669a1dbe7981a37ae23a5ad1463bedcbc3f71a11ec3414589055bde7ea6cd85ff4e17127f91bf017f9fe6b
-  data.tar.gz: 6b69ee230c39f508a6eb70d210dfc7b8401e4014bd86b2ba083dd32458d6ff514c292d5c679966da74229640999b9f3d57096ca6bbdaf7e6739289166d595151
+  metadata.gz: bd20c3f4392c8d65aec9bc2e3261701d5f091e6baa73012e779f7417e0d2ea1bc8fe10ea4cac99117b70f82a70b68de0638ec05b390e97436c67691ac11bef90
+  data.tar.gz: b28475770533a0d8989eab47f72bf63a83e15546fa4e11a43027e45885c07b491498c0bd83296fe9e67a4568c3c1774f96b8b6ff9bd98d1ea6f2b9d185d4ea30

data/CHANGELOG.md

@@ -7,7 +7,32 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
-## [0.5.0] - 2025-01-20
+## [0.6.0] - 2025-01-XX
+
+### Added
+- **🚀 zoxide Integration**: Complete zoxide directory history navigation functionality
+- **z Key Navigation**: Press `z` key to display zoxide movement history and navigate to frequently used directories
+- **Smart History Display**: Frequency-based directory sorting with up to 20 history entries
+- **Interactive Selection UI**: Modern floating window for intuitive history selection
+- **Fast Number Key Selection**: Direct directory selection using number keys 1-20
+- **Health Check Enhancement**: zoxide installation status and version checking with `beniya -c`
+- **Multi-platform Installation Support**: Automated installation instructions for macOS and Linux
+- **Graceful Fallback**: Proper handling when zoxide is not installed or history is empty
+
+### Changed
+- **Footer Help Updates**: Added `z:zoxide` to key binding display in both English and Japanese
+- **External Tools Documentation**: Updated README with zoxide installation and usage instructions
+- **Health Check System**: Extended to include zoxide as optional dependency with platform-specific guidance
+- **Error Messaging**: Improved user guidance for zoxide-related issues
+
+### Technical Details
+- New zoxide integration methods in `KeybindHandler` class
+- Extended `HealthChecker` with zoxide version checking
+- Comprehensive test suite for zoxide functionality
+- Safe path escaping using Ruby's Shellwords module
+- **Detailed changelog**: [CHANGELOG_v0.6.0.md](./CHANGELOG_v0.6.0.md)
+
+## [0.5.0] - 2025-09-20
 
 ### Added
 - **🔖 Bookmark System**: Complete bookmark functionality with persistent storage
@@ -32,7 +57,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - Integration with existing terminal UI components
 - **Detailed changelog**: [CHANGELOG_v0.5.0.md](./CHANGELOG_v0.5.0.md)
 
-## [0.4.0] - 2025-01-13
+## [0.4.0] - 2025-09-13
 
 ### Added
 - **Floating Dialog System**: Modern floating confirmation dialogs for delete operations
@@ -65,7 +90,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 For detailed information, see [CHANGELOG_v0.4.0.md](./CHANGELOG_v0.4.0.md)
 
-## [0.3.0] - 2024-XX-XX
+## [0.3.0] - 2025-09-06
 
 ### Added
 - Enhanced file operations and management features
@@ -76,7 +101,7 @@ For detailed information, see [CHANGELOG_v0.4.0.md](./CHANGELOG_v0.4.0.md)
 - Performance improvements
 - Bug fixes and stability enhancements
 
-## [0.2.0] - 2024-XX-XX
+## [0.2.0] - 2025-08-26
 
 ### Added
 - New features and functionality improvements
@@ -86,7 +111,7 @@ For detailed information, see [CHANGELOG_v0.4.0.md](./CHANGELOG_v0.4.0.md)
 - User interface improvements
 - Performance optimizations
 
-## [0.1.0] - 2024-XX-XX
+## [0.1.0] - 2025-08-17
 
 ### Added
 - Initial release of beniya
@@ -99,6 +124,8 @@ For detailed information, see [CHANGELOG_v0.4.0.md](./CHANGELOG_v0.4.0.md)
 
 ## Release Links
 
+- [v0.6.0 Detailed Release Notes](./CHANGELOG_v0.6.0.md) - zoxide Integration and Enhanced Health Checking
+- [v0.5.0 Detailed Release Notes](./CHANGELOG_v0.5.0.md) - Bookmark System Implementation
 - [v0.4.0 Detailed Release Notes](./CHANGELOG_v0.4.0.md) - Comprehensive changelog with technical details
 - [GitHub Releases](https://github.com/masisz/beniya/releases) - Download releases and view release history
 - [Installation Guide](./README.md#installation) - How to install beniya
@@ -121,4 +148,4 @@ When contributing to beniya:
 3. Link to detailed release notes for major versions
 4. Include migration notes for breaking changes
 
-For more information, see [Contributing Guidelines](./README.md#contributing).
+For more information, see [Contributing Guidelines](./README.md#contributing).

data/CHANGELOG_v0.6.0.md

@@ -0,0 +1,182 @@
+# CHANGELOG - beniya v0.6.0
+
+**Release Date**: 2025-09-28
+
+## 🚀 New Features
+
+### zoxide Integration
+
+- **zoxide History Navigation with z Key**: Press `z` key to display zoxide movement history and quickly navigate to previously visited directories
+- **Smart History Display**: Frequently used directories appear at the top of the list
+- **Interactive Selection UI**: Floating window displays up to 20 history entries
+- **Fast Selection with Number Keys**: Select directories directly using number keys 1-20
+- **Abbreviated Path Display**: Home directory displayed as `~` with nicely formatted long paths
+- **Graceful Handling**: Proper handling when zoxide is not installed or history is empty
+
+### Health Check Enhancement
+
+- **zoxide Check Addition**: Check zoxide installation status and version with `beniya -c`
+- **Installation Instructions**: Detailed platform-specific (macOS/Linux) installation instructions
+
+## 🎨 UI/UX Improvements
+
+### User Interface
+
+- **Footer Help Updates**:
+  - English version: Added `z:zoxide` to key binding list
+  - Japanese version: Added `z:zoxide` to key binding list
+- **zoxide History Selection Dialog**: Intuitive floating window for history selection
+- **Improved Error Messages**: Clear guidance when zoxide is not installed
+
+## 📖 Documentation Updates
+
+### README Updates
+
+**Japanese Version (README.md)**:
+
+- New zoxide integration features section
+- Added `z:zoxide` to key bindings list
+- Detailed explanation of zoxide overview and installation methods
+- Added zoxide to required external tools list
+- Clarified purpose of each tool
+
+**English Version (README_EN.md)**:
+
+- New zoxide Integration Features section
+- Added `z:zoxide integration` to Key Bindings
+- Detailed zoxide explanation and installation instructions
+- Expanded Required External Tools section
+- Clarified Tool Usage
+
+### Added Documentation Content
+
+- **Detailed explanation of zoxide history navigation features**
+- **Usage examples and workflows**
+- **Overview of zoxide**
+- **Platform-specific installation methods**
+- **Requirements and limitations**
+
+## 🔧 Technical Improvements
+
+### Architecture
+
+- **KeybindHandler Class Extension**: Added zoxide-related methods
+  - `zoxide_available?`: Check zoxide availability
+  - `get_zoxide_history`: Get and parse zoxide history
+  - `show_zoxide_menu`: Display history in floating window
+  - `select_from_zoxide_history`: Interactive history selection
+  - `navigate_to_zoxide_directory`: Navigate to selected directory
+
+### HealthChecker Class Extension
+
+- **check_zoxide Method**: Version checking and status verification for zoxide
+- **install_instruction_for Method Extension**: Added installation instructions for zoxide
+
+### Configuration System
+
+- **Multi-language Message Support**:
+  - `health.zoxide`: Support for both English and Japanese
+  - Updated footer help messages
+
+## 🧪 Testing
+
+### New Tests Added
+
+- **zoxide Integration Tests** (`test/test_zoxide_integration.rb`):
+  - zoxide availability tests
+  - History retrieval functionality tests
+  - UI display tests
+  - Directory navigation tests
+  - Error handling tests
+
+- **Health Check Test Extensions**:
+  - `test_check_zoxide`: zoxide check functionality tests
+  - `test_install_instruction_for_zoxide`: Installation instruction tests
+
+## 📦 Dependencies
+
+### New Dependencies
+
+- **zoxide**: Directory history functionality (optional)
+  - macOS: `brew install zoxide`
+  - Ubuntu/Debian: `apt install zoxide`
+  - Others: [Official Documentation](https://github.com/ajeetdsouza/zoxide#installation)
+
+### Dependency Updates
+
+- **Shellwords Module**: Used for path escaping (Ruby standard library)
+
+## 🔄 Compatibility
+
+### Backward Compatibility
+
+- **No Impact on Existing Features**: No changes to existing key bindings or functionality
+- **Configuration File Compatibility**: Existing configuration files can be used as-is
+- **Optional Feature**: All existing features work normally even without zoxide
+
+### Platform Support
+
+- **macOS**: Full support (installation via Homebrew recommended)
+- **Linux**: Full support (via package managers)
+- **Windows**: Basic compatibility (zoxide installation methods need separate verification)
+
+## ⚡ Performance
+
+### Optimizations
+
+- **Efficient History Retrieval**: Optimal use of zoxide query commands
+- **Memory Usage**: History display limited to maximum 20 entries
+- **Responsiveness**: Fast floating window rendering
+
+## 🐛 Bug Fixes
+
+### Fixed Issues
+
+- **zoxide Output Format Support**: Correctly retrieve scored output with `zoxide query --list --score`
+- **Empty History Handling**: Proper message display when no history exists
+- **Path Escaping**: Safe handling of paths with special characters
+
+## 🔮 Future Plans
+
+### Planned for Next Version
+
+- **zoxide Integration Update History Recording**: Automatically record directory movements within beniya to zoxide
+- **Customizable History Display Count**: Adjust display count via configuration file
+- **History Filtering**: Filter history by specific patterns
+
+## 📝 Usage Examples
+
+### Basic Usage
+
+```bash
+# Launch beniya
+beniya
+
+# Press z key to display zoxide history
+# Enter displayed number (1-20) to navigate to directory
+# Press ESC to cancel
+```
+
+### Health Check
+
+```bash
+# Check all dependencies including zoxide
+beniya -c
+
+# Example output:
+# ✓ zoxide (directory history) zoxide 0.9.8
+```
+
+## 🙏 Acknowledgments
+
+Main contributions in this version:
+
+- **zoxide**: [ajeetdsouza/zoxide](https://github.com/ajeetdsouza/zoxide) - Excellent directory navigation tool
+- **Ruby Standard Library**: Utilization of Shellwords module
+
+---
+
+**Note**: This version is the initial implementation of zoxide integration features. We welcome feedback and improvement suggestions.
+
+**GitHub Issues**: [https://github.com/masisz/beniya/issues](https://github.com/masisz/beniya/issues)
+

data/README.md

@@ -91,7 +91,7 @@ beniya --help           # ヘルプメッセージを表示
 
 | キー        | 機能                                       |
 | ----------- | ------------------------------------------ |
-| `s`         | フィルターモード開始・再編集               |
+| `f`         | フィルターモード開始・再編集               |
 | 文字入力    | ファイル名で絞り込み（フィルターモード中） |
 | `Enter`     | フィルター維持で通常モードに戻る           |
 | `ESC`       | フィルターをクリアして通常モードに戻る     |
@@ -101,7 +101,7 @@ beniya --help           # ヘルプメッセージを表示
 
 | キー | 機能                                      |
 | ---- | ----------------------------------------- |
-| `f`  | fzfによるファイル名検索（プレビュー付き） |
+| `s`  | fzfによるファイル名検索（プレビュー付き） |
 | `F`  | rgaによるファイル内容検索                 |
 
 #### ブックマーク機能
@@ -111,6 +111,12 @@ beniya --help           # ヘルプメッセージを表示
 | `b`       | ブックマークメニューを表示   |
 | `1`-`9`   | 対応する番号のブックマークに移動 |
 
+#### zoxide連携機能
+
+| キー | 機能                               |
+| ---- | ---------------------------------- |
+| `z`  | zoxide履歴からディレクトリを選択移動 |
+
 #### システム操作
 
 | キー | 機能         |
@@ -169,30 +175,30 @@ beniya起動時のディレクトリが**ベースディレクトリ**として
 
 ### フィルター機能の詳細
 
-#### リアルタイムフィルター (`s`)
+#### リアルタイムフィルター (`f`)
 
-- **フィルター開始**: `s`キーを押してフィルターモードに入る
+- **フィルター開始**: `f`キーを押してフィルターモードに入る
 - **文字入力による絞り込み**: 日本語・英数字・記号に対応
 - **リアルタイム更新**: 文字を入力するたびに表示が更新される
 - **フィルター維持**: `Enter`キーでフィルターを保持したまま通常操作に戻る
 - **フィルタークリア**: `ESC`キーでフィルターをクリアして通常表示に戻る
-- **再編集**: フィルター適用中に`s`キーで再編集モード
+- **再編集**: フィルター適用中に`f`キーで再編集モード
 - **文字削除**: `Backspace`で文字削除、全削除時は自動でフィルタークリア
 
 #### 使用例
 
 ```
-1. s → フィルターモード開始
+1. f → フィルターモード開始
 2. ".rb" → Rubyファイルのみ表示
 3. Enter → フィルター維持で通常操作
 4. j/k → フィルター結果内をナビゲーション
-5. s → フィルター再編集
+5. f → フィルター再編集
 6. ESC → フィルタークリア
 ```
 
 ### 検索機能の詳細
 
-#### ファイル名検索 (`f`)
+#### ファイル名検索 (`s`)
 
 - `fzf`を使用したインタラクティブなファイル名検索
 - リアルタイムプレビュー表示
@@ -225,22 +231,68 @@ beniya起動時のディレクトリが**ベースディレクトリ**として
 - beniya再起動後もブックマーク情報が保持される
 - JSONファイルを直接編集することも可能
 
+### zoxide連携機能の詳細
+
+#### zoxide履歴移動 (`z`)
+
+- **スマート履歴**: zoxideが記録したディレクトリ移動履歴を表示
+- **フリークエンシー順**: よく使用するディレクトリほど上位に表示
+- **インタラクティブ選択**: フローティングウィンドウで履歴を選択
+- **高速ナビゲーション**: 数字キーで直接ディレクトリを選択
+- **パス省略表示**: ホームディレクトリを`~`で表示し見やすく
+
+#### 使用例
+
+```
+1. z → zoxide履歴メニューを表示
+2. 1-20 → 表示された番号でディレクトリを選択
+3. ESC → キャンセルして元の画面に戻る
+```
+
+#### zoxideについて
+
+[zoxide](https://github.com/ajeetdsouza/zoxide)は、ディレクトリ移動履歴を学習するスマートなcdコマンドです。
+
+```bash
+# zoxideのインストール
+# macOS (Homebrew)
+brew install zoxide
+
+# Ubuntu/Debian
+apt install zoxide
+
+# その他のインストール方法は公式ドキュメントを参照
+# https://github.com/ajeetdsouza/zoxide#installation
+```
+
+#### 動作要件
+
+- zoxideがシステムにインストールされている必要があります
+- zoxideが無効な場合は適切なメッセージが表示されます
+- 履歴が空の場合も適切にハンドリングされます
+
 ### 必要な外部ツール
 
-検索機能を使用するには、以下のツールが必要です:
+検索機能・履歴機能を使用するには、以下のツールが必要です:
 
 ```bash
 # macOS (Homebrew)
-brew install fzf rga
+brew install fzf rga zoxide
 
 # Ubuntu/Debian
-apt install fzf
+apt install fzf zoxide
 # rgaは別途インストールが必要: https://github.com/phiresky/ripgrep-all
 
 # その他のLinuxディストリビューション
 # パッケージマネージャーまたは手動インストールが必要
 ```
 
+#### 各ツールの用途
+
+- **fzf**: ファイル名検索機能（`s`キー）
+- **rga**: ファイル内容検索機能（`F`キー）  
+- **zoxide**: ディレクトリ履歴移動機能（`z`キー）
+
 ## 設定
 
 ### 色設定（カスタマイズ）

data/README_EN.md

@@ -105,6 +105,19 @@ beniya --help           # Show help message
 | `f` | File name search with fzf (with preview) |
 | `F` | File content search with rga             |
 
+#### Bookmark Functions
+
+| Key     | Function                        |
+| ------- | ------------------------------- |
+| `b`     | Show bookmark menu              |
+| `1`-`9` | Go to corresponding bookmark    |
+
+#### zoxide Integration
+
+| Key | Function                           |
+| --- | ---------------------------------- |
+| `z` | Select directory from zoxide history |
+
 #### System Operations
 
 | Key | Function    |
@@ -198,22 +211,89 @@ The directory where beniya starts becomes the **base directory**, which serves a
 - Searches PDFs, Word documents, text in images, and more
 - Filter results with fzf and jump to specific lines
 
+### Bookmark Features
+
+#### Bookmark Operations (`b`)
+
+- **Add Bookmark**: `[A]` - Add current directory to bookmarks
+- **List Bookmarks**: `[L]` - Display registered bookmarks
+- **Remove Bookmark**: `[R]` - Remove a bookmark
+- **Number Jump**: `1-9` - Jump directly to corresponding bookmark
+
+#### Quick Navigation (`1`-`9`)
+
+- Jump directly to bookmarks without going through the bookmark menu
+- Supports up to 9 bookmarks
+- Bookmark information is displayed at the top of the screen
+
+#### Bookmark Persistence
+
+- Bookmark information is automatically saved to `~/.config/beniya/bookmarks.json`
+- Bookmark information is preserved after beniya restarts
+- JSON file can be edited directly
+
+### zoxide Integration Features
+
+#### zoxide History Navigation (`z`)
+
+- **Smart History**: Display directory navigation history recorded by zoxide
+- **Frequency Order**: More frequently used directories appear higher in the list
+- **Interactive Selection**: Select from history using floating window
+- **Quick Navigation**: Select directories directly with number keys
+- **Abbreviated Path Display**: Home directory shown as `~` for readability
+
+#### Usage Example
+
+```
+1. z → Display zoxide history menu
+2. 1-20 → Select directory by displayed number
+3. ESC → Cancel and return to original screen
+```
+
+#### About zoxide
+
+[zoxide](https://github.com/ajeetdsouza/zoxide) is a smart cd command that learns your directory navigation habits.
+
+```bash
+# Installing zoxide
+# macOS (Homebrew)
+brew install zoxide
+
+# Ubuntu/Debian
+apt install zoxide
+
+# For other installation methods, see official documentation
+# https://github.com/ajeetdsouza/zoxide#installation
+```
+
+#### Requirements
+
+- zoxide must be installed on the system
+- Appropriate message is displayed when zoxide is not available
+- Empty history is handled gracefully
+
 ### Required External Tools
 
-The following tools are required for search functionality:
+The following tools are required for search and history functionality:
 
 ```bash
 # macOS (Homebrew)
-brew install fzf rga
+brew install fzf rga zoxide
 
 # Ubuntu/Debian
-apt install fzf
+apt install fzf zoxide
 # rga requires separate installation: https://github.com/phiresky/ripgrep-all
 
 # Other Linux distributions
 # Installation via package manager or manual installation required
 ```
 
+#### Tool Usage
+
+- **fzf**: File name search functionality (`f` key)
+- **rga**: File content search functionality (`F` key)
+- **zoxide**: Directory history navigation functionality (`z` key)
+
 ## Configuration
 
 ### Color Configuration (Customization)

data/Rakefile

@@ -0,0 +1,156 @@
+# frozen_string_literal: true
+
+require 'bundler/gem_tasks'
+require 'rake/testtask'
+require_relative 'lib/beniya/version'
+
+# Test task
+Rake::TestTask.new(:test) do |t|
+  t.libs << 'test'
+  t.libs << 'lib'
+  t.test_files = FileList['test/test_*.rb']
+end
+
+# Default task
+task default: :test
+
+# Gem build and push tasks
+namespace :gem do
+  desc 'Build the gem file'
+  task :build do
+    puts "Building beniya v#{Beniya::VERSION}..."
+    
+    # Clean old gem files
+    FileUtils.rm_f(Dir.glob('*.gem'))
+    
+    # Build the gem
+    result = system('gem build beniya.gemspec')
+    
+    if result
+      gem_file = "beniya-#{Beniya::VERSION}.gem"
+      puts "✅ Successfully built #{gem_file}"
+    else
+      puts "❌ Failed to build gem"
+      exit 1
+    end
+  end
+
+  desc 'Push the gem to RubyGems.org'
+  task :push => :build do
+    gem_file = "beniya-#{Beniya::VERSION}.gem"
+    
+    unless File.exist?(gem_file)
+      puts "❌ Gem file not found: #{gem_file}"
+      exit 1
+    end
+    
+    puts "Pushing #{gem_file} to RubyGems.org..."
+    
+    result = system("gem push #{gem_file}")
+    
+    if result
+      puts "✅ Successfully pushed #{gem_file} to RubyGems.org"
+      puts "🎉 beniya v#{Beniya::VERSION} is now available!"
+      puts "📦 Install with: gem install beniya"
+    else
+      puts "❌ Failed to push gem to RubyGems.org"
+      exit 1
+    end
+  end
+
+  desc 'Check if current version already exists on RubyGems.org'
+  task :check_version do
+    puts "Checking if version #{Beniya::VERSION} exists on RubyGems.org..."
+    
+    result = system("gem list beniya --remote --exact --all | grep '#{Beniya::VERSION}'", out: File::NULL, err: File::NULL)
+    
+    if result
+      puts "⚠️  Version #{Beniya::VERSION} already exists on RubyGems.org"
+      puts "💡 Please update the version in lib/beniya/version.rb before publishing"
+      exit 1
+    else
+      puts "✅ Version #{Beniya::VERSION} is available for publishing"
+    end
+  end
+
+  desc 'Clean built gem files'
+  task :clean do
+    puts "Cleaning gem files..."
+    removed_files = Dir.glob('*.gem')
+    FileUtils.rm_f(removed_files)
+    
+    if removed_files.any?
+      puts "🗑️  Removed: #{removed_files.join(', ')}"
+    else
+      puts "✨ No gem files to clean"
+    end
+  end
+
+  desc 'Build and publish gem (with version check)'
+  task :publish => [:check_version, :test, :push] do
+    puts "🚀 Gem publishing completed successfully!"
+  end
+end
+
+# Release tasks
+namespace :release do
+  desc 'Tag the current version in git'
+  task :tag do
+    version = "v#{Beniya::VERSION}"
+    
+    puts "Creating git tag #{version}..."
+    
+    # Check if tag already exists
+    if system("git tag -l | grep -q '^#{version}$'", out: File::NULL, err: File::NULL)
+      puts "⚠️  Tag #{version} already exists"
+      exit 1
+    end
+    
+    # Create and push tag
+    system("git tag #{version}")
+    system("git push origin #{version}")
+    
+    puts "✅ Created and pushed tag #{version}"
+  end
+
+  desc 'Prepare release (tag + gem publish)'
+  task :prepare => ['gem:publish', :tag] do
+    puts "🎉 Release v#{Beniya::VERSION} completed!"
+    puts "📋 Don't forget to:"
+    puts "   - Update CHANGELOG.md"
+    puts "   - Create GitHub release from tag"
+    puts "   - Announce the release"
+  end
+end
+
+# Utility tasks
+desc 'Display current version'
+task :version do
+  puts "beniya v#{Beniya::VERSION}"
+end
+
+desc 'Run simple test for basic functionality'
+task :simple_test do
+  puts "Running simple functionality test..."
+  result = system('ruby test/simple_test.rb')
+  
+  if result
+    puts "✅ Simple test passed"
+  else
+    puts "❌ Simple test failed"
+    exit 1
+  end
+end
+
+desc 'Run bookmark tests'
+task :test_bookmark do
+  puts "Running bookmark functionality test..."
+  result = system('ruby test/test_bookmark_simple.rb')
+  
+  if result
+    puts "✅ Bookmark tests passed"
+  else
+    puts "❌ Bookmark tests failed"
+    exit 1
+  end
+end

data/lib/beniya/config.rb

@@ -43,8 +43,8 @@ module Beniya
         'ui.operation_prompt' => 'Operation: ',
 
         # Help text
-        'help.full' => 'j/k:move h:back l:enter o:open g/G:top/bottom r:refresh s:filter f:search F:content a/A:create m/p/x:ops b:bookmark 1-9:goto q:quit',
-        'help.short' => 'j/k:move h:back l:enter o:open s:filter b:bookmark 1-9:goto q:quit',
+        'help.full' => 'j/k:move h:back l:enter o:open g/G:top/bottom r:refresh f:filter s:search F:content a/A:create m/p/x:ops b:bookmark z:zoxide 1-9:goto q:quit',
+        'help.short' => 'j/k:move h:back l:enter o:open f:filter s:search b:bookmark z:zoxide 1-9:goto q:quit',
 
         # Health check messages
         'health.title' => 'beniya Health Check',
@@ -52,6 +52,7 @@ module Beniya
         'health.required_gems' => 'Required gems',
         'health.fzf' => 'fzf (file search)',
         'health.rga' => 'rga (content search)',
+        'health.zoxide' => 'zoxide (directory history)',
         'health.file_opener' => 'System file opener',
         'health.summary' => 'Summary:',
         'health.ok' => 'OK',
@@ -111,8 +112,8 @@ module Beniya
         'ui.operation_prompt' => '操作: ',
 
         # Help text
-        'help.full' => 'j/k:移動 h:戻る l:入る o:開く g/G:先頭/末尾 r:更新 s:絞込 f:検索 F:内容 a/A:作成 m/p/x:操作 b:ブックマーク 1-9:移動 q:終了',
-        'help.short' => 'j/k:移動 h:戻る l:入る o:開く s:絞込 b:ブックマーク 1-9:移動 q:終了',
+        'help.full' => 'j/k:移動 h:戻る l:入る o:開く g/G:先頭/末尾 r:更新 f:絞込 s:検索 F:内容 a/A:作成 m/p/x:操作 b:ブックマーク z:zoxide 1-9:移動 q:終了',
+        'help.short' => 'j/k:移動 h:戻る l:入る o:開く f:絞込 s:検索 b:ブックマーク z:zoxide 1-9:移動 q:終了',
 
         # Health check messages
         'health.title' => 'beniya ヘルスチェック',
@@ -120,6 +121,7 @@ module Beniya
         'health.required_gems' => '必須 gem',
         'health.fzf' => 'fzf (ファイル検索)',
         'health.rga' => 'rga (内容検索)',
+        'health.zoxide' => 'zoxide (ディレクトリ履歴)',
         'health.file_opener' => 'システムファイルオープナー',
         'health.summary' => 'サマリー:',
         'health.ok' => 'OK',

data/lib/beniya/health_checker.rb

@@ -20,6 +20,7 @@ module Beniya
         { name: ConfigLoader.message('health.required_gems'), method: :check_required_gems },
         { name: ConfigLoader.message('health.fzf'), method: :check_fzf },
         { name: ConfigLoader.message('health.rga'), method: :check_rga },
+        { name: ConfigLoader.message('health.zoxide'), method: :check_zoxide },
         { name: ConfigLoader.message('health.file_opener'), method: :check_file_opener }
       ]
 
@@ -118,6 +119,23 @@ module Beniya
       end
     end
 
+    def check_zoxide
+      if system("which zoxide > /dev/null 2>&1")
+        version = `zoxide --version 2>/dev/null`.strip
+        {
+          status: :ok,
+          message: version,
+          details: nil
+        }
+      else
+        {
+          status: :warning,
+          message: "zoxide #{ConfigLoader.message('health.tool_not_found')}",
+          details: install_instruction_for('zoxide')
+        }
+      end
+    end
+
     def check_file_opener
       case RUBY_PLATFORM
       when /darwin/
@@ -160,6 +178,8 @@ module Beniya
           "#{ConfigLoader.message('health.install_brew')} fzf"
         when 'rga'
           "#{ConfigLoader.message('health.install_brew')} rga"
+        when 'zoxide'
+          "#{ConfigLoader.message('health.install_brew')} zoxide"
         end
       when /linux/
         case tool
@@ -167,6 +187,8 @@ module Beniya
           "#{ConfigLoader.message('health.install_apt')} fzf (Ubuntu/Debian) or check your package manager"
         when 'rga'
           ConfigLoader.message('health.rga_releases')
+        when 'zoxide'
+          "#{ConfigLoader.message('health.install_apt')} zoxide (Ubuntu/Debian) or check your package manager"
         end
       else
         ConfigLoader.message('health.install_guide')

data/lib/beniya/keybind_handler.rb

@@ -1,6 +1,8 @@
 # frozen_string_literal: true
 
+require 'shellwords'
 require_relative 'bookmark'
+require_relative 'file_opener'
 
 module Beniya
   class KeybindHandler
@@ -66,7 +68,7 @@ module Beniya
         open_current_file
       when 'e'  # e - open directory in file explorer
         open_directory_in_explorer
-      when 's'  # s - filter files
+      when 'f'  # f - filter files
         if !@filter_query.empty?
           # フィルタが設定されている場合は再編集モードに入る
           @filter_mode = true
@@ -89,7 +91,7 @@ module Beniya
         exit_request
       when '/'  # /
         fzf_search
-      when 'f'  # f - file name search with fzf
+      when 's'  # s - file name search with fzf
         fzf_search
       when 'F'  # F - file content search with rga
         rga_search
@@ -105,6 +107,8 @@ module Beniya
         delete_selected_files
       when 'b'  # b - bookmark operations
         show_bookmark_menu
+      when 'z'  # z - zoxide history navigation
+        show_zoxide_menu
       when '1', '2', '3', '4', '5', '6', '7', '8', '9'  # number keys - go to bookmark
         goto_bookmark(key.to_i)
       else
@@ -1045,5 +1049,180 @@ module Beniya
         return false
       end
     end
+
+    # zoxide 機能
+    def show_zoxide_menu
+      history = get_zoxide_history
+      
+      if history.empty?
+        show_no_zoxide_history_message
+        return false
+      end
+
+      # zoxide履歴選択UI
+      selected_path = select_from_zoxide_history(history)
+      
+      if selected_path
+        navigate_to_zoxide_directory(selected_path)
+      else
+        false
+      end
+    end
+
+    private
+
+    def zoxide_available?
+      system('which zoxide > /dev/null 2>&1')
+    end
+
+    def get_zoxide_history
+      return [] unless zoxide_available?
+
+      begin
+        # zoxide query --list --score で履歴を取得（スコア順）
+        output = `zoxide query --list --score 2>/dev/null`.strip
+        return [] if output.empty?
+
+        # 各行をパスとスコアに分けて配列に変換
+        lines = output.split("\n")
+        history = lines.map do |line|
+          # zoxide の出力は "スコア パス" の形式
+          if line.match(/^\s*(\d+(?:\.\d+)?)\s+(.+)$/)
+            score = $1.to_f
+            path = $2.strip
+            { path: path, score: score }
+          else
+            # スコアがない場合はパスのみ（後方互換性）
+            { path: line.strip, score: 0.0 }
+          end
+        end
+
+        # 有効なディレクトリのみフィルタリング
+        history.select { |entry| Dir.exist?(entry[:path]) }
+      rescue StandardError
+        []
+      end
+    end
+
+    def show_no_zoxide_history_message
+      title = 'Zoxide'
+      content_lines = [
+        '',
+        'No zoxide history found.',
+        '',
+        'Zoxide learns from your directory navigation.',
+        'Use zoxide more to build up history.',
+        '',
+        'Press any key to continue...'
+      ]
+
+      dialog_width = 45
+      dialog_height = 4 + content_lines.length
+      x, y = get_screen_center(dialog_width, dialog_height)
+
+      draw_floating_window(x, y, dialog_width, dialog_height, title, content_lines, {
+                             border_color: "\e[33m", # 黄色
+                             title_color: "\e[1;33m",   # 太字黄色
+                             content_color: "\e[37m"    # 白色
+                           })
+
+      STDIN.getch
+      clear_floating_window_area(x, y, dialog_width, dialog_height)
+      @terminal_ui&.refresh_display
+    end
+
+    def select_from_zoxide_history(history)
+      title = 'Zoxide History'
+      
+      # 履歴を表示用に整形（最大20件）
+      display_history = history.first(20)
+      content_lines = ['']
+      
+      display_history.each_with_index do |entry, index|
+        # パスの表示を短縮（ホームディレクトリを ~ に置換）
+        display_path = entry[:path].gsub(ENV['HOME'], '~')
+        line = "  #{index + 1}. #{display_path}"
+        # 長すぎる場合は切り詰め
+        line = line[0...60] + '...' if line.length > 63
+        content_lines << line
+      end
+      
+      content_lines << ''
+      content_lines << 'Enter number (1-' + display_history.length.to_s + ') or ESC to cancel'
+
+      dialog_width = 70
+      dialog_height = [4 + content_lines.length, 25].min
+      x, y = get_screen_center(dialog_width, dialog_height)
+
+      draw_floating_window(x, y, dialog_width, dialog_height, title, content_lines, {
+                             border_color: "\e[36m", # シアン色
+                             title_color: "\e[1;36m",   # 太字シアン色
+                             content_color: "\e[37m"    # 白色
+                           })
+
+      # 数字入力モード
+      input_buffer = ''
+      
+      loop do
+        char = STDIN.getch
+        
+        case char
+        when "\e", "\x03" # ESC, Ctrl+C
+          clear_floating_window_area(x, y, dialog_width, dialog_height)
+          @terminal_ui&.refresh_display
+          return nil
+        when "\r", "\n" # Enter
+          if !input_buffer.empty?
+            number = input_buffer.to_i
+            if number > 0 && number <= display_history.length
+              selected_entry = display_history[number - 1]
+              clear_floating_window_area(x, y, dialog_width, dialog_height)
+              @terminal_ui&.refresh_display
+              return selected_entry[:path]
+            end
+          end
+          # 無効な入力の場合は再度入力を求める
+          input_buffer = ''
+        when "\u007f", "\b" # Backspace
+          input_buffer = input_buffer[0...-1] unless input_buffer.empty?
+        when /[0-9]/
+          input_buffer += char
+          # 最大2桁まで
+          input_buffer = input_buffer[-2..-1] if input_buffer.length > 2
+          
+          # 入力された数字が範囲内の場合は即座に選択
+          number = input_buffer.to_i
+          if number > 0 && number <= display_history.length && 
+             (number >= 10 || input_buffer.length == 1)
+            selected_entry = display_history[number - 1]
+            clear_floating_window_area(x, y, dialog_width, dialog_height)
+            @terminal_ui&.refresh_display
+            return selected_entry[:path]
+          end
+        end
+      end
+    end
+
+    def navigate_to_zoxide_directory(target_path)
+      return false unless Dir.exist?(target_path)
+
+      # DirectoryListingのnavigate_to_pathメソッドを使用してディレクトリに移動
+      result = @directory_listing.navigate_to_path(target_path)
+      if result
+        @current_index = 0
+        clear_filter_mode
+        
+        # zoxide に移動を記録
+        begin
+          system("zoxide add #{Shellwords.escape(target_path)} > /dev/null 2>&1")
+        rescue StandardError
+          # zoxide add が失敗しても移動は成功として扱う
+        end
+        
+        true
+      else
+        false
+      end
+    end
   end
 end

data/lib/beniya/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Beniya
-  VERSION = '0.5.0'
+  VERSION = '0.6.0'
 end

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: beniya
 version: !ruby/object:Gem::Version
-  version: 0.5.0
+  version: 0.6.0
 platform: ruby
 authors:
 - masisz
 bindir: bin
 cert_chain: []
-date: 2025-09-20 00:00:00.000000000 Z
+date: 2025-09-28 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: io-console
@@ -119,8 +119,10 @@ files:
 - CHANGELOG.md
 - CHANGELOG_v0.4.0.md
 - CHANGELOG_v0.5.0.md
+- CHANGELOG_v0.6.0.md
 - README.md
 - README_EN.md
+- Rakefile
 - beniya.gemspec
 - bin/beniya
 - config_example.rb