zrun is a fast script manager and launcher written in Rust. Drop your .sh files in a directory, tag and describe them in-file, then pick and run them from a TUI or the CLI — with full run history tracked automatically.
Everything you need to keep your scripts organised and accessible — nothing you don't.
Drop .sh files anywhere — /etc/zrun-scripts, ~/.local/share/zrun, or any custom path. Multiple directories supported, highest-priority first.
Tag scripts right in the file header with # @tags: backup, system. Filter by tag in the TUI or with zrun list --tag backup.
Every run is recorded — script name, path, timestamp, and total run count. View history in the TUI sidebar or with zrun history.
See the full source of any script before executing it — inline in the TUI, or with zrun show <name>. No surprises.
A fast ratatui-based interactive picker with fuzzy search, tag filtering, live preview, and run-count display. Just run zrun with no arguments.
Skip the TUI entirely — zrun run <name>, zrun list, zrun show, zrun history. Scriptable, composable, fast.
No separate config file needed. Add a few comment lines to any .sh script and zrun picks them up automatically.