macOS
brew install yazilocal Homebrew formula metadata
sudo port install yaziMacPorts ports tree · sysutils/yazi/Portfile · source: api.github.com
brew
Blazing fast terminal file manager written in Rust, based on async I/O. Version 26.5.6 via Homebrew; verified 2026-06-15.
install
brew install yazilocal Homebrew formula metadata
sudo port install yaziMacPorts ports tree · sysutils/yazi/Portfile · source: api.github.com
sudo apk add yaziAlpine Linux edge package indexes · yazi · source: dl-cdn.alpinelinux.org
nix profile install nixpkgs#yazinixpkgs package indexes · pkgs/by-name/ya/yazi/package.nix · source: api.github.com
sudo pacman -S yaziArch Linux sync databases · yazi · source: geo.mirror.pkgbuild.com
sudo zypper install yaziopenSUSE Tumbleweed package metadata · yazi · source: download.opensuse.org
scoop install main/yaziScoop official bucket manifest trees · bucket/yazi.json · source: api.github.com
winget install --id sxyazi.yazi -eWindows Package Manager source index · sxyazi.yazi · source: cdn.winget.microsoft.com
overview
Blazing fast terminal file manager written in Rust, based on async I/O
history
Yazi is a Rust terminal file manager built around non-blocking async I/O. It became notable quickly because it combines the old terminal file-manager niche with newer expectations: image previews, code highlighting, plugin and theme management, cross-platform packaging, and integrations with tools such as ripgrep, fd, fzf, and zoxide.
The GitHub repository was created in July 2023. The README describes Yazi as a terminal file manager written in Rust, based on non-blocking async I/O, and the official site foregrounds asynchronous I/O, multi-threaded CPU task handling, async task scheduling, multiple image protocols, and pre-cached previewing.
Yazi's architecture grew into a multi-crate Rust workspace with separate crates for the file manager, filesystem, TUI, plugin layer, scheduler, terminal handling, virtual filesystem, and supporting components. The README also documents a concurrent Lua plugin system, a package manager for plugins and themes, and a data-distribution service for cross-instance communication and state persistence.
Yazi's adoption has been unusually fast for a terminal file manager. The GitHub API showed roughly forty thousand stars by July 2026, and package metadata in the input already shows it present across Homebrew, Alpine, MacPorts, Nix, Arch, Scoop, Winget, and openSUSE-style ecosystems.
Its appeal overlaps with users of ranger, nnn, lf, vifm, and modern terminal workflows: people who want keyboard-first file management but also expect previews, async responsiveness, Lua customization, and clean integration with other fast CLI search/navigation tools.
Users run yazi for the interactive terminal file manager and ya for helper/package-manager workflows. Common setup involves TOML files for the main config, keymap, and theme plus init.lua for Lua customization.
Practical workflows include browsing large directories without blocking, previewing images or source files in capable terminals, opening files through configured rules, using plugins for custom previews or actions, and integrating with ripgrep, fd, fzf, zoxide, shells, and editors.
Yazi is a strong example of a modern CLI package becoming popular because it upgrades an old Unix interaction model without abandoning the terminal. It packages a full interactive app, helper command, config schema, plugin ecosystem, and terminal-media assumptions into a single installable tool.
For package nerds, Yazi is also a useful pressure test for terminal capability packaging: image protocols, optional preview helpers, shell integrations, cross-platform config paths, and plugin distribution all matter more than they would for a simple line-oriented CLI.
security posture
broad file, network, media, or database tool signal.
blue risk · medium confidence · tool
Before unattended agent use, check whether the tool reads plaintext credentials, writes remote state, publishes artifacts, or shells out to plugins.
local files
These source-backed paths show where this package keeps local settings or durable credentials. Automic Vault can use them as review targets for secret scanning, migration, and command approval.
Config paths the tool may read or write during local use.
~/.config/yazi/yazi.toml~/.config/yazi/keymap.toml~/.config/yazi/theme.toml~/.config/yazi/init.lua%AppData%\yazi\config\yazi.tomlexecutables
| Command | Kind | Exposure | Note |
|---|---|---|---|
ya | cli | global executable | |
yazi | cli | global executable |
freshness
These signals separate page generation age, package-manager activity, and upstream release comparison. Version lag is warned only when an evidence URL and comparable versions are present.
https://github.com/sxyazi/yazi
install metadata
| Package key | brew:yazi |
|---|---|
| Version | 26.5.6 |
| Package manager | Homebrew |
| Package manager page | https://formulae.brew.sh/formula/yazi |
| Homepage | https://yazi-rs.github.io |
| Repository | https://github.com/sxyazi/yazi |
| Upstream docs | https://yazi-rs.github.io/docs/image-preview |
| License | MIT |
| Source archive | https://github.com/sxyazi/yazi/archive/refs/tags/v26.5.6.tar.gz |
| Last updated | 2026-06-15T10:21:24-04:00 |
| Pulse | updated |
| Build dependencies | rust |
| Bottle | available (on arm64_linux, arm64_sequoia, arm64_sonoma, arm64_tahoe, sonoma, x86_64_linux) |
| Homebrew post-install | not defined |
| Service | none declared |
registry facts
| Source Database | Homebrew formula API |
|---|---|
| Tap | homebrew/core |
| Full Name | yazi |
| Version Scheme | 0 |
| Revision | 0 |
| Head Version | HEAD |
| Bottle Stable Root URL | https://ghcr.io/v2/homebrew/core |
| Deprecated | no |
| Disabled | no |
| Keg Only | no |
| URL Keys |
|
source database matches
Matches are pulled from external package-manager indexes and kept separate from local Automic Vault package links.
yazi
nix profile install nixpkgs#yaziyazi 26.5.6-r0
Blazing fast terminal file manager written in Rust, based on async I/O
sudo apk add yaziyazi-bash-completion 26.5.6-r0
Bash completions for yazi
sudo apk add yazi-bash-completionyazi-cli 26.5.6-r0
Blazing fast terminal file manager written in Rust, based on async I/O - CLI
sudo apk add yazi-cliyazi-doc 26.5.6-r0
Blazing fast terminal file manager written in Rust, based on async I/O (documentation)
sudo apk add yazi-docyazi-fish-completion 26.5.6-r0
Fish completions for yazi
sudo apk add yazi-fish-completionyazi-zsh-completion 26.5.6-r0
Zsh completions for yazi
sudo apk add yazi-zsh-completionyazi 26.5.6-3
Blazing fast terminal file manager written in Rust, based on async I/O
https://github.com/sxyazi/yazi
sudo pacman -S yaziyazi 26.5.6-2.1
Blazing fast terminal file manager written in Rust, based on async I/O
https://github.com/sxyazi/yazi
sudo zypper install yaziyazi-bash-completion 26.5.6-2.1
Bash Completion for yazi
https://github.com/sxyazi/yazi
sudo zypper install yazi-bash-completionyazi-fish-completion 26.5.6-2.1
Fish Completion for yazi
https://github.com/sxyazi/yazi
sudo zypper install yazi-fish-completionyazi-zsh-completion 26.5.6-2.1
ZSH Completion for yazi
https://github.com/sxyazi/yazi
sudo zypper install yazi-zsh-completionyazi
sudo port install yazimain/yazi
scoop install main/yazisxyazi.yazi
winget install --id sxyazi.yazi -esource trail
This page is generated by av-web from the private package SQLite artifact built by scripts/generate-pkg-sqlite.py.
View the package source record on GitHub.