gizmos

Build polished, sourced shell CLIs (zsh/bash functions) with a consistent house style — TTY-gated colour, glyph fallbacks, y/N confirmation prompts, dependency checks, env-var-with-fallback config, subcommand dispatch, and correct exit codes. Use whenever the user wants to create or improve a command-line tool meant to be sourced from ~/.zshrc or ~/.bashrc (a "gizmo", shell function, dotfiles utility, git helper, port killer, account switcher, updater, etc.), or asks to "add colour", "make it look like a CLI", "add a confirmation prompt", "check for a dependency", or "standardise the output" of an existing shell script. Trigger on requests to write a small CLI as a .sh file, not on application-level programs in Python/Go/Rust.

Add or update a script entry in the "gizmos" catalog README. Use whenever the user adds a new shell script (a .sh file) to their gizmos repo and wants it documented, or says things like "add this script to the readme", "catalog this cli", "update the gizmos readme", "add a section for gac.sh", or drops a script alongside the README and asks to document it. Handles reading the script, generating a standardized section, inserting it in alphabetical order, and rebuilding the table of contents to match. Trigger this even if the user only says "add this to my catalog" with a script file and doesn't mention the readme explicitly.