Tools Reference¶

All CLI tools in this dotfiles setup are managed via mise or as system packages (via .chezmoidata.yaml).

Most tools are modern, Rust-based replacements for standard Unix commands (like ls, cat, grep) that offer better defaults, performance, and features. We prioritize mise for CLI utilities and system package managers for core libraries and background services.

Tool Matrix¶

Files¶

eza¶

Modern replacement for ls with sensible defaults, colors, icons, and git integration.

Aliases: - ls → eza - ll → eza -alF (long listing) - la → eza -a (show hidden) - tree → eza --tree

bat¶

A cat clone with syntax highlighting, line numbers, and git integration.

Aliases: - cat → bat --paging=never

Configuration: - Theme set via $BAT_THEME in mise.toml (currently: Dracula) - Run bat --list-themes to see options

fd¶

A simple, fast, and user-friendly alternative to find. Respects .gitignore by default.

Key Commands:

fd pattern          # Find files matching pattern
fd -e md            # Find by extension
fd -t d             # Find directories only
fd -H               # Include hidden files

Integration: Powers fzf file finding via $FZF_DEFAULT_COMMAND.

ripgrep (rg)¶

Ultra-fast recursive grep that respects .gitignore.

Key Commands:

rg pattern          # Search recursively
rg -i pattern       # Case insensitive
rg -t py pattern    # Search only Python files
rg -C 3 pattern     # Show 3 lines of context

Aliases: None (use rg directly)

fzf¶

General-purpose fuzzy finder. Integrated throughout the shell.

Key Bindings: | Binding | Action | |---------|--------| | Ctrl+T | Find files (with bat preview) | | Ctrl+R | Search command history | | Alt+C | Jump to directory (with eza tree preview) |

Configuration: Set in mise.toml via FZF_* environment variables.

yazi¶

Blazing fast terminal file manager with image preview support.

Shell Wrapper: - ya → A wrapper that automatically cds to the last directory you visited in Yazi upon exit.

Navigation¶

zoxide¶

Smarter cd that remembers your most-used directories.

Key Commands:

z foo           # Jump to most frecent dir matching "foo"
zi              # Interactive selection with fzf
z foo bar       # Jump to dir matching both "foo" and "bar"

Aliases: - j → z (quick jump) - cdi → zi (interactive)

Shell¶

Bash Baseline Policy¶

bash remains a first-class stable baseline shell (especially for servers/homelabs), with conservative behavior by design:

• Optional tool init is guarded (mise, zoxide, direnv, atuin) so startup does not fail when tools are missing.
• History defaults are tuned for safety and consistency (histappend, dedup, ignore-space, append-on-prompt).
• AI agent sessions use isolated history (~/.bash_history_agent) and disable Atuin sync in-session.

zsh remains the full interactive UX tier (plugins, rich prompt, advanced keybindings).

atuin¶

Magical shell history with sync across machines, full-text search, and statistics.

Setup: Run atuin login after install to sync history.

Key Bindings: Ctrl+R opens Atuin's fuzzy history search (overrides fzf).

Configuration: ~/.config/atuin/config.toml

tmux¶

Terminal multiplexer for persistent sessions and split panes.

Install Source: mise.toml / mise-server.toml (tmux = "latest")

Key Features: - Plugins auto-install during mise run install (non-server mode, best effort) - Auto-saves sessions every 10 minutes (via tmux-continuum) - Auto-restores on restart (via tmux-resurrect) - Synchronize Panes: Toggle with Prefix + Y (type in all panes at once). - Navigation: Seamlessly navigate between Vim splits and Tmux panes using Ctrl + h/j/k/l. - Copy/Paste UX: Intuitive copy mode (Prefix + [ then v, y/Enter) and fast paste (Prefix + p). - Nested Sessions: F12 to toggle control between local and remote sessions (via tmux-suspend). Visual grayscale feedback when suspended. - Git Status: Performant git status integration via gitmux. - FZF Integration: Prefix + Ctrl + f to manage sessions, windows, and panes. - Quick Copy: Prefix + F triggers fast copy mode (tmux-thumbs). - Smart Window Names: Windows automatically renamed based on active program (via tmux-window-name). - Better Mouse: Improved scrolling and mouse behavior (via tmux-better-mouse-mode). - Mode Indicator: Visual indicator in status bar for Prefix/Copy/Sync modes. - Smart Detach: Closing a session switches to the next active session instead of exiting (detach-on-destroy). - Auto-Attach Policy: Deliberately opt-in (not enabled by default) to avoid breaking IDE/CI/non-interactive shells. - TPM for plugin management

Configuration: ~/.tmux.conf

welcome¶

This setup uses a curated set of tools to provide a premium, modern terminal experience.

Features: - Weather: Fetches conditions from wttr.in with 30-minute caching for fast startup. - Daily Quote: Hybrid system with embedded fallback quotes + async API fetching from ZenQuotes. - Visuals: Rainbow output via lolcat when available (emoji separated to render correctly). - Performance: Cached data means instant display on subsequent shells.

Usage: Runs automatically on new shell. Open a new terminal or run exec zsh to see it.

Git¶

lazygit¶

Simple terminal UI for git commands.

Aliases: lg → lazygit

gitmux¶

Git status information for your tmux status bar. Highly configurable and performant.

Configuration: ~/.gitmux.conf (managed via dot_gitmux.conf)

delta¶

Beautiful syntax-highlighted diffs for git.

Configuration: Set as git pager in .gitconfig and used by chezmoi diff for visual reviews.

[core]
    pager = delta

difftastic¶

Structural diff tool that compares code based on syntax, not lines.

Usage: - git dft → Open changes in difftastic - difft file1.js file2.js → Compare two files explicitly

git-absorb¶

Automatically manage fixup commits. It inspects your uncommitted changes and identifies the correct base commit to create a fixup for.

Aliases: - gabs → git-absorb

git-standup¶

Recall what you did since the last working day across all your repositories.

Aliases: - gsu → git-standup

tig¶

An ncurses-based text-mode interface for Git. Fast and powerful history browser.

Aliases: - ti → tig

git-extras¶

A collection of 60+ high-quality Git utilities.

Availability: - Installed from system packages on Debian/Ubuntu workflows - Not installed by default on Arch bootstrap path

Key Commands: - gsum → git summary (Repo stats) - geff → git effort (Commits per file) - git obliterate → Hard-delete a file from history

gh¶

The official GitHub CLI.

Key Commands: - gh pr list / gh pr checkout - gh repo clone - gh issue list

Editor¶

neovim¶

Hyperextensible Vim-based text editor.

Aliases: v, vi, vim, nv → nvim

Editor env policy: - EDITOR, VISUAL, GIT_EDITOR, and SUDO_EDITOR prefer nvim when available. - Fallback order: vim → vi → nano.

Configuration: ~/.config/nvim/init.lua

Key Plugins: - Lazy.nvim: Plugin manager - Telescope: Fuzzy finder (<leader>ff, <leader>fg) - Treesitter: Syntax highlighting - Which-Key: Keybinding popup helper - Gitsigns: Git integration in gutter - Nvim-Surround: Manage surrounding characters - Nvim-Autopairs: Auto-close brackets - Vim-Tmux-Navigator: Seamless tmux integration - Tokyonight: Theme - Flash: Fast navigation to any word/char. Press s, type 2 chars, jump anywhere. - Oil: Edit the filesystem like a normal buffer. Press - to open parent directory. Supports copy/move/rename/delete via normal vim commands. - Persistence: Automated session management. Restore with <leader>qs.

System¶

btop¶

Beautiful resource monitor with mouse support.

Smart Wrapper: top and htop without arguments launch btop.

procs¶

Modern replacement for ps with color output and tree view.

Smart Wrapper: ps without arguments launches procs.

Aliases: p → procs

duf¶

Disk usage utility with better output than df.

Smart Wrapper: df without arguments launches duf.

Aliases: d → duf

dust¶

More intuitive version of du written in Rust.

Smart Wrapper: du without arguments launches dust.

Aliases: dt → dust

ncdu¶

NCurses Disk Usage - an interactive disk usage analyzer with an ncurses interface.

Smart Wrapper: du without arguments launches ncdu (when installed, overrides dust).

Key Features: - Navigate with arrow keys - Press d to delete files/directories - Press n to sort by name, s by size

glances¶

Cross-platform system monitor with more metrics than htop: CPU, memory, disk I/O, network, containers, sensors.

Aliases: - gla → glances - glw → glances -w (web server mode at http://localhost:61208)

Key Features: - Container monitoring (Docker/Podman) - Sensor data (temperatures, fans) - Export to various formats - Web UI and API

Utils¶

jq¶

Lightweight and flexible command-line JSON processor.

Key Commands:

cat file.json | jq .           # Pretty print
cat file.json | jq '.key'      # Extract field
cat file.json | jq '.[] | .id' # Extract from array

gron¶

Makes JSON greppable by flattening it to discrete assignments. Pipe through grep, then unflatten.

Aliases: - jg → gron (flatten JSON) - jgu → gron --ungron (unflatten back to JSON)

Key Commands:

curl -s api.example.com | gron | grep "user"    # Find user fields
cat data.json | gron | fgrep "foo" | gron -u    # Filter and reconstruct

lnav¶

The Log File Navigator - an advanced log file viewer with syntax highlighting, filtering, and SQL queries.

Aliases: - logs → lnav - syslog → sudo lnav /var/log/syslog - authlog → sudo lnav /var/log/auth.log

Key Features: - Auto-detects log formats (syslog, Apache, nginx, etc.) - Live tailing with syntax highlighting - SQL queries on log data - Timeline view and filtering

visidata¶

Terminal spreadsheet multitool for exploring and manipulating tabular data (CSV, JSON, SQLite, Excel).

Aliases: - vd → visidata

Key Commands: - Shift+F → Frequency table (histogram) - [ / ] → Sort ascending/descending - Ctrl+H → Help menu

sd¶

Intuitive find & replace CLI (simpler than sed).

Key Commands:

sd 'old' 'new' file.txt        # Replace in file
echo 'hello' | sd 'l' 'L'      # Replace in stdin
sd -F 'literal.string' 'new'   # Fixed string (no regex)

tealdeer (tldr)¶

Fast tldr client for simplified command help.

Aliases: help → tldr

Key Commands:

tldr tar                       # Quick tar examples
tldr --update                  # Update tldr cache

lolcat¶

Rainbow coloring for text.

Usage:

echo "Hello" | lolcat

rsync¶

Fast, versatile, remote (and local) file-copying tool.

Aliases: - cpv → rsync -ah --info=progress2 (Copy with progress bar and statistics)

mosh¶

Remote terminal application that allows roaming, supports intermittent connectivity, and provides intelligent local echo.

Usage: - mosh user@host → Connect to server (requires mosh-server on remote)

direnv¶

Load/unload environment variables based on directory.

Usage: Create .envrc in project directory:

export DATABASE_URL="..."

Then run direnv allow to enable.

autossh¶

Automatically restart SSH sessions and tunnels.

Usage:

autossh -M 0 -f -N -L 8080:localhost:80 user@host

sshfs¶

Mount remote filesystems via SSH.

Usage:

mkdir ~/remote
sshfs user@host:/path/to/remote ~/remote

ssh-audit¶

Tool for SSH server auditing.

Usage:

ssh-audit example.com

Containers¶

lazydocker¶

Simple terminal UI for Docker and docker-compose.

DevOps & CI¶

pre-commit¶

Framework for managing and maintaining multi-language pre-commit hooks.

sops¶

Simple and flexible tool for managing secrets.

markdown-link-check¶

Checks markdown files for broken links. Used in CI and mise run validate-links.

usage¶

Specification for CLI command usage, used by mise for autocompletion.

Aliases: ld → lazydocker

dive¶

A tool for exploring Docker image layers and discovering ways to shrink image size.

Key Features: - Layer Visualization: Shows what's in each layer - Wasted Space: Identifies overwritten files and wasted space

Usage:

dive <image-tag>

hadolint¶

A smarter Dockerfile linter that helps you build best practice Docker images using AST parsing.

Usage:

hadolint Dockerfile

welcome.zsh¶

Smart caching script for terminal welcome message. Features weather (30-min cache) and hybrid quotes (embedded + API) with rainbow output via lolcat.

Languages¶

node¶

JavaScript runtime. Corepack is enabled automatically for pnpm/yarn support.

python¶

Python runtime managed by mise.

Aliases: pip → uv pip (uses uv for faster package management)

pnpm¶

Fast, disk space efficient package manager.

bun¶

Fast all-in-one JavaScript runtime.

Dotfiles¶

chezmoi¶

Cross-platform dotfile manager with templating, encryption, and multi-machine support.

Commands (via dots cz): - dots cz apply (or dots cz a) → Apply changes - dots cz diff (or dots cz d) → Show diff - dots cz edit (or dots cz e) → Edit dotfile - dots cz reinit (or dots cz r) → Re-init (when template changes) - dots cz status (or dots cz s) → Show status - dots cz <cmd> → Run any chezmoi command

Enhanced Features: - Visual Diffs: Integrated with delta for beautiful code reviews (chezmoi diff). - Auto-Sync: Automatically commits and pushes changes on apply. - Secret Detection: Templated logic automatically enables age encryption if a key is found.

Configuration: ~/.config/chezmoi/chezmoi.toml (Generated via .chezmoi.toml.tmpl)

age¶

Modern file encryption tool, simpler than GPG. Used by chezmoi for encrypted secrets.

Setup: mise run setup-secrets generates a key and encrypts ~/.secrets.

Key Location: ~/.config/chezmoi/key.txt (back this up!)

Git Hooks¶

shellcheck¶

Static analysis tool for shell scripts. Catches common errors and style issues.

Usage:

shellcheck script.sh      # Lint a script
shellcheck -x script.sh   # Follow sources

Smart Wrappers¶

Design Philosophy¶

Modern tools often provide beautiful, interactive output (TUIs) that is great for humans but breaks scripts or muscle memory when arguments are involved.

We use a "2-Pronged Approach" to get the best of both worlds without breaking standard tools: 1. No Arguments → Run the Modern Tool (Interactive/Pretty) 2. With Arguments → Run the Standard Tool (Script-safe/Flag-compatible)

Implemented Wrappers¶

Direct Access: Use short aliases (p, d, dt) to always force the modern tool regardless of arguments.

See dot_aliases for the implementation logic.

Shell Ergonomics & Polish¶

Several visual and functional tweaks make the shell feel more premium:

Magic Enter¶

Pressing Enter on an empty prompt triggers a "heartbeat" action: - Lists files in the current directory (eza). - If in a git repository, shows a concise summary of the git status (git status -sb).

Colored Man Pages¶

Man pages are piped through bat for syntax highlighting via colored-man-pages: - man [command] will now show colored output with a pager. - cat -H (globally via alias H) allows you to colorize help output: grep --help H

Interactive Git (Forgit)¶

Interactive git commands powered by FZF (via wfxr/forgit): - fga → Interactive git add - fgd → Interactive git diff - fglo → Interactive git log - Note: Standard ga and gd aliases are preserved; forgit is accessed via the f-prefixed aliases.

Better Vi Mode¶

Enhanced Vi emulation via jeffreytse/zsh-vi-mode: - Visual Indicators: Cursor shape changes (Beam = Insert, Block = Normal). - Text Objects: Support for advanced vim motions (e.g., ci" to change inside quotes). - Clipboard: Better integration with system clipboard.

Shell Intelligence¶

• Fast Syntax Highlighting: Real-time syntax highlighting as you type, optimized for speed.
• Autopair: Intelligently auto-closes and deletes matching delimiters (quotes, brackets, etc.).
• Zsh Completions: Extensive library of tab completions for tools not covered by default Zsh.
• You Should Use: Unobtrusive reminders when you type a command that has an alias (via zsh-you-should-use).
• Auto Notify: Desktop notifications for commands taking > 60s (via zsh-auto-notify).

Enhanced FZF & FZF-Tab¶

• FZF Tab Completion: Pressing Tab now uses FZF to select files/flags/commands instead of the standard grid menu.
• Improved Layout: FZF menus use a top-down reverse layout with borders and inline info.
• Cycling: Lists wrap around from top to bottom.

History Navigation¶

• Up / Down arrows are bound to substring search. Type git clo and hit Up to find the last clone command.

Clipboard Integration¶

• copy → Uses unified clipboard helper to copy stdin to system clipboard.
• cbpaste → Uses unified clipboard helper to print clipboard contents.
• copyline → Copies the current directory path.
• clipboard backend → Shows detected clipboard backend (xclip, wayland, macos, wsl, win32yank).

Quick Navigation Aliases¶

• gcl → Clone a repo and immediately cd into it.
• dot → Jump to your $DOTFILES_DIR (~/repos/dotfiles).
• gr → Jump to the root directory of the current git repository.
• update → Unified command to update system packages, mise tools, and zsh plugins.
• weather → Instant weather report (defaults to Kingston, accepts location arg).
• week → Prints the current ISO week number.
• path → Prints your $PATH one entry per line for easy reading.
• x → Universal extractor (extracts tar, gz, zip, etc. based on extension).
• take <dir> → Create directory and enter it (mkdir -p && cd).
• lt → Lite Tree (eza tree view limited to 2 levels). Also lt1, lt3.
• ips → Quick local IP address.

• hr → Prints a horizontal rule line.

• jj → Paste clipboard and pretty-print as JSON.

• bak <file> → Quickly backup a file to filename.bak.
• fsub <find> <replace> → Global find/replace in logical files (uses rg + sd).
• killport <port> → Find and kill the process listening on a specific port.
• pubkey → Copies your SSH public key (id_ed25519.pub or id_rsa.pub) to the clipboard.
• genpass / genphrase → Generate secure passwords/passphrases using Bitwarden.
• zbench → Benchmark shell startup time.
• glog → Beautiful one-line git graph.
• numfiles → Count files recursively in the current directory.
• w → Better which (uses type -a to show aliases/functions).
• gpf → Safe force push using --force-with-lease.
• gbclean → Delete all local branches merged into main/master.
• gsearch <string> → Search commit history for a specific string (pickaxe).

Script Debugging¶

• debug → Enable shell tracing (set -x).
• undebug → Disable shell tracing (set +x).

VSCode/Antigravity Integration¶

Optimized aliases for users doing AI coding primarily in VSCode or Google Antigravity (not terminal-based AI tools).

IDE Integration¶

• c / c. → Open current directory in VS Code.
• browse → Open URL in Windows browser (WSL only, requires wslu).

Git Safety Net¶

When AI agents make rapid changes, protect your work: - stash → Save current work with timestamped message ("Before AI work 14:30"). - pop → Restore stashed work. - nuke → Nuclear rollback: Discard ALL uncommitted changes and untracked files. - snap → Quick checkpoint commit ("AI: Checkpoint (WIP)"). - snapundo → Undo last checkpoint but keep changes staged.

Quick Code Search¶

When AI breaks something and you need to find where: - f <pattern> → Quick ripgrep search. - ff <literal> → Fixed string search (no regex). - fz → Interactive file finder with preview.

Environment Check¶

• aienv → Show which AI-related API keys are configured (values hidden).

AI & Agentic Workflows¶

Context-sharing tools for AI agents (Claude, Gemini, Copilot, Antigravity). These bridge the gap between your terminal and the AI.

Context Generation¶

• aibrief [file] → Generate AGENTS.md with directory tree, file list, and conventions template.
• ctx → Print project context (PWD, tree, git status) to terminal.
• ctxcopy → Copy context to clipboard for pasting into AI chat.

Session Management¶

• tm [session] → Open/attach tmux session (main by default).
• tml → List tmux sessions.
• tms [session] → Fuzzy-switch to existing session, or open/create named session.
• tmk [session] → Fuzzy-pick and kill a session, or kill named session.
• ai → Open/attach persistent tmux session named "ai".
• aicopy → Copy entire tmux pane history to clipboard.

Output Capture¶

• out <cmd> → Run command and save output to /tmp/last-output.txt.
• lastout → View last captured output.
• lastcopy → Copy last captured output to clipboard.

Review & Quality Control¶

• gdr → Review staged changes with syntax highlighting.
• gdp → Review last commit with syntax highlighting.
• greview → Interactive FZF-based review of changed files.
• gdd / gwhat → Quick diff summaries.

onefetch¶

Git repository summary on your terminal.

Aliases: repo → onefetch

usage¶

A tool for defining CLI interfaces. Used by mise to generate rich help output for the task scripts (doctor, install, update).

Features: - Enables --help flags for mise tasks. - Static analysis of CLI arguments and flags.

hyperfine¶

Command-line benchmarking tool with statistical analysis.

Usage: - hyperfine 'command1' 'command2' → Compare two commands - hyperfine --warmup 3 'command' → Warm cache before benchmark - hyperfine --export-markdown results.md 'command' → Export results

Integration: Powers mise run perf and zbench.

uv¶

Extremely fast Python package manager (10-100x faster than pip).

Aliases: pip → uv pip

Usage: - uv pip install package → Install package - uv venv → Create virtual environment - uv run script.py → Run script with dependencies

glow¶

Terminal-based Markdown reader with TUI browser.

Aliases: md → glow, readme → glow README.md

Usage: - glow → Browse Markdown files in current directory - glow README.md → View specific file - glow github.com/user/repo → Fetch and display GitHub README

git-cliff¶

Changelog generator from conventional commits.

Aliases: changelog → git cliff -o CHANGELOG.md

Usage: - git cliff → Generate changelog to stdout - git cliff -o CHANGELOG.md → Write to file

navi¶

Interactive cheatsheet tool.

Usage: - navi → Browse cheatsheets interactively - navi --print → Print command to stdout - navi --query "git" → Query specific cheats

yq¶

Portable command-line YAML processor (jq for YAML).

Aliases: yq → yq -C (Force color output)

Usage: - yq '.key' file.yaml → Extract value - cat file.yaml | yq → Pretty print

trash-cli¶

Command line interface to the trashcan (Cross-platform).

Aliases: t → trash

Usage: - trash foo.txt → Move to trash - trash --help → Show usage

tokei¶

Blazing fast code statistics (Count Lines Of Code).

Aliases: cloc → tokei

Usage: - tokei → Analyze current directory - tokei src/ → Analyze specific directory

curlie¶

curl with httpie-like syntax highlighting and formatting.

Usage: Use curlie directly alongside curl. Both commands coexist independently.

Zsh Plugins¶

fast-syntax-highlighting¶

Highly optimized, feature-rich syntax highlighting fork. Optimized for speed and correctness, especially with long command lines and nested expansions.

Features: - Speed: ~30-50% faster than the standard highlighter. - Themes: Supports various color themes (e.g., fast-theme). - Accuracy: Better handling of strings, here-docs, and complex parameter expansions.

zsh-autopair¶

A simple plugin that auto-closes, deletes, and skips over matching delimiters intelligently.

Features: - Auto-close: Inserts matching pairs (brackets, quotes) as you type. - Auto-delete: Deletes the matching pair when you backspace. - Expansion: Automatically expands spaces between brackets (e.g., [ | ]).

zsh-vi-mode¶

Superior vi-mode for Zsh.

Features: - Better Visual Mode: Works like Vim. - Text Objects: ci" to change inside quotes works. - Surround: S" to surround selection with quotes.

forgit¶

Interactive git interface powered by fzf.

Aliases: - fga → git add (interactive) - fgd → git diff (interactive) - fglo → git log (interactive) - fgi → git ignore generator

zsh-you-should-use¶

Reminds you when you type a command that you have an alias for.

Example:

> git status
Found existing alias for "git status". You should use: "gs"

colored-man-pages¶

Adds syntax highlighting to man pages (using less termcap settings, or bat if configured via H alias). Also adds eman <command> to open man pages in your editor.

zsh-auto-notify¶

Sends a desktop notification when a command takes longer than a set time (default: 20 seconds).

Features: - Automatic: No setup required. - Configurable: Exclude programs, change threshold ($AUTO_NOTIFY_THRESHOLD). - Background: Works even if the terminal is hidden/backgrounded.

Windows Tools (Provisioning)¶

These tools are managed via mise-tasks/setup/provision/windows/install.ps1 using Winget.

Windhawk¶

Modular customization for Windows. The modern successor to 7+ Taskbar Tweaker. Includes "tweaks" for taskbar, file explorer, and UI logic without modifying system files.

Sniffnet¶

Rust-based network traffic monitor. Provides a beautiful real-time dashboard of network activity and helps identify apps phoning home.

Beekeeper Studio¶

Modern, cross-platform SQL client for MySQL, Postgres, SQLite, and more. Provides a premium GUI experience for database management.

HWiNFO¶

Professional hardware analysis and monitoring tool. Provides deep sensor data for CPU, GPU, and system temperatures/voltages.

Playnite¶

Unified open-source video game library manager that unifies collections from Steam, Epic, GOG, and others.

Rufus¶

The standard utility for creating bootable USB drives. Essential for OS installation and system recovery.

PowerShell Productivity¶

These modules are managed via mise-tasks/setup/provision/windows/install.ps1 from the PowerShell Gallery.

posh-git¶

Integrates Git status information directly into your PowerShell prompt.

Features: - Shows current branch, status (staged/unstaged/untracked), and ahead/behind counts. - Improves tab completion for git commands.

Terminal-Icons¶

Adds file and folder icons to ls-style output in PowerShell, similar to eza on Unix.

Aliases: - ll → ls (now with icons)

PSScriptAnalyzer¶

The official static analysis tool for PowerShell. Checks scripts against best practices and rules. Used for automated testing and linting of the provisioning scripts.

PowerShell Profile¶

Our managed PowerShell profile (dot_config/powershell/profile.ps1) provides several Unix-like ergonomic improvements on Windows:

Key Aliases: - ll → ls (with icons) - grep → Select-String - pro → Open profile in $env:EDITOR (defaults to nvim when available) - reload → Source the profile

Features: - History Prediction: Interactive PSReadLine history in ListView mode. - Intelligent Prompt: posh-git integration for persistent context. - Editor Env Vars: Sets EDITOR, VISUAL, GIT_EDITOR, and SUDO_EDITOR with nvim-first fallback.

PowerToys Run Plugins¶

Installed manually (listed in mise-tasks/setup/provision/windows/packages.toml): - Plugin Manager: Install other community plugins directly from the launcher. - ProcessKiller: Kill processes instantly via Alt+Space -> kill chrome. - Winget: Install and search for Winget packages directly from the launcher. - VSCode Workspaces: Open any VSCode workspace or folder instantly.

tinty¶

Theme manager using the Base16 ecosystem.

parallel¶

Build and execute shell command lines from standard input in parallel.

watchexec¶

Executes commands in response to file modifications.