Reference for all CLI tools and development preferences in jadee's dotfiles flake. Use this skill whenever helping with shell tasks, writing scripts, recommending tools, or answering "what tool should I use for X". Covers NixOS (desktop/framework) and macOS (caya). Always prefer the tools and methods here over generic alternatives. Trigger when the user is working in a terminal, asking about file operations, text processing, git, development workflows, or system administration.
For platform-specific tools, read references/nixos.md (NixOS) or references/darwin.md (macOS).
The full shared tool list is in references/shared-tools.md.
| Task | Use | Not |
|---|---|---|
| View files | bat | cat |
| Find files | fd | find |
| Search content | rg | grep |
| List files | eza -l --icons --git | ls |
| Tree view | eza -Ta | tree |
| Navigate dirs | z <dir> (zoxide) | cd |
| Disk usage | dust or dua |
du |
| Process monitor | btop | top/htop |
| JSON | jq | — |
| YAML/TOML/XML | yq | — |
| HTTP requests | xh | curl/httpie |
| Ping | gping | ping |
| Benchmark | hyperfine | time |
| Diagram | mermaid (inline in markdown) | — |
| Git TUI | lazygit | — |
| DB TUI | rainfrog | — |
| PDF tools | pdftotext, qpdf, pdftk | — |
uv — never pip, pip3, or poetryuv add <pkg> to add dependencies, uv run <script> to run, uv sync to installruff for linting and formatting (not black/flake8), ty for type checkingyarn — never npm or pnpmyarn add <pkg>, yarn dev, yarn buildbiome for linting and formatting (not eslint/prettier for JS/TS projects)bun for scripts/running when speed matters, but yarn for package managementcargo for all package management and buildsbacon for background compile-on-save watching during developmentrustup to manage toolchain versionsjust fmt (runs alejandra), never edit unformattedjust switch / just switch-fast — never bare nixos-rebuild, darwin-rebuild, or nhnix search nixpkgs <name> before addingshellcheck to lint, shfmt to formatjust for project tasks — check just --list first before running commands manuallyz <dir> — smart directory jump (zoxide)zf — jump to flake rootflake <cmd> — shorthand for just recipesf — pay-respects (suggests corrections for failed commands)gs, gl, gb, gp, ga, gc, gd, gm, gr (from fj0r/git.nu)