English | 简体中文
Rua is a fast and simple terminal utility that allows you to save and quickly access your frequently used shell commands through an interactive, key-based menu.
- Interactive TUI: Simply run
ruato open a clean, interactive list of your saved commands.Press the shortcut key corresponding to the command to immediately fill in the command line prompt. - Smart Expansion: Displays the full, resolved path for commands (e.g.,
condabecomesC:\Users\...\conda.exe), so you always know exactly what will run. - Simple Management: Add, remove, and list your command shortcuts with straightforward subcommands.
- Cross-Shell Support: Works seamlessly with PowerShell and Zsh with minimal setup.
-
Download the Executable: Download the latest pre-compiled binary for your system from the Releases Page. Place the executable in a convenient location on your computer.
-
Configure Your Shell: To enable
ruato insert the selected command into your terminal prompt, you need to add a small function to your shell's configuration file.- For PowerShell: Follow the instructions in scripts/pwsh.md.
- For Zsh: Follow the instructions in scripts/zsh.md.
The core of Rua is simple and straightforward.
| Command | Description |
|---|---|
rua |
(No arguments) Launches the interactive TUI. Press a shortcut key to select the corresponding command, which is then inserted into your prompt. Press Esc to exit. |
rua add <KEY> '<COMMAND>' |
Adds a new command shortcut. The key must be a single alphanumeric character. Example: rua add g 'git status --short' |
rua rm <KEYs>... |
Removes a command shortcut by its key. Example: rua rm a b c d |
rua ls |
Lists all saved commands and their expanded paths without launching the interactive TUI. |
If you prefer to build the project yourself:
- Clone and Build:
# Clone the repository git clone https://github.com/2bitbit/rua.git cd rua # Build the release executable cargo build --release
- Configure Shell: Remember to follow the shell setup steps mentioned in the "Installation" section above.