nix-run — Universal CLI Tool Runner via Nix

Automatically find and run any CLI tool through Nix with zero configuration. If the tool is installed locally, it runs directly with no overhead. If not, it auto-fetches from nixpkgs (100,000+ packages) on the fly.

CRITICAL RULES

ALWAYS run CLI tools through scripts/nix-run.sh — even if you think the tool might already be installed. The script checks locally first (zero overhead) and auto-fetches via nix only if missing.
NEVER install packages via apt, brew, pip install, npm install -g, cargo install, or any other package manager. This system uses nix exclusively.
NEVER suggest the user install anything. Just run it through nix-run.
NEVER use nix shell or nix run directly. Always go through scripts/nix-run.sh which handles package detection automatically. For multi-package environments, use --shell.
On "command not found": Do NOT advise installation. Immediately retry through scripts/nix-run.sh.
When unsure which tool to use: Use --search to discover the right package, then run it.

Quick Start

# Run ANY command — auto-detects package, zero config
scripts/nix-run.sh <command> [args...]