面向 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

官方工具目录（16）

预编译 CLI，签名分发。每条含功能角色（role）、实现生态（ecosystem）、分发平台（platforms）。当前均为 linux-amd64 + windows-amd64。

工具	版本	功能	生态	平台	说明
`jq`	1.8.2	json	c	linux / win	JSON 处理器
`gojq`	0.12.19	json	go	linux / win	Go 实现的 jq
`yq`	4.53.3	yaml	go	linux / win	YAML / JSON / XML
`rg`	15.2.0	search	rust	linux / win	ripgrep（支持 --json）
`fd`	10.4.2	find	rust	linux / win	现代文件查找
`sd`	1.1.0	replace	rust	linux / win	查找与替换
`bat`	0.26.1	view	rust	linux / win	语法高亮查看
`delta`	0.19.2	diff	rust	linux / win	git / diff 高亮
`mlr`	6.20.2	csv	c	linux / win	CSV / TSV / JSON
`qsv`	21.1.0	csv	rust	linux / win	高性能 CSV 工具包
`gron`	0.7.1	flatten	go	linux / win	JSON 扁平化
`dasel`	3.11.2	multi	go	linux / win	多格式查询更新
`pup`	0.4.0	html	go	linux / win	HTML + CSS 选择器
`fq`	0.17.0	binary	go	linux / win	二进制格式查询
`claude`	2.1.220	agent	other	linux / win	Claude Code CLI
`codex`	0.146.0	agent	other	linux / win	OpenAI Codex CLI

rxs search json
rxs search csv
rxs install jq
rxs info jq
rxs update --check

安全模型

仅 HTTPS 拉取官方源
Ed25519 校验索引与校验和文件
下载后强制 SHA-256 + 体积 校验

无 root，全部落在用户目录
校验失败不保留半成品
默信源：cdn.rxshell.com

退出码约定：0 成功 · 2 参数错误 · 3 网络/源错误 · 4 校验失败