.dotfiles

Add, update, or remove a tool managed by mise in this dotfiles repository, including category placement and version pinning in configs/tools/mise/conf.d. Use when the user says "add ripgrep", "install lazygit", "add terraform", "bump node", asks which category a tool belongs in, or wants to remove a mise-managed tool.

Scaffold a new tool configuration into this dotfiles repository — create the config under configs/, register the symlink in scripts/setup/symlinks.conf, and verify it. Use when the user wants to add config for a new tool, e.g. "add starship config", "set up delta config", or "add lazygit config".

Diagnose shell, terminal, and tooling issues in this dotfiles setup. Use when the user reports a problem like "my shell is slow", "colors are wrong", "completions do not work", "tmux keybindings broken", or "mise not loading".

Run a comprehensive health check on the dotfiles setup and produce a status report. Use when the user asks "is everything working?", "check my setup", "dotfiles doctor", or wants a general health report.

Explain what a configuration file does in plain language and flag what is safe to remove. Use when the user asks "what does this config do?", "explain my tmux config", or "what can I remove from .zshrc".

Replace one tool with another across the entire dotfiles setup. Use when the user wants to swap a tool for an alternative, e.g. nvm to mise, oh-my-zsh to antidote, vim to neovim, grep to ripgrep, or cat to bat.

Create a new POSIX-compliant shell script for this dotfiles repository following the required platform-detection and shellcheck patterns. Use when the user wants to add a script to scripts/ (install, setup, or utility) or any .sh file outside configs/, or needs a refresher on the required script patterns.

Validate POSIX compliance of shell scripts in this dotfiles repository and run shellcheck. Use when the user asks to check POSIX compliance, lint shell scripts, or before committing changes to .sh files in scripts/ or lib/.

Run and interpret the test and validation suite for this dotfiles repository. Use when the user wants to test changes ("run the tests", "validate my changes"), after modifying shell scripts, symlinks.conf, install.sh, or platform.sh, or when a CI workflow fails and they want to reproduce it locally.

Audit dotfiles for security issues and hardening opportunities, scanning for secrets and unsafe patterns. Use when the user asks to check security, audit configs, or before sharing or publishing dotfiles.

Check cross-platform (Linux and macOS) compatibility after config or script changes. Use when the user edits a config and wants to verify it works on both platforms, or adds a tool or script that may have platform-specific behavior.