dotfiles/yazi_1/.config/yazi/plugins/wise-enter.yazi/README.md

wise-enter.yazi

Yazi plugin: enter the deepest subfolder, extract archives, open files - all in <Enter> key

---

Features

• Tunnel skipping — if a directory contains only a single subdirectory, it jumps straight to the deepest non-trivial level (e.g. a/b/c/ → enters c directly)
• Archive extraction — extracts archives via unar and then navigates into the result, also skipping tunnels
• Smart file opening — opens regular files with open, with optional multi-select support via open_multi

Requirements

• Yazi
• unar (provided by the unarchiver package)

# Arch Linux
sudo pacman -S unarchiver

# macOS
brew install unar

Installation

ya pkg add jaam8/wise-enter

Or manually clone into your Yazi plugins directory:

git clone https://github.com/jaam8/wise-enter.yazi.git ~/.config/yazi/plugins/wise-enter.yazi

Usage

Add to ~/.config/yazi/keymap.toml:

[[manager.keymap]]
on = "<Enter>"
run = "plugin wise-enter"
desc = "Wise enter"

Optionally configure in ~/.config/yazi/init.lua:

require("wise-enter"):setup {
    open_multi = false, -- set to true to open all selected files instead of hovered only
}

Behavior

Hovered item	Action
Directory (no tunnel)	enter — navigate one level in
Directory (with tunnel)	cd — jump straight to the deepest non-empty directory
Archive	Extract via unar, then apply directory logic to the result
Regular file	open — respects open_multi option

Credits

Inspired by and built on top of:

• smart-enter.yazi — the original archive extraction + tunnel skipping idea
• fast-enter.yazi — the open_multi and enter/open toggle approach

License

This plugin is MIT-licensed. For more information check the LICENSE file.