diff --git a/app-misc/yazi/Manifest b/app-misc/yazi/Manifest
new file mode 100644
index 0000000..480d3be
--- /dev/null
+++ b/app-misc/yazi/Manifest
@@ -0,0 +1,4 @@
+DIST yazi-26.1.4-crates.tar.xz 47566476 BLAKE2B 619a3d13218fc582ca6e81044ea66f082ff1eedfa1ed2da628717b3a85d9d6b65d04a1f326134f8c0eb82e5fd2cd9a0a0bb8ae775f517411cf1eb735f40de98a SHA512 fc2ad3b303f020f605ea73a63502cbbf137b7068e8d90bd09faec7dc7ca588e40512c3116be1bc6104b87b5066b88beb2ae933004718b5f13fb630d25bffa85e
+DIST yazi-26.1.4.tar.gz 1012726 BLAKE2B 86e094a5302ac95965a7e2fe56636c3cf7874c91e670cd968289ddee627d535860546dda7cfd19763188e94e452aad27c5859c3f523d4c33761111429921bf72 SHA512 d9a6138b8c1afd6fa5c0039564847a8c6f8efa24d23def224d2f17f691b364793fb4b7da789678bf3c86c9f5c5216ba9b6239d962154b84fe064ecfe9a3788be
+EBUILD yazi-26.1.4.ebuild 1827 BLAKE2B c70c7b2ba8837e8ea996da48f664e049384b2beaf129f7321abd300f24df37cf8e9a1fcc8ba144dd39b3d9adda1ac5199f11666ea880ce9673307789a8308a17 SHA512 5cf6e65f668b6e2245719771d8a4dd12f4f6a0f7ad823e536261ccc88f54a640681ee9d421a9f661659982311e502368878019f51a06d9da3c787c0f0602d471
+MISC metadata.xml 452 BLAKE2B bc45498f955c9662cd9d78e87e1a19c8a4e9c354fdb8b5e378f611f1d45ef3c64ba8ddcc3d7f93671d3f2eff9293fde663fcf13f3e0eb8edb1c890e577298b80 SHA512 405c93999dd70b0f13adbbb6d6f288a646985b5d48076ad9c9f02dd621ee25ed78874239f5fa8f13086b2485f16f3c3069b7a832fb04e7c0e68a8543b2f44cdf
diff --git a/app-misc/yazi/metadata.xml b/app-misc/yazi/metadata.xml
new file mode 100644
index 0000000..2514840
--- /dev/null
+++ b/app-misc/yazi/metadata.xml
@@ -0,0 +1,15 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE pkgmetadata SYSTEM "https://www.gentoo.org/dtd/metadata.dtd">
+<pkgmetadata>
+	<maintainer type="person">
+		<email>f00wl@felinn.org</email>
+		<name>f00wl</name>
+	</maintainer>
+	<upstream>
+		<remote-id type="github">sxyazi/yazi</remote-id>
+		<bugs-to>https://github.com/sxyazi/yazi/issues</bugs-to>
+	</upstream>
+	<use>
+		<flag name="cli">Install CLI Data Distribution Service</flag>
+	</use>
+</pkgmetadata>
diff --git a/app-misc/yazi/yazi-26.1.4.ebuild b/app-misc/yazi/yazi-26.1.4.ebuild
new file mode 100644
index 0000000..233d91c
--- /dev/null
+++ b/app-misc/yazi/yazi-26.1.4.ebuild
@@ -0,0 +1,78 @@
+# Copyright 2026 Gentoo Authors
+# Distributed under the terms of the GNU General Public License v2
+
+EAPI=8
+
+CRATES=" "
+
+RUST_MIN_VER="1.91.0"
+
+inherit cargo desktop shell-completion xdg
+
+DESCRIPTION="Blazing fast terminal file manager written in Rust, based on async I/O."
+HOMEPAGE="https://yazi-rs.github.io"
+SRC_URI="
+	https://github.com/sxyazi/yazi/archive/refs/tags/v${PV}.tar.gz -> ${P}.tar.gz
+	https://github.com/gentoo-zh-drafts/${PN}/releases/download/v${PV}/${P}-crates.tar.xz
+	${CARGO_CRATE_URIS}
+"
+
+LICENSE="MIT"
+# Dependent crate licenses
+LICENSE+="
+	Apache-2.0 Apache-2.0-with-LLVM-exceptions BSD-2 BSD Boost-1.0
+	CC0-1.0 ISC MIT MPL-2.0 UoI-NCSA Unicode-3.0 ZLIB
+"
+SLOT="0"
+KEYWORDS="~amd64"
+
+IUSE="+cli"
+
+QA_FLAGS_IGNORED="
+	usr/bin/ya.*
+"
+
+RDEPEND="
+	dev-libs/oniguruma
+"
+DEPEND="${RDEPEND}"
+
+DOCS=(
+	"README.md"
+	"yazi-config/preset/keymap-default.toml"
+	"yazi-config/preset/theme-dark.toml"
+	"yazi-config/preset/theme-light.toml"
+	"yazi-config/preset/yazi-default.toml"
+)
+
+src_prepare() {
+	export YAZI_GEN_COMPLETIONS=true
+	sed -i -r 's/strip\s+= true/strip = false/' Cargo.toml || die "Sed failed!"
+	eapply_user
+}
+
+src_compile() {
+	# workaround for GCC 15 issues:
+	# unvendor libonig from rust-onig. see bugs 943785, 945008
+	export RUSTONIG_SYSTEM_LIBONIG=1
+	cargo_src_compile --locked
+	use cli && cargo_src_compile -p "${PN}-cli"
+}
+
+src_install() {
+	dobin "$(cargo_target_dir)/${PN}"
+	use cli && dobin "$(cargo_target_dir)/ya"
+
+	newbashcomp "${S}/yazi-boot/completions/${PN}.bash" "${PN}"
+	dozshcomp "${S}/yazi-boot/completions/_${PN}"
+	dofishcomp "${S}/yazi-boot/completions/${PN}.fish"
+
+	if use cli; then
+		newbashcomp "${S}/yazi-cli/completions/ya.bash" "ya"
+		dozshcomp "${S}/yazi-cli/completions/_ya"
+		dofishcomp "${S}/yazi-cli/completions/ya.fish"
+	fi
+
+	domenu "assets/${PN}.desktop"
+	einstalldocs
+}
diff --git a/metadata/md5-cache/app-misc/yazi-26.1.4 b/metadata/md5-cache/app-misc/yazi-26.1.4
new file mode 100644
index 0000000..e330787
--- /dev/null
+++ b/metadata/md5-cache/app-misc/yazi-26.1.4
@@ -0,0 +1,16 @@
+BDEPEND=|| ( >=dev-lang/rust-bin-1.91.0:* >=dev-lang/rust-1.91.0:* )
+DEFINED_PHASES=compile configure install postinst postrm preinst prepare setup test unpack
+DEPEND=dev-libs/oniguruma
+DESCRIPTION=Blazing fast terminal file manager written in Rust, based on async I/O.
+EAPI=8
+HOMEPAGE=https://yazi-rs.github.io
+IDEPEND=dev-util/desktop-file-utils x11-misc/shared-mime-info
+INHERIT=cargo desktop shell-completion xdg
+IUSE=+cli debug
+KEYWORDS=~amd64
+LICENSE=MIT Apache-2.0 Apache-2.0-with-LLVM-exceptions BSD-2 BSD Boost-1.0 CC0-1.0 ISC MIT MPL-2.0 UoI-NCSA Unicode-3.0 ZLIB
+RDEPEND=dev-libs/oniguruma
+SLOT=0
+SRC_URI=https://github.com/sxyazi/yazi/archive/refs/tags/v26.1.4.tar.gz -> yazi-26.1.4.tar.gz https://github.com/gentoo-zh-drafts/yazi/releases/download/v26.1.4/yazi-26.1.4-crates.tar.xz
+_eclasses_=toolchain-funcs	30214924c0c3b92ec7dbf24fc70d60d3	flag-o-matic	a7afe42e95fb46ce9691605acfb24672	multiprocessing	1e32df7deee68372153dca65f4a7c21f	rust	20da14430886f3de143eb101684fcf62	rust-toolchain	76468983281b0a7fc167ca224f84ecfd	cargo	aeba1d272f6c2e000912e11d8cf626eb	desktop	7b6f6e9d65093966fbc8475399c5dd4e	bash-completion-r1	767861f3744f589ee5291c1698b1c082	shell-completion	0b655d0d825e157a5e99c463bddaac16	xdg-utils	42869b3c8d86a70ef3cf75165a395e09	xdg	3ef49a87c52c8b77c476351195dfe575
+_md5_=56d252a37fa86e09c0c21389f85667e7