Rua 是一个轻快、简洁的终端工具,它能让你通过一个交互式的、基于快捷键的菜单,来保存并快速调用你常用的 shell 命令。
- 交互式界面 (TUI): 只需输入
rua,即可打开一个清爽的交互式命令列表。按下命令对应的快捷键,即可立即填充到命令行提示符。 - 智能路径展开: 在列表中,程序会自动展示命令的完整解析路径(例如
conda会显示为C:\Users\...\conda.exe),让你始终清楚将要执行的命令。 - 简易管理: 通过简单的子命令,轻松添加、删除和列出你的命令别名。
- 跨 Shell 支持: 只需少量配置,即可在 PowerShell 和 Zsh 中无缝使用。
-
下载可执行文件: 从项目的 Releases 页面下载适用于你系统的最新预编译版本。将下载的可执行文件放置在电脑上的任意便捷位置。
-
配置你的 Shell: 为了让
rua能够将选中的命令自动填充到你的命令行提示符中,你需要在 Shell 的配置文件里添加一个小函数。- PowerShell 用户: 请遵循 scripts/pwsh.md 中的指引进行配置。
- Zsh 用户: 请遵循 scripts/zsh.md 中的指引进行配置。
Rua 的使用非常简单。
| 命令 | 描述 |
|---|---|
rua |
(无参数) 启动交互式 TUI 界面。按下快捷键来选择对应的命令,该命令会被自动填充到你的命令行中。按 Esc 键退出。 |
rua add <KEY> '<COMMAND>' |
添加一条新的命令快捷方式。快捷键 KEY 必须是单个字母或数字。示例: rua add g 'git status --short' |
rua rm <KEYs>... |
根据快捷键删除一条命令。 示例: rua rm a b c d |
rua ls |
以非交互的方式,列出所有已保存的命令及其展开后的完整路径。 |
如果你希望自行编译本项目:
- 克隆与构建:
# 克隆仓库
git clone https://github.com/2bitbit/rua.git
cd rua
# 编译 Release 版本
cargo build --release- 配置 Shell: 编译完成后,请不要忘记参考上面的“安装与配置”部分,完成对你的 Shell 的配置。
