for Linux & macOS · CLI-first

用一句话，
操作你的系统。

RiverX 是一个命令行的系统操作助手 —— 把自然语言转成结构化的工具调用，安全、可控地完成文件、进程、配置等日常运维操作。

开始使用在 GitHub 查看

~ riverx

$ riverx

// features

八个核心工具，覆盖日常运维。

LLM 不再生成自由格式 shell 脚本，而是产出结构化的工具调用 —— 每一步都可审、可控、可中断。

read_file

读取文件内容，支持按行范围切片。

list_files

列出目录下文件，支持 glob / 排除规则。

grep

在文件树中按正则查找文本。

write_file

原子写入文件，自动创建父目录。

patch_file

基于上下文的精确编辑，避免整文件重写。

exec_cmd

受控执行 shell，超时与子孙进程组清理。

confirm

高风险操作前请求人工确认。

session

维护 REPL 上下文与多轮工具调用历史。

platforms

Linux · macOS（bash / zsh 自动适配）

llm

Qwen 优先 · OpenAI Responses API

safety

Workspace 边界 · 风险分级 · 进程组清理

// pipeline

自然语言 → 计划 → 执行。

理解意图

LLM 解析自然语言指令，识别工作区、目标对象与潜在风险。

生成计划

产出结构化的工具调用序列，而非自由 shell 脚本，可审可改。

受控执行

工具按风险等级运行，高风险触发 confirm，超时/中断回收子孙进程。

// quick start

一条命令，开始使用。

前置要求：Node.js ≥ 20、pnpm。首次运行会自动进入交互式向导，引导你选择 LLM provider 并校验 API Key。

Node ≥ 20 pnpm ~/.riverx/config.json

install.sh

# 1. 克隆并构建
$ git clone git@github.com:coderiverX/riverx-cli.git
$ cd riverx-cli && pnpm install && pnpm build

# 2. 全局安装（可选）
$ npm install -g .

# 3. 直接使用
$ riverx "列出当前目录下最大的 10 个文件"

用一句话， 操作你的系统。

八个核心工具，覆盖日常运维。

自然语言 → 计划 → 执行。

一条命令，开始使用。

让运维像聊天一样轻。

用一句话，
操作你的系统。