Skip to content

Toolbox

CLI tool discovery for the installed toolchain — search tools, shell functions, and aliases, and resurface the ones you've forgotten. A standalone Go project: datapointchris/toolbox is the source of truth for the full command reference (or run toolbox --help).

In this system

  • Install — packages.yml under go_tools, via go install github.com/datapointchris/toolbox@latest. The binary lands in ~/go/bin.
  • Registry — authored data, not config: owned by dotfiles and symlinked under the XDG data dir (override with $TOOLBOX_REGISTRY). Living in dotfiles means it is version-controlled and reaches every machine on git pull. Edit it to add or update tools; the entry schema is in the repo.
  • Federated by menu — menu searches the registry, shell functions, and aliases alongside workflows and skills, delegating display back to toolbox show. See Menu.
  • Rediscovery — toolbox remind surfaces a forgotten tool, function, alias, git alias, or forgit shortcut (neglect-weighted, 90-day recency). It runs on a cadence through menu review's revisit-a-tool item (show: toolbox remind --brief), not on every shell. --brief bounds the card to a few clipped lines because it renders inside that nudge; run bare, it shows the full detail view, which is the actual refresher.