repositories / dotfiles

dotfiles

bugabingas dorkfiles

owned by bugabinga

docs: plan yazi nugu dotfiles config

4977fdc73dbc2875a57a64483e16c04064b0dbdd

Oliver Jan Krylow <oliver@bugabinga.net> ·

unsigned

Browse filesCompare with HEAD

Changed files (1)

docs/superpowers/plans/2026-05-30-yazi-nugu-dotfiles.md

Added
new file mode 100644
1 +# Yazi Nugu Dotfiles Implementation Plan
3 +> **For agentic workers:** REQUIRED SUB-SKILL: Use /skill:executing-plans to implement this plan task-by-task. Steps use checkbox (`- [ ]`) syntax for tracking.
5 +**Goal:** Build a dotfiles-managed Yazi config that uses generated Nugu flavors, tasteful Yazi-native key overrides, and a small managed plugin set.
7 +**Architecture:** Add `yazi/` as a managed dotfiles directory, generated Nugu dark/light Yazi flavors from `nugu/yazi.nu`, and minimal Yazi TOML/Lua config. Plugins are installed and locked by `ya pkg`; installed plugin directories are ignored and not vendored.
9 +**Tech Stack:** Yazi 26.5.6, `ya pkg`, Nushell, Just, TOML, Lua, dotfiles symlink manifests.
11 +**Roadmap:** None
13 +**Phase:** Single-plan implementation
15 +---
17 +## File structure
19 +Create or modify these files:
21 +- Create `nugu/yazi.nu`: generator from Nugu semantic palette to Yazi flavor TOML.
22 +- Modify `nugu/justfile`: add `yazi` recipe and include it in `install`.
23 +- Create `yazi/theme.toml`: selects generated Nugu flavors.
24 +- Create `yazi/yazi.toml`: minimal manager/open/preview/plugin rules.
25 +- Create `yazi/keymap.toml`: prepend-only key overrides.
26 +- Create `yazi/init.lua`: plugin setup.
27 +- Create `yazi/package.toml`: generated by `ya pkg add`; plugin lock source of truth.
28 +- Create `yazi/flavors/nugu-dark.yazi/flavor.toml`: generated artifact.
29 +- Create `yazi/flavors/nugu-light.yazi/flavor.toml`: generated artifact.
30 +- Modify `.gitignore`: ignore installed `yazi/plugins/` artifacts.
31 +- Modify `desktop.symlinks`, `fedora.symlinks`, `x230.symlinks`: map `yazi` to `~/.config/yazi`.
33 +Do not touch or add `yazi/plugins/`. Existing untracked `pi/research/**` noise must not be staged.
35 +---
37 +### Task 1: Add dotfiles ownership, ignore rules, and live symlink
39 +**Files:**
40 +- Modify: `/home/me/Workspace/dotfiles/.gitignore`
41 +- Modify: `/home/me/Workspace/dotfiles/desktop.symlinks`
42 +- Modify: `/home/me/Workspace/dotfiles/fedora.symlinks`
43 +- Modify: `/home/me/Workspace/dotfiles/x230.symlinks`
44 +- Create: `/home/me/Workspace/dotfiles/yazi/.gitkeep` temporarily if needed before config files exist
45 +- Live target: `/home/me/.config/yazi`
47 +- [ ] **Step 1: Add Yazi installed plugin ignore rule**
49 +Append this block to `/home/me/Workspace/dotfiles/.gitignore` near the other local runtime/package caches:
51 +```gitignore
52 +# Yazi package manager installs plugin repos here; package.toml is source of truth.
53 +yazi/plugins/
54 +```
56 +- [ ] **Step 2: Add Yazi to `desktop.symlinks`**
58 +In `/home/me/Workspace/dotfiles/desktop.symlinks`, insert this pair after the existing `pi` mapping:
60 +```text
61 +yazi
62 +~/.config/yazi
63 +```
65 +The beginning of the file should become:
67 +```text
68 +forgejo-cli
69 +~/.config/forgejo-cli
71 +pi
72 +~/.pi
74 +yazi
75 +~/.config/yazi
77 +Notes
78 +~/Notes
79 +```
81 +- [ ] **Step 3: Add Yazi to `fedora.symlinks`**
83 +In `/home/me/Workspace/dotfiles/fedora.symlinks`, insert this pair after the `Notes` mapping:
85 +```text
86 +yazi
87 +~/.config/yazi
88 +```
90 +The beginning of the file should become:
92 +```text
93 +Notes
94 +~/Notes
96 +yazi
97 +~/.config/yazi
99 +git/gitconfig
100 +~/.config/git/config
101 +```
103 +- [ ] **Step 4: Add Yazi to `x230.symlinks`**
105 +In `/home/me/Workspace/dotfiles/x230.symlinks`, insert this pair after the `Notes` mapping:
107 +```text
108 +yazi
109 +~/.config/yazi
110 +```
112 +The beginning of the file should become:
114 +```text
115 +Notes
116 +~/Notes
118 +yazi
119 +~/.config/yazi
121 +git/gitconfig
122 +~/.config/git/config
123 +```
125 +- [ ] **Step 5: Create Yazi directory skeleton**
127 +Run:
129 +```bash
130 +cd /home/me/Workspace/dotfiles
131 +mkdir -p yazi/flavors/nugu-dark.yazi yazi/flavors/nugu-light.yazi
132 +touch yazi/.gitkeep
133 +```
135 +Expected: directories exist. Verify:
137 +```bash
138 +test -d yazi/flavors/nugu-dark.yazi && test -d yazi/flavors/nugu-light.yazi && test -f yazi/.gitkeep && echo ok
139 +```
141 +Expected output:
143 +```text
145 +```
147 +- [ ] **Step 6: Back up existing live Yazi config now**
149 +Run:
151 +```bash
152 +if [ -e /home/me/.config/yazi ] && [ ! -L /home/me/.config/yazi ]; then
153 + mv /home/me/.config/yazi /home/me/.config/yazi.noctalia-backup-$(date +%Y%m%d%H%M%S)
155 +```
157 +Expected: existing non-symlink config is moved aside; no output on success.
159 +- [ ] **Step 7: Bootstrap live symlink now**
161 +Run:
163 +```bash
164 +cd /home/me/Workspace/dotfiles
165 +java bootstripper.java bootstrap
166 +```
168 +Expected: bootstrap exits 0 and creates `/home/me/.config/yazi` symlink.
170 +- [ ] **Step 8: Verify live symlink target**
172 +Run:
174 +```bash
175 +realpath /home/me/.config/yazi
176 +```
178 +Expected output:
180 +```text
181 +/home/me/Workspace/dotfiles/yazi
182 +```
184 +- [ ] **Step 9: Run dotfiles manifest check**
186 +Run:
188 +```bash
189 +cd /home/me/Workspace/dotfiles
190 +java bootstripper.java check
191 +```
193 +Expected: `OK bootstripper check passed.`
195 +- [ ] **Step 10: Commit ownership changes**
197 +Run:
199 +```bash
200 +cd /home/me/Workspace/dotfiles
201 +git add .gitignore desktop.symlinks fedora.symlinks x230.symlinks yazi/.gitkeep
202 +git commit -m "chore: manage yazi dotfiles"
203 +```
205 +Expected: commit succeeds. `yazi/.gitkeep` is removed in Task 3 after real config files exist.
207 +---
209 +### Task 2: Add Nugu-to-Yazi flavor generator
211 +**Files:**
212 +- Create: `/home/me/Workspace/dotfiles/nugu/yazi.nu`
213 +- Modify: `/home/me/Workspace/dotfiles/nugu/justfile`
215 +- [ ] **Step 1: Create `nugu/yazi.nu`**
217 +Write this file to `/home/me/Workspace/dotfiles/nugu/yazi.nu`:
219 +```nu
220 +use palette.nu
222 +# Generate a Yazi flavor.toml from the Nugu semantic palette.
223 +export def flavor [mode: string] {
224 + let nugu = (palette nugu $mode)
225 + let p = $nugu.palette
227 + let theme = {
228 + mgr: {
229 + cwd: { fg: $p.content.normal }
230 + find_keyword: { fg: $p.content.accent, bold: true, italic: true, underline: true }
231 + find_position: { fg: $p.content.accent, bold: true }
232 + symlink_target: { fg: $p.content.minor }
234 + marker_copied: { fg: $p.content.focus, bg: $p.content.focus }
235 + marker_cut: { fg: $p.warning, bg: $p.warning }
236 + marker_marked: { fg: $p.content.accent, bg: $p.content.accent }
237 + marker_selected: { fg: $p.ui.important_local, bg: $p.ui.important_local }
239 + count_copied: { fg: $p.content.backdrop, bg: $p.content.focus, bold: true }
240 + count_cut: { fg: $p.content.backdrop, bg: $p.warning, bold: true }
241 + count_selected: { fg: $p.ui.backdrop, bg: $p.ui.important_local, bold: true }
243 + border_symbol: "│"
244 + border_style: { fg: $p.ui.unfocus }
247 + status: {
248 + overall: { fg: $p.ui.normal, bg: $p.ui.backdrop }
249 + sep_left: { open: "", close: "" }
250 + sep_right: { open: "", close: "" }
251 + perm_type: { fg: $p.content.important_global }
252 + perm_read: { fg: $p.content.focus }
253 + perm_write: { fg: $p.warning }
254 + perm_exec: { fg: $p.error }
255 + perm_sep: { fg: $p.content.minor }
256 + progress_label: { fg: $p.content.normal, bold: true }
257 + progress_normal: { fg: $p.ui.accent, bg: $p.ui.backdrop }
258 + progress_error: { fg: $p.error, bg: $p.ui.backdrop }
261 + mode: {
262 + normal_main: { fg: $p.ui.backdrop, bg: $p.ui.accent, bold: true }
263 + normal_alt: { fg: $p.ui.normal, bg: $p.ui.backdrop }
264 + select_main: { fg: $p.ui.backdrop, bg: $p.ui.important_local, bold: true }
265 + select_alt: { fg: $p.ui.normal, bg: $p.ui.backdrop }
266 + unset_main: { fg: $p.content.backdrop, bg: $p.warning, bold: true }
267 + unset_alt: { fg: $p.ui.normal, bg: $p.ui.backdrop }
270 + tabs: {
271 + active: { fg: $p.ui.backdrop, bg: $p.ui.accent, bold: true }
272 + inactive: { fg: $p.ui.minor, bg: $p.ui.backdrop }
273 + sep_inner: { open: "", close: "" }
274 + sep_outer: { open: "", close: "" }
277 + which: {
278 + cols: 3
279 + mask: { bg: $p.ui.backdrop }
280 + cand: { fg: $p.ui.accent, bold: true }
281 + rest: { fg: $p.ui.minor }
282 + desc: { fg: $p.ui.normal }
283 + separator: " → "
284 + separator_style: { fg: $p.ui.minor }
287 + input: {
288 + border: { fg: $p.ui.unfocus }
289 + title: { fg: $p.ui.accent, bold: true }
290 + value: { fg: $p.content.normal }
291 + selected: { fg: $p.content.backdrop, bg: $p.content.focus }
294 + confirm: {
295 + border: { fg: $p.warning }
296 + title: { fg: $p.warning, bold: true }
297 + body: { fg: $p.content.normal }
298 + list: { fg: $p.content.normal }
299 + btn_yes: { fg: $p.content.backdrop, bg: $p.error, bold: true }
300 + btn_no: { fg: $p.ui.backdrop, bg: $p.ui.focus, bold: true }
301 + btn_labels: ["yes", "no"]
304 + spot: {
305 + border: { fg: $p.ui.unfocus }
306 + title: { fg: $p.ui.accent, bold: true }
307 + tbl_col: { fg: $p.content.normal }
308 + tbl_cell: { fg: $p.content.backdrop, bg: $p.content.focus }
311 + pick: {
312 + border: { fg: $p.ui.unfocus }
313 + active: { fg: $p.ui.backdrop, bg: $p.ui.focus, bold: true }
314 + inactive: { fg: $p.ui.normal }
317 + cmp: {
318 + border: { fg: $p.ui.unfocus }
319 + active: { fg: $p.ui.backdrop, bg: $p.ui.focus, bold: true }
320 + inactive: { fg: $p.ui.normal }
323 + tasks: {
324 + border: { fg: $p.ui.unfocus }
325 + title: { fg: $p.ui.accent, bold: true }
326 + hovered: { fg: $p.content.focus, bold: true }
329 + help: {
330 + on: { fg: $p.ui.accent, bold: true }
331 + run: { fg: $p.content.important_local }
332 + desc: { fg: $p.content.normal }
333 + hovered: { fg: $p.ui.backdrop, bg: $p.ui.focus, bold: true }
334 + footer: { fg: $p.ui.backdrop, bg: $p.ui.accent, bold: true }
337 + notify: {
338 + title_info: { fg: $p.info, bold: true }
339 + title_warn: { fg: $p.warning, bold: true }
340 + title_error: { fg: $p.error, bold: true }
343 + filetype: {
344 + rules: [
345 + { mime: "image/*", fg: $p.content.focus }
346 + { mime: "{audio,video}/*", fg: $p.content.important_local }
347 + { mime: "application/{zip,rar,7z*,tar,gzip,xz,zstd,bzip*,lzma,compress,archive,cpio,arj,xar,ms-cab*}", fg: $p.content.accent }
348 + { mime: "application/{pdf,doc,rtf}", fg: $p.content.important_global }
349 + { mime: "*", is: "orphan", fg: $p.content.backdrop, bg: $p.error, bold: true }
350 + { mime: "application/*exec*", fg: $p.error }
351 + { url: "*/", fg: $p.ui.accent, bold: true }
352 + { url: "*", fg: $p.content.normal }
356 + git: {
357 + unknown: { fg: $p.content.minor }
358 + modified: { fg: $p.warning, bold: true }
359 + added: { fg: $p.content.focus, bold: true }
360 + untracked: { fg: $p.content.accent, bold: true }
361 + ignored: { fg: $p.content.minor }
362 + deleted: { fg: $p.error, bold: true }
363 + updated: { fg: $p.warning, bold: true }
364 + clean: { fg: $p.content.minor }
365 + unknown_sign: ""
366 + modified_sign: "M "
367 + added_sign: "A "
368 + untracked_sign: "? "
369 + ignored_sign: "I "
370 + deleted_sign: "D "
371 + updated_sign: "U "
372 + clean_sign: ""
376 + $theme | to toml
378 +```
380 +- [ ] **Step 2: Check the new Nushell module parses**
382 +Run:
384 +```bash
385 +cd /home/me/Workspace/dotfiles/nugu
386 +open yazi.nu | nu-check --as-module --debug yazi.nu
387 +```
389 +Expected: `nu-check` exits 0.
391 +- [ ] **Step 3: Add `yazi` recipe to `nugu/justfile`**
393 +Add this recipe after the `ghostty` recipe:
395 +```just
396 +yazi: build
397 + rm --force --recursive {{output}}/yazi
398 + mkdir {{output}}/yazi
399 + mkdir {{output}}/yazi/nugu-dark.yazi
400 + mkdir {{output}}/yazi/nugu-light.yazi
401 + use yazi.nu; yazi flavor dark | save --raw {{output}}/yazi/nugu-dark.yazi/flavor.toml
402 + use yazi.nu; yazi flavor light | save --raw {{output}}/yazi/nugu-light.yazi/flavor.toml
403 + mkdir ../yazi/flavors
404 + mkdir ../yazi/flavors/nugu-dark.yazi
405 + mkdir ../yazi/flavors/nugu-light.yazi
406 + cp {{output}}/yazi/nugu-dark.yazi/flavor.toml ../yazi/flavors/nugu-dark.yazi/flavor.toml
407 + cp {{output}}/yazi/nugu-light.yazi/flavor.toml ../yazi/flavors/nugu-light.yazi/flavor.toml
408 +```
410 +- [ ] **Step 4: Include Yazi in Nugu install recipe**
412 +Change the final recipe in `/home/me/Workspace/dotfiles/nugu/justfile` from:
414 +```just
415 +install: helix wezterm ghostty
416 +```
418 +to:
420 +```just
421 +install: helix wezterm ghostty yazi
422 +```
424 +- [ ] **Step 5: Generate Yazi flavors**
426 +Run:
428 +```bash
429 +cd /home/me/Workspace/dotfiles/nugu
430 +just yazi
431 +```
433 +Expected files:
435 +```text
436 +/home/me/Workspace/dotfiles/yazi/flavors/nugu-dark.yazi/flavor.toml
437 +/home/me/Workspace/dotfiles/yazi/flavors/nugu-light.yazi/flavor.toml
438 +```
440 +Verify:
442 +```bash
443 +test -s /home/me/Workspace/dotfiles/yazi/flavors/nugu-dark.yazi/flavor.toml && \
444 +test -s /home/me/Workspace/dotfiles/yazi/flavors/nugu-light.yazi/flavor.toml && \
445 +echo ok
446 +```
448 +Expected output:
450 +```text
452 +```
454 +- [ ] **Step 6: Commit Nugu generator**
456 +Run:
458 +```bash
459 +cd /home/me/Workspace/dotfiles
460 +git add nugu/yazi.nu nugu/justfile yazi/flavors/nugu-dark.yazi/flavor.toml yazi/flavors/nugu-light.yazi/flavor.toml
461 +git commit -m "feat: generate yazi nugu flavors"
462 +```
464 +Expected: commit succeeds.
466 +---
468 +### Task 3: Add base Yazi config files
470 +**Files:**
471 +- Create: `/home/me/Workspace/dotfiles/yazi/theme.toml`
472 +- Create: `/home/me/Workspace/dotfiles/yazi/yazi.toml`
473 +- Create: `/home/me/Workspace/dotfiles/yazi/keymap.toml`
474 +- Create: `/home/me/Workspace/dotfiles/yazi/init.lua`
476 +- [ ] **Step 1: Create `yazi/theme.toml`**
478 +Write this file:
480 +```toml
481 +[flavor]
482 +dark = "nugu-dark"
483 +light = "nugu-light"
484 +```
486 +- [ ] **Step 2: Create `yazi/yazi.toml`**
488 +Write this file:
490 +```toml
491 +# A TOML linter such as Tombi can use this schema to validate your config.
492 +#:schema https://yazi-rs.github.io/schemas/yazi.json
494 +[mgr]
495 +show_hidden = true
496 +sort_by = "natural"
497 +sort_dir_first = true
498 +linemode = "none"
500 +[opener]
501 +edit = [
502 + { run = 'nvim %s', desc = "nvim", block = true, for = "unix" },
504 +play = [
505 + { run = 'mpv %s', desc = "mpv", orphan = true, for = "unix" },
507 +open = [
508 + { run = 'xdg-open %s1', desc = "Open", for = "linux" },
510 +extract = [
511 + { run = 'ouch d -y %s', desc = "Extract here with ouch", for = "unix" },
514 +[open]
515 +prepend_rules = [
516 + { mime = "text/*", use = [ "edit", "reveal" ] },
517 + { mime = "application/{json,ndjson,javascript,wine-extension-ini}", use = [ "edit", "reveal" ] },
520 +[plugin]
521 +prepend_fetchers = [
522 + { url = "*", run = "git", group = "git" },
523 + { url = "*/", run = "git", group = "git" },
525 +prepend_previewers = [
526 + { url = "*.md", mime = "text/markdown", run = 'piper -- CLICOLOR_FORCE=1 glow -w=$w -s=dark "$1"' },
527 + { mime = "application/{*zip,tar,bzip2,7z*,rar,xz,zstd,java-archive}", run = "ouch" },
529 +append_previewers = [
530 + { url = "*", run = 'piper -- hexyl --border=none --terminal-width=$w "$1"' },
532 +```
534 +- [ ] **Step 3: Create `yazi/keymap.toml`**
536 +Write this file:
538 +```toml
539 +# A TOML linter such as Tombi can use this schema to validate your config.
540 +#:schema https://yazi-rs.github.io/schemas/keymap.json
542 +[[mgr.prepend_keymap]]
543 +on = "l"
544 +run = "plugin smart-enter"
545 +desc = "Enter directory or open file"
547 +[[mgr.prepend_keymap]]
548 +on = "<Enter>"
549 +run = "plugin smart-enter"
550 +desc = "Enter directory or open file"
552 +[[mgr.prepend_keymap]]
553 +on = "p"
554 +run = "plugin smart-paste"
555 +desc = "Paste into hovered directory or CWD"
557 +[[mgr.prepend_keymap]]
558 +on = "f"
559 +run = "plugin smart-filter"
560 +desc = "Smart filter"
562 +[[mgr.prepend_keymap]]
563 +on = "T"
564 +run = "plugin toggle-pane min-preview"
565 +desc = "Show or hide preview pane"
567 +[[mgr.prepend_keymap]]
568 +on = "F"
569 +run = "plugin toggle-pane max-preview"
570 +desc = "Maximize or restore preview pane"
572 +[[mgr.prepend_keymap]]
573 +on = [ "c", "m" ]
574 +run = "plugin chmod"
575 +desc = "Chmod selected files"
577 +[[mgr.prepend_keymap]]
578 +on = [ "c", "D" ]
579 +run = "plugin diff"
580 +desc = "Diff selected file with hovered file"
582 +[[mgr.prepend_keymap]]
583 +on = "!"
584 +for = "unix"
585 +run = 'shell "$SHELL" --block'
586 +desc = "Open shell here"
588 +[[mgr.prepend_keymap]]
589 +on = [ "g", "w" ]
590 +run = "cd ~/Workspace"
591 +desc = "Go ~/Workspace"
593 +[[mgr.prepend_keymap]]
594 +on = [ "g", "k" ]
595 +run = "cd ~/Workspace/dotfiles"
596 +desc = "Go dotfiles"
598 +[[mgr.prepend_keymap]]
599 +on = [ "g", "n" ]
600 +run = "cd ~/Notes"
601 +desc = "Go notes"
603 +[[mgr.prepend_keymap]]
604 +on = [ "g", "y" ]
605 +run = "cd ~/.config/yazi"
606 +desc = "Go Yazi config"
608 +[[mgr.prepend_keymap]]
609 +on = [ "g", "r" ]
610 +run = 'shell -- ya emit cd "$(git rev-parse --show-toplevel 2>/dev/null || jj root 2>/dev/null || pwd)"'
611 +desc = "Go repository root"
613 +[[input.prepend_keymap]]
614 +on = "<Esc>"
615 +run = "close"
616 +desc = "Cancel input"
617 +```
619 +- [ ] **Step 4: Create `yazi/init.lua`**
621 +Write this file:
623 +```lua
624 +require("full-border"):setup { type = ui.Border.PLAIN }
625 +require("git"):setup { order = 1500 }
626 +require("yaziline"):setup { separator_style = "liney" }
627 +```
629 +- [ ] **Step 5: Remove temporary `yazi/.gitkeep` if it exists**
631 +Run:
633 +```bash
634 +cd /home/me/Workspace/dotfiles
635 +rm -f yazi/.gitkeep
636 +```
638 +Expected: command exits 0.
640 +- [ ] **Step 6: Commit base Yazi config**
642 +Run:
644 +```bash
645 +cd /home/me/Workspace/dotfiles
646 +git add yazi/theme.toml yazi/yazi.toml yazi/keymap.toml yazi/init.lua
647 +git commit -m "feat: add yazi config"
648 +```
650 +Expected: commit succeeds.
652 +---
654 +### Task 4: Install and lock Yazi plugins
656 +**Files:**
657 +- Create: `/home/me/Workspace/dotfiles/yazi/package.toml`
658 +- Generated but ignored: `/home/me/Workspace/dotfiles/yazi/plugins/`
660 +- [ ] **Step 1: Install selected plugins with `ya pkg`**
662 +Run:
664 +```bash
665 +cd /home/me/.config/yazi
666 +ya pkg add \
667 + yazi-rs/plugins:full-border \
668 + yazi-rs/plugins:toggle-pane \
669 + yazi-rs/plugins:smart-enter \
670 + yazi-rs/plugins:smart-filter \
671 + yazi-rs/plugins:smart-paste \
672 + yazi-rs/plugins:git \
673 + yazi-rs/plugins:chmod \
674 + yazi-rs/plugins:diff \
675 + yazi-rs/plugins:piper \
676 + ndtoan96/ouch \
677 + llanosrocas/yaziline
678 +```
680 +Expected:
682 +- `/home/me/Workspace/dotfiles/yazi/package.toml` exists through the live symlink.
683 +- `/home/me/Workspace/dotfiles/yazi/plugins/` exists and is ignored.
684 +- The command exits 0.
686 +- [ ] **Step 2: Verify installed plugin dirs are ignored**
688 +Run:
690 +```bash
691 +cd /home/me/Workspace/dotfiles
692 +git status --short yazi/package.toml yazi/plugins
693 +```
695 +Expected output includes `?? yazi/package.toml` and does not list individual files under `yazi/plugins/`.
697 +- [ ] **Step 3: Verify package lock lists all plugin deps**
699 +Run:
701 +```bash
702 +cd /home/me/Workspace/dotfiles
703 +for dep in \
704 + 'yazi-rs/plugins:full-border' \
705 + 'yazi-rs/plugins:toggle-pane' \
706 + 'yazi-rs/plugins:smart-enter' \
707 + 'yazi-rs/plugins:smart-filter' \
708 + 'yazi-rs/plugins:smart-paste' \
709 + 'yazi-rs/plugins:git' \
710 + 'yazi-rs/plugins:chmod' \
711 + 'yazi-rs/plugins:diff' \
712 + 'yazi-rs/plugins:piper' \
713 + 'ndtoan96/ouch' \
714 + 'llanosrocas/yaziline'; do
715 + grep -F "use = \"$dep\"" yazi/package.toml >/dev/null || { echo "missing $dep"; exit 1; }
716 +done
717 +echo ok
718 +```
720 +Expected output:
722 +```text
724 +```
726 +- [ ] **Step 4: Commit package lock**
728 +Run:
730 +```bash
731 +cd /home/me/Workspace/dotfiles
732 +git add yazi/package.toml
733 +git commit -m "feat: lock yazi plugins"
734 +```
736 +Expected: commit succeeds and `yazi/plugins/` remains untracked/ignored.
738 +---
740 +### Task 5: Validate generated Nugu and Yazi config
742 +**Files:**
743 +- Verify: `/home/me/Workspace/dotfiles/nugu/yazi.nu`
744 +- Verify: `/home/me/Workspace/dotfiles/yazi/*.toml`
745 +- Verify: `/home/me/Workspace/dotfiles/yazi/init.lua`
747 +- [ ] **Step 1: Run Nugu checks**
749 +Run:
751 +```bash
752 +cd /home/me/Workspace/dotfiles/nugu
753 +just check
754 +```
756 +Expected: `just check` exits 0 and reports Nugu color contrast results.
758 +- [ ] **Step 2: Regenerate Yazi flavors and check drift**
760 +Run:
762 +```bash
763 +cd /home/me/Workspace/dotfiles/nugu
764 +just yazi
765 +cd /home/me/Workspace/dotfiles
766 +git diff -- yazi/flavors/nugu-dark.yazi/flavor.toml yazi/flavors/nugu-light.yazi/flavor.toml
767 +```
769 +Expected: no diff.
771 +- [ ] **Step 3: Validate Yazi can print debug config**
773 +Run:
775 +```bash
776 +yazi --debug >/tmp/yazi-debug.txt
777 +head -40 /tmp/yazi-debug.txt
778 +```
780 +Expected:
782 +- Command exits 0.
783 +- Output contains Yazi debug information.
784 +- No TOML parse error appears.
786 +- [ ] **Step 4: Verify plugin restore from lock works**
788 +Run:
790 +```bash
791 +cd /home/me/.config/yazi
792 +ya pkg install
793 +```
795 +Expected: command exits 0.
797 +- [ ] **Step 5: Run dotfiles pre-commit check**
799 +Run:
801 +```bash
802 +cd /home/me/Workspace/dotfiles
803 +just pre-commit
804 +```
806 +Expected: command exits 0 with no leaked secrets or manifest failures.
808 +- [ ] **Step 6: Commit validation fixups if any**
810 +If any validation step required fixes, run:
812 +```bash
813 +cd /home/me/Workspace/dotfiles
814 +git add .gitignore desktop.symlinks fedora.symlinks x230.symlinks nugu/yazi.nu nugu/justfile yazi/theme.toml yazi/yazi.toml yazi/keymap.toml yazi/init.lua yazi/package.toml yazi/flavors/nugu-dark.yazi/flavor.toml yazi/flavors/nugu-light.yazi/flavor.toml
815 +git commit -m "fix: validate yazi nugu config"
816 +```
818 +Expected: commit succeeds only if there were fixups. If there were no changes, skip this step.
820 +---
822 +### Task 6: Smoke-test live config interactively
824 +**Files:**
825 +- Live target: `/home/me/.config/yazi`
826 +- Source: `/home/me/Workspace/dotfiles/yazi`
828 +- [ ] **Step 1: Verify live config is already symlinked**
830 +Run:
832 +```bash
833 +realpath /home/me/.config/yazi
834 +```
836 +Expected output:
838 +```text
839 +/home/me/Workspace/dotfiles/yazi
840 +```
842 +- [ ] **Step 2: Install locked plugins in live config**
844 +Run:
846 +```bash
847 +cd /home/me/.config/yazi
848 +ya pkg install
849 +```
851 +Expected: command exits 0.
853 +- [ ] **Step 3: Launch Yazi smoke session**
855 +Run:
857 +```bash
858 +YAZI_LOG=debug yazi /home/me/Workspace/dotfiles
859 +```
861 +In Yazi, verify manually:
863 +- Hidden files are visible immediately.
864 +- `~` or `<F1>` opens help and custom bindings appear.
865 +- `l` and `<Enter>` enter dirs/open files through smart-enter.
866 +- `p` runs smart-paste behavior.
867 +- `f` opens smart-filter.
868 +- `T` hides/shows preview.
869 +- `F` maximizes/restores preview.
870 +- `c m` opens chmod plugin.
871 +- `c D` opens diff plugin when a file is selected and another is hovered.
872 +- `!` opens `$SHELL` and returns to Yazi when the shell exits.
873 +- `g w`, `g k`, `g n`, `g y`, `g r` navigate to the expected directories.
874 +- Markdown files preview through glow.
875 +- Archives preview through ouch.
876 +- Git signs appear in the file list inside the dotfiles repo.
877 +- Yaziline statusline uses liney separators.
878 +- Plain full border is visible.
880 +Quit with `q`.
882 +- [ ] **Step 4: Inspect Yazi log if smoke test fails**
884 +Run:
886 +```bash
887 +tail -200 /home/me/.local/state/yazi/yazi.log
888 +```
890 +Expected: no Lua stack traces for configured plugins after any needed fixes.
892 +- [ ] **Step 5: Commit smoke-test fixes if any**
894 +If the smoke test required config changes, run:
896 +```bash
897 +cd /home/me/Workspace/dotfiles
898 +git add yazi/theme.toml yazi/yazi.toml yazi/keymap.toml yazi/init.lua yazi/package.toml yazi/flavors/nugu-dark.yazi/flavor.toml yazi/flavors/nugu-light.yazi/flavor.toml nugu/yazi.nu nugu/justfile
899 +git commit -m "fix: smoke test yazi config"
900 +```
902 +Expected: commit succeeds only if there were fixes. If there were no changes, skip this step.
904 +---
906 +### Task 7: Final repository verification
908 +**Files:**
909 +- Verify all changed files from previous tasks.
911 +- [ ] **Step 1: Check concise Git status**
913 +Run:
915 +```bash
916 +cd /home/me/Workspace/dotfiles
917 +git status --short .gitignore desktop.symlinks fedora.symlinks x230.symlinks nugu/yazi.nu nugu/justfile yazi docs/superpowers/specs/2026-05-30-yazi-nugu-dotfiles-design.md docs/superpowers/plans/2026-05-30-yazi-nugu-dotfiles.md
918 +```
920 +Expected: no unstaged changes for these paths. `yazi/plugins/` must not appear.
922 +- [ ] **Step 2: Run full dotfiles check**
924 +Run:
926 +```bash
927 +cd /home/me/Workspace/dotfiles
928 +just check
929 +```
931 +Expected: command exits 0.
933 +- [ ] **Step 3: Record final notes**
935 +If all validation passes, add a short note to the final response:
937 +```text
938 +Implemented Yazi dotfiles config with generated Nugu flavors, managed plugin lock, Yazi-native key overrides, and live symlink install. Deferred jj plugin/lazygit/bookmarks/sessions as planned.
939 +```
941 +No file change is required for this step.