docs: add comprehensive documentation for AI agents, chezmoi workflow, shell setup, desktop configuration, terminal multiplexers, and developer tools

2026-11-02 11:32:42 +00:00 · 2026-09-28 11:08:17 -04:00
1 parent 41437d4abd
commit 1da988c876
@@ -0,0 +1,70 @@
+---
+title: Tools
+description: CLI and TUI tools the repo installs and configures, with the settings applied to each.
+sidebar:
+  label: Overview
+---
+
+This section covers the command-line and terminal-UI tools outside the shell, terminal, and desktop layers. Every tool here is universal: none of it is gated by machine role, so `desktop`, `laptop`, `mac`, and `server` machines all get it (see [Installation](/installation)).
+
+Packages come from `.chezmoidata/packages.yaml` and are installed by `run_onchange_before_10-packages.sh.tmpl` (pacman plus paru for the AUR on Arch, Homebrew on macOS). See [chezmoi scripts](/chezmoi/scripts).
+
+## Configured tools
+
+| Page | Tool | Source in repo | Theme |
+| --- | --- | --- | --- |
+| [Git](/tools/git) | git, delta, diffnav, git-split-diffs | `dot_gitconfig.tmpl` | delta colors hand-tuned (dark) |
+| [GitHub CLI](/tools/github-cli) | gh, gh extensions, gh-dash | `dot_config/gh/`, `dot_config/gh-dash/` | gh-dash defaults |
+| [Neovim](/tools/neovim) | nvim (AstroNvim) | external repo via `.chezmoiexternal.toml` | managed in the nvim repo |
+| [Yazi](/tools/yazi) | yazi file manager | `dot_config/yazi/` | cyberdream flavor (ii-auto and noctalia flavors shipped) |
+| [Lazygit](/tools/lazygit) | lazygit | `dot_config/lazygit/` | cyberdream colors (ii theme file shipped) |
+| [Lazydocker](/tools/lazydocker) | lazydocker | `dot_config/lazydocker/config.yml` | cyberdream colors |
+| [bat](/tools/bat) | bat | `dot_config/bat/` | cyberdream tmTheme |
+| [Topgrade](/tools/topgrade) | topgrade | `dot_config/topgrade.toml` | n/a |
+| [Hunk](/tools/hunk) | hunk diff viewer | `dot_config/hunk/config.toml` | `auto` |
+| [LeetCode](/tools/leetcode) | leetcode CLI, `lc-elir` | `dot_leetcode/` | n/a |
+
+<CardGroup cols={2}>
+  <Card title="Git" href="/tools/git" icon="git-branch">
+    Identity from chezmoi data, diff pagers, gh credential helper.
+  </Card>
+  <Card title="Yazi" href="/tools/yazi" icon="folder-open">
+    Keymap, plugins, bookmarks, and the Neovim bridge.
+  </Card>
+  <Card title="Lazygit" href="/tools/lazygit" icon="git-commit-horizontal">
+    GUI options, delta renderer, custom gh commands.
+  </Card>
+  <Card title="GitHub CLI" href="/tools/github-cli" icon="github">
+    Aliases, extensions, and the gh-dash dashboard.
+  </Card>
+</CardGroup>
+
+## Other packaged CLI tools
+
+These packages are declared in `.chezmoidata/packages.yaml` but have no config file in the repo. The "Wired in" column lists where the repo actually uses them.
+
+| Tool | Role | Wired in |
+| --- | --- | --- |
+| `fzf` | Fuzzy finder | `FZF_DEFAULT_OPTS` in `dot_config/fish/conf.d/10-env.fish` (rounded border, cyberdream colors: highlight `#5ef1ff`, pointer `#ffaecf`, marker `#5eff6c`). Used by fish functions `c2p`, `cp-appid`, `fab`, `gtm`, `mdp`, `lc-elir`, by `~/.local/bin` scripts (`gho`, `pj`, `lc-elir`), and as `fuzzy_cmd` of the yazi bunny plugin. |
+| `fd` | File finder | `c2p`, `cp-appid`, `extract_agents`, `mdp`, `lc-elir`, `conf.d/pnpm-filter.fish`. |
+| `ripgrep` | Content search | `cp-appid`, `gtm`, `gh-sonr-org-migrate` fish functions; niri focus script. |
+| `zoxide` | Frecency `cd` | `zoxide init fish` in `conf.d/40-tools.fish`; the `cd` function in fish/bash/zsh falls back to `zoxide query` when the argument is not a directory, and `ghg-clone` registers new clones. |
+| `eza` | `ls` replacement | Interactive shells alias `ls` to `eza --icons` (fish `conf.d/20-aliases.fish`, `~/.config/shell/aliases.sh`). |
+| `jq` | JSON processor | `fab`, `gtm`, `gh-sonr-org-migrate`, `pnpm-filter`, niri helper scripts. |
+| `duf` | Disk usage overview | Not referenced by any config. |
+| `btop` | Resource monitor | Waybar modules launch it on click (`omarchy-launch-or-focus-tui btop`); kitty tab bar shows an icon for it. |
+| `fastfetch` | System info | Not referenced by any config. |
+| `gum` | Shell prompts and pickers | `gdc` (confirm before `git reset --hard`), `ghn` (host and org pickers), `gtm`, `ai`, `pnpm-filter`, nvm activation messages. |
+| `glow` | Markdown renderer | Kitty tab-bar icon only. |
+| `micro` | Terminal editor | Alias `sm` = `sudo micro`. |
+| `ffmpeg`, `ffmpegthumbnailer`, `poppler`, `resvg`, `imagemagick`, `7zip`, `unzip` | Media, PDF, SVG, image, and archive backends | Grouped in the manifest as yazi preview dependencies. See [Yazi](/tools/yazi). |
+| `wget` | HTTP downloads | Not referenced by any config. |
+| `zsh-syntax-highlighting` | zsh highlighting | Sourced by the zsh setup. See [Shell](/shell). |
+| `ttf-victor-mono-nerd` / `font-victor-mono-nerd-font` | Nerd Font | Terminal font. See [Terminal](/terminal). |
+| `suvadu` | Declared under `packages.shared.cargo` | No install script reads the `cargo` list, so it is not installed automatically. |
+
+Tools with their own pages in other sections: [fish](/shell/fish), [starship](/shell/starship), and [atuin](/shell/atuin) under Shell; [kitty](/terminal/kitty) and [tmux](/terminal/tmux) under Terminal.
+
+:::note
+`diffnav` is in the Arch pacman list but not in the macOS Homebrew list, and `topgrade` comes from the AUR on Arch. See the individual pages for per-OS differences.
+:::