ryoppippi/missing-tools

Missing Tools

Use this workflow when a command is unavailable in the current shell.

Priority Order

1. Try the current project's direnv environment:

   direnv exec . <command>
   

2. Use comma for tools from nixpkgs:

   , <command>
   

   When comma may fetch from GitHub, also use the nix-github-rate-limit skill.

3. Use nix run when a specific nixpkgs package is needed:

   nix run nixpkgs#<package> -- <args>
   

   When the command may fetch from GitHub, also use the nix-github-rate-limit skill.

4. Use nix shell as the last resort:

   nix shell nixpkgs#<package> --command <command>
   

   When the command may fetch from GitHub, also use the nix-github-rate-limit skill.

Notes

• Never install missing tools globally. Do not use commands such as npm install -g, npm i -g, pnpm add -g, yarn global add, bun add -g, uv tool install, brew install, or language-specific global installers to resolve a missing command.

• Prefer direnv exec . first because project-local dev shells often already provide the right tool version and environment variables.

• Comma automatically finds and runs the nixpkgs package containing the requested command.

• Use fish for shell wrapping in this dotfiles environment:

  fish -c '<command>'