Custom Commands
This setup ships small, purpose-built commands into ~/bin. Anything named home/exact_bin/executable_,name becomes a command called ,name; larger commands keep that public launcher and put private implementation files under ~/lib/,name/.
How to discover them
ls -1 "$HOME/bin" | rg '^,'
command -v ,w
,w --help
The fastest visual entry point is the tmux command palette: prefix + r. It indexes comma commands, tmux bindings, git aliases, and optional drop-in entries.
Command families
| Family | Use it for | Details |
|---|---|---|
| Health and readiness | ,doctor, ,kbn-pr-audit | High-leverage commands |
| AI and agents | ,ai, ,agent-memory, ,artifact, ,ai-kb, provider wrappers | Command catalog, AI & assistants |
| Worktrees and GitHub | ,w, ,gh-worktree, ,gh-prw, ,gh-issuew, ,gh-tfork | High-leverage commands, Worktrees |
| Patch/file transfer | ,wh, ,add-patch-to-prs | High-leverage commands |
| tmux helpers | ,tmux-run-all, ,tmux-lowfi | High-leverage commands, Tmux |
| Search and discovery | ,grepo, ,fuzzy-brew-search, ,search-gh-topic, ,youtube-search | Command catalog |
| Testing and analysis | ,jest-test-title-report, ,get-risky-tests, ,get-age-buckets, ,generate-git-sandbox | Command catalog |
| Utility / plumbing | ,bat-preview, ,fzf-*, ,history-sync, media helpers | Command catalog |
Source and coverage contract
| Surface | Source |
|---|---|
| Commands | home/exact_bin/ |
| Fish completions | home/dot_config/fish/completions/ |
| Command internals | home/exact_lib/exact_,<name>/ |
| Shared command libs | home/exact_lib/exact_shared/ |
| Catalog diagram | .mermaids/07c-bin-commands.mmd |
| Surface verifier | scripts/verify_bin_surface.py |
New ~/bin commands must have a Fish completion, docs coverage, and .mermaids/07c-bin-commands.mmd coverage. Large or multi-module commands should move internals to home/exact_lib/exact_,<name>/; shared helpers belong under home/exact_lib/exact_shared/. make verify-bin-surface checks that command-library directories are not orphaned.