Yazi is a free file manager that runs in your terminal. Type yazi and you see three columns: the folder above, the folder you are in, and a preview of whatever is selected, from code with syntax colours to images, video thumbnails, PDFs and the inside of archives. You move with the arrow keys or Vim's h, j, k and l, press Space to select files, y, x and p to copy, cut and paste them, d to send them to the trash, and q to quit.
It earns its place because it keeps the speed of the keyboard without giving up previews, and it stays quick in huge folders because all its file work runs in the background. It plugs into the tools you may already use: s searches file names with fd, S searches inside files with ripgrep, z jumps with fzf and Z with zoxide. Plugins and themes are small Lua files you install with one command, ya pkg add, and it can browse remote servers over SFTP.
Yazi is MIT-licensed and written in Rust by the developer known as sxyazi, who started it in 2023. It has about 43,500 stars and around 190 contributors. Version 26.9.1 came out on 1 September 2026, and the code is updated every week. The README still calls it a public beta, good for daily use but with breaking changes between versions.
- Repository: github.com/sxyazi/yazi
- Licence: MIT (MIT License)
- Language: Rust. Stars: 43.5K. Forks: 1,071. Last push: Nov 13, 2026.
- Scan: safe, Nov 21, 2026, commit d5e4beb
Who it is for
Developers, sysadmins, people who live in the terminal and anyone tired of typing cd and ls to find a file. It runs on macOS, Linux and Windows; image previews need a terminal that can show pictures, such as Ghostty, kitty, iTerm2, WezTerm or Windows Terminal.
Getting started
1. Install on macOS or Linux with Homebrew
brew install yazi2. Or on Windows, with winget
winget install sxyazi.yazi3. Optional: add the helpers for video, PDF and archive previews and for search (ffmpeg, 7-Zip, poppler, fd, ripgrep, fzf, zoxide), listed in the install guide
https://yazi-rs.github.io/docs/installation4. Open it in the current folder. Press F1 or ~ for every key, and q to quit
yazi5. Add a plugin or theme from GitHub with its package manager, here a git status plugin
ya pkg add yazi-rs/plugins:gitPackage managers install the yazi and ya programs and change nothing else. To land in the folder you were browsing when you quit, add the short y shell function from the quick start guide to your shell config. Plugins are Lua code by other people, which can run commands and make web requests; this scan does not cover them, nor the prebuilt binaries.
Safety scan
We cloned sxyazi/yazi at commit d5e4beb on Nov 21, 2026 and ran the checks described on the GitHub Tools page: credential patterns, decode-and-execute code, install-time scripts, committed binaries, risky CI workflows, every host the code talks to, known vulnerabilities in pinned dependencies, and project hygiene. A person read every hit. This is what we found.
- 0 secret hits and no committed binaries across 1,607 files and about 97,000 lines, mostly Rust, with Lua for the built-in plugins and previewers.
- 0 pattern hits. Of the six build files the scanner lists, the ones in yazi-cli, yazi-fm, yazi-fs and yazi-version only check build settings, set platform flags or record the version. The other two belong to yazi-build, the cargo install route: it clones Yazi's own repository from GitHub at the shipped tag and builds that.
- No install script. Releases are prebuilt binaries for macOS, Linux and Windows, published to winget and Snap by the release workflow and packaged by Homebrew and Linux distributions.
- 4 advisories across the 541 Rust packages in Cargo.lock, none high or critical: a moderate timing weakness in the rsa library, which is only used when you connect to an SFTP server, and notices that bincode, chrono and paste are no longer maintained.
- The program contacts no server on its own; the hosts in the code are documentation links, crates.io and GitHub. ya pkg fetches the plugins you name from GitHub with git. 10 workflows: one uses pull_request_target only to run the project's labelling script from its own yazi-rs/.github repository, without checking out pull request code. None of the 24 third-party actions is pinned to a commit, and the winget publisher tracks @main. Dependabot is on; no security policy file, CodeQL or OpenSSF Scorecard score.
What the scanner counted
| Check | Result |
|---|---|
| Secrets | None found. |
| Suspicious code | None found. |
| Install-time code | 6 Cargo build scripts |
| Committed binaries | None. |
| CI workflows | 10 workflows. 1 uses pull_request_target, none check out the pull request head. 24 of 24 third-party actions pinned to a tag rather than a commit. |
| Network hosts | 9 distinct hosts referenced from source; most often github.com, crates.io, www.xfree86.org, yazi-rs.github.io. No URLs to bare IP addresses. |
| Known vulnerabilities | 4 advisories across 541 pinned packages: 0 critical, 0 high, 1 moderate, 0 low, 3 unrated. Cargo.lock: 541 packages, 4 advisories. |
| Project hygiene | Has automated dependency updates, licence file, contributing guide. Missing security policy, CodeQL. |
| OpenSSF Scorecard | Not scored: the project is not in Scorecard's weekly index. |
The raw findings
Every hit the scanner wrote out, with a link to the exact line at the scanned commit. Secrets candidates are redacted.
Worst known vulnerabilities (4 of 4)
| Advisory | Severity | Package | Summary |
|---|---|---|---|
| GHSA-4grx-2x9w-596c | moderate | rsa@0.10.0-rc.18 | Marvin Attack: potential key recovery through timing sidechannels |
| RUSTSEC-2025-0141 | unknown | bincode@1.3.3 | Bincode is unmaintained |
| RUSTSEC-2026-0543 | unknown | chrono@0.4.45 | chrono is unmaintained |
| RUSTSEC-2024-0436 | unknown | paste@1.0.15 | paste - no longer maintained |
Workflows worth a look
- .github/workflows/moderate.yml: pull_request_target
By the numbers
| Stars | 43.5K |
|---|---|
| Forks | 1,071 |
| Contributors | 188 |
| Commits | 1,571 |
| Open issues | 58 |
| Open pull requests | 19 |
| Releases | 33 |
| Latest release | v26.9.1 |
| Licence | MIT |
| Main language | Rust |
| Project age | 3 years |
| Last push | Nov 13, 2026 |
| Tracked files | 1,607 |
| Lines of code | 97.4K |
| Checkout size | 3 MB |
Lines by language: Rust 84.2K, Lua 5,167, TOML 4,223, Markdown 2,607, YAML 967, Shell 202.
Questions
Is Yazi free?
Yes. It is free and open source under the MIT licence, with no paid version. The README shows a sponsor banner for the Warp terminal.
Yazi or a normal file manager like Finder?
Yazi if you already work in a terminal and want to move, rename and preview files without the mouse, including on a server over SSH. Finder or Explorer is easier if you rarely open a terminal.
Does Yazi work on Windows?
Yes. Install it with winget or Scoop and run it in Windows Terminal, which can show image previews. The install guide recommends pointing it at the file command that comes with Git for Windows.
Does Yazi send my data anywhere?
No. It reads your files locally and we found no analytics or update checks. It goes online only when you install a plugin or connect to an SFTP server you set up.
How do I uninstall Yazi?
Run brew uninstall yazi or winget uninstall sxyazi.yazi, remove the y function if you added one, and delete ~/.config/yazi if you want your settings and plugins gone.
This post is part of GitHub Tools, where every repository is cloned and scanned before it is written up. The scan is a snapshot of one commit on one day; the repository has moved on since, so check it before you install.
