面向 AI Agent 的 CLI 工具管理器
RXShell（rxs）
在用户目录安全安装、校验与管理精选 CLI 工具；支持多版本共存与自更新。 同时内置命令输出转 JSON 能力，方便 Agent 与脚本直接消费。
快速开始
curl -fsSL https://rxshell.com/install.sh | bash export PATH="$HOME/.rxshell/bin:$PATH" rxs doctor rxs install jq jq --version
Windows：install.ps1
· 工具源：cdn.rxshell.com
· 默认安装到 ~/.rxshell（可用 RXSHELL_HOME 覆盖）
安装程序不会自动修改系统 PATH；请按提示将 bin 加入环境变量。
功能与能力
1. CLI 工具生命周期管理
- 安装 / 卸载：从官方 CDN 按需拉取工具到用户空间，无需 root
- 多版本共存：同一工具可保留多个版本，通过
rxs use切换当前版本 - 搜索与查询：索引检索、工具元数据、解析当前二进制路径（
which） - 批量更新：将已装工具对齐到目录中的最新版本；已最新则跳过
- 自更新：
rxs update --self从官方发布通道升级rxs自身 - 环境诊断：
rxs doctor检查平台、目录、PATH、网络与信任配置
2. 面向 Agent 的接口
- 机器可读输出：全局
--json，稳定字段结构，便于 Agent 解析 - 非交互友好：适合管道与自动化；支持
-y/-q - 稳定退出码：成功 / 参数错误 / 网络错误 / 校验失败等可区分
- 检查模式：
rxs update --check只报告是否有更新，不执行安装
3. 内置命令输出转 JSON（jc 兼容）
- 无需再装独立解析器：把常见 CLI 文本输出转为结构化 JSON
- 管道模式：
dig example.com | rxs --dig - 美化 / 调用封装：
rxs --pretty dig example.com、df -h | rxs -p --df
dig example.com | rxs --dig | jq -r '.[].answer[].data' df -h | rxs -p --df rxs list --json rxs doctor --json
4. 本地布局
~/.rxshell/ bin/ # rxs 与已激活工具的入口 tools/ # 按 工具名/版本 存放的二进制 cache/ # 索引与下载缓存 state.json # 安装与激活状态
命令一览
| 命令 | 作用 |
|---|---|
| rxs install <工具> [版本] | 安装（默认 latest），校验后写入本地并激活 |
| rxs uninstall <工具> [版本] | 卸载指定版本或该工具全部版本 |
| rxs list | 列出本机已安装工具与激活版本 |
| rxs search <关键词> | 在官方目录中搜索工具 |
| rxs use <工具> <版本> | 切换当前激活版本 |
| rxs which <工具> | 打印解析后的可执行路径 |
| rxs info <工具> | 查看目录元数据与本机安装情况 |
| rxs doctor | 环境自检（平台、PATH、网络、信任） |
| rxs update [工具] | 更新已装工具到目录 latest |
| rxs update --self | 升级 rxs 自身 |
| rxs update --check | 仅检查是否有可用更新 |
| rxs --dig / --df / … | 内置将对应命令输出转为 JSON |
全局选项：--json · -y / --yes · -q / --quiet
官方工具目录（27）
一级分类：runtime（运行时）·
agent（智能体）·
cli（命令行）·
data（数据）·
base（基础设施）。
分发平台：linux-amd64 · windows-amd64 · macos-arm64（仅 Apple Silicon；Intel mac 不支持）。
例外：pup 无 mac 包（上游无 arm64）。
runtime · 运行时
| 工具 | 版本 | role | 说明 |
|---|---|---|---|
uv | 0.12.1 | toolchain | Astral uv — 高速 Python 包/项目管理器 |
bun | 1.3.14 | lang | Bun JS 运行时（锁定版本，不升级） |
node | 24.18.1 | lang | Node.js LTS（锁定 24.18.1） |
npm | 11.16.0 | toolchain | npm 包管理器（node 配套，来自 npm/cli） |
go | 1.26.5 | lang | Go 工具链（完整 GOROOT；ohmywsl2 地基） |
zig | 0.16.0 | lang | Zig 编译器（原生跨平台；ohmywsl2 地基） |
rustup | 1.29.0 | toolchain | Rust 工具链安装器（rustup-init；再装 stable） |
base · 基础设施
| 工具 | 版本 | role | 说明 |
|---|---|---|---|
age | 1.3.1 | sec | 现代文件加密（age / age-keygen；FiloSottile/age） |
vault | 1.21.4 | sec | HashiCorp Vault CLI（密钥事实源；agent 凭据分发入口） |
sing-box | 1.13.15 | net | 通用代理平台（SagerNet/sing-box） |
agent · 智能体
| 工具 | 版本 | role | 说明 |
|---|---|---|---|
claude | 2.1.220 | coding | Claude Code CLI |
codex | 0.146.0 | coding | OpenAI Codex CLI |
cli · 命令行工具
| 工具 | 版本 | role | 生态 | 说明 |
|---|---|---|---|---|
jq | 1.8.2 | json | c | JSON 处理器 |
astgrep | 0.45.0 | search | rust | AST 结构搜索与改写 |
yq | 4.53.3 | yaml | go | YAML / JSON / XML |
rg | 15.2.0 | search | rust | ripgrep（--json） |
fd | 10.4.2 | find | rust | 文件查找 |
sd | 1.1.0 | replace | rust | 查找替换 |
bat | 0.26.1 | view | rust | 语法高亮查看 |
delta | 0.19.2 | diff | rust | git / diff 高亮 |
mlr | 6.20.2 | csv | c | CSV / TSV / JSON |
qsv | 21.1.0 | csv | rust | 高性能 CSV |
gron | 0.7.1 | flatten | go | JSON 扁平化 |
dasel | 3.11.2 | multi | go | 多格式查询 |
pup | 0.4.0 | html | go | HTML + CSS |
fq | 0.17.0 | binary | go | 二进制格式查询 |
data · 数据引擎
| 工具 | 版本 | role | 说明 |
|---|---|---|---|
duckdb | 1.5.5 | olap | 嵌入式分析型 SQL（DuckDB CLI） |
base：规划中，尚未收录。
rxs search agent rxs search cli rxs search json rxs install jq rxs info jq
安全模型
- 仅 HTTPS 拉取官方源
- Ed25519 校验索引与校验和文件
- 下载后强制 SHA-256 + 体积 校验
- 无 root，全部落在用户目录
- 校验失败不保留半成品
- 默信源：
cdn.rxshell.com
退出码约定：0 成功 · 2 参数错误 · 3 网络/源错误 · 4 校验失败