Runx 技能工作流运行时
让 Agent 技能在明确授权下执行,并为每次运行留下可验证记录。
- 源仓库
- runxhq/runx
- Star 数
- ★ 104
- 最近更新
- 1 天前
- License
- Apache-2.0
- 主语言
- Rust
- FA 评分
- 82/100 · 表现良好
30 秒速览
- 运行形态
- 可在哪里用
- 通用 · 跨平台Codex · Claude Code(部分支持)
- 费用
- 免费,无需付费服务
- 上手难度
- 中 · 需要几步配置
- 开始前需要
- 典型场景
- 工程团队通过
github-issue-to-pr将有界的代码计划接入仓库工作流,并保留运行收据。 - 不适合
- 需要操作系统级隔离来限制本地进程的团队
- 需要运行时替人验证审批者身份的团队
- 官网
- runx.ai ↗ 来自 GitHub 仓库设置
- 维护状态
- 近 30 天有提交最近提交 2026-11-20最新版本 cli-v0.11.1(2026-11-02)
- 源码审查
- 82/100 · 表现良好
这个 Agent 能做什么,适合哪些场景?
Runx 是一个用 Rust 编写的技能工作流运行时,提供 CLI、MCP 服务器以及 TypeScript/Node.js 和 Python 客户端。技能以包含 SKILL.md 的可移植包定义;需要执行步骤时,可用 run.yaml 声明输入输出、能力和方法。运行时在调用边界检查授权、交付凭据、监督执行,并以 Ed25519 签署收据,记录执行、授权和产物来源。执行、状态与签名可在本地运行,托管注册表、凭据托管和公证服务均为可选。它适合需要把多个技能串联起来并审查执行记录的团队;本地进程仍使用主机操作系统权限。
通过 runx skill 从本地目录、URL 或注册表解析技能,并按其 SKILL.md 和 run.yaml 执行方法。工作流可组合 agent、tool、operation、ask 和 skill 步骤,传递类型化输入输出;运行可以暂停以等待主机提供 Agent 答案或人工审批,再通过 runx resume 继续。连接器操作按声明的请求、范围和效果契约执行,凭据只在获准的传输边界交付。运行结束后,Runx 生成签名收据,可用 runx history 查看并用 runx verify 校验。
- 工程团队通过
github-issue-to-pr将有界的代码计划接入仓库工作流,并保留运行收据。 - 发布负责人组合 release、文档和消息技能,先准备发布材料,再按审批要求推进发布。
- 营销团队用 lead-enrichment、lead-qualify 和 cold-outreach 汇总证据并准备一封待审邮件。
- 增长团队汇总 Search Console、GA4、PostHog 和站点证据,形成优先级与后续测量计划。
- 平台团队通过 MCP 将运行中的技能轮次交给现有 Agent 主机处理,并在收到结果后恢复同一运行。
安装与配置要点
摘自下方的安装和使用说明,以项目 README 的最新说明为准。
- 安装 / 启动命令
npm install --global @runxhq/clicurl -fsSL https://runx.ai/install | sh
- 配置文件
answers.json- 运行环境
- Node.js 20
- 安装说明涉及
- macOS · Linux
如何安装或部署这个 Agent?
可用 npm 安装原生 CLI,或在 macOS/Linux 使用独立安装器。README 的本地示例还需要 Git 与 Node.js 20 或更高版本;该示例不需要 Runx 账户、模型或提供商密钥。安装器会从 runx.ai 获取内容,使用注册表、连接器或托管服务时则需相应网络和配置。
npm install --global @runxhq/climacOS/Linux 独立安装方式:
curl -fsSL https://runx.ai/install | sh如何使用这个 Agent?
克隆仓库并运行随附的 hello-world 技能。该命令会执行仓库中的 Node.js 脚本并输出 JSON 结果与收据 ID;随后可查看运行记录并验证完整收据 ID。此示例不要求模型或提供商密钥。
git clone --depth 1 https://github.com/runxhq/runx.git
cd runx
runx skill ./examples/hello-world --run-id first-run \
-i message="Hello, Runx." --json
runx history first-run --json
runx verify <receipt-id> --json若要由现有 Agent 主机处理暂停的 Agent 轮次,可为某个运行提供 MCP 服务,再提交该运行待处理请求的答案:
runx mcp --run <run-id>
runx resume <run-id> answers.json --json这个 Agent 有哪些优点和局限?
- CLI、MCP 和语言客户端共用同一 Rust 执行路径,方便接入已有 Agent 主机。
- 调用按显式授权执行,凭据在操作传输边界交付,不进入技能指令或模型上下文。
- Ed25519 收据可记录授权、执行结果、子运行链接和产物来源,并可独立验证。
- 本地执行与状态不依赖托管服务;注册表、凭据托管和公证服务可选。
- 本地进程工具以主机操作系统权限运行,Runx 不提供可移植的 OS 级隔离。
- 宿主负责取得人工决策;审批字段中的 JSON 本身不能证明审批者身份。
- 实际连接器工作需要配置账户或凭据,测试夹具不代表真实提供商执行结果。
- 最小仓库示例需要 Git 和 Node.js 20 或更高版本;完整接入还涉及技能包与权限配置。
这个 Agent 与同类方案有什么区别?
与相关度最高的同类 agent 并排比较关键指标。
| Agent | 源码审查 | 形态 / 费用 | Star | 最近更新 | 主语言 | 完整支持的平台 |
|---|---|---|---|---|---|---|
| Runx 技能工作流运行时 当前 | 82 · 表现良好 | 命令行工具免费 | ★ 104 | 1 天前 | Rust | — |
| REA 逆向工程助手 | 54 · 缺口较多 | 命令行工具免费 + 模型费 | ★ 115 | 1 个月前 | Rust | Claude Code |
| Flow-Like | 74 · 存在缺口 | 桌面应用免费版 + 付费版 | ★ 981 | 1 天前 | Rust | — |
| Agency Orchestrator:一句话组队 AI 专家团队 | 71 · 存在缺口 | 命令行工具免费 + 模型费 | ★ 2.5k | 10 天前 | TypeScript | Codex · Claude Code · OpenAI API · Claude API |
FollowAgents 如何评估这个 Agent?
查看各维度的扣分理由
材料说明权限随调用链收窄,凭据只在边界交付且收据排除原始秘密;流程、权限、数据流和外部副作用有细致说明,故这些方面得分高。审批由宿主取得,批准字段本身不能证明人的身份;进程工具以宿主操作系统权限运行且没有 OS 隔离。没有展示恢复或撤销外部副作用的完整机制,依赖安全材料也没有版本审计或漏洞状态证据,因此相应扣分。
CLI、客户端、运行时、收据和示例形成较连贯的产品描述,含结构化失败及离线验签说明。材料仍是片段,未提供依赖可用性或错误处理在运行中的证据;部分文档依赖托管服务及外部 CLI,故未给满分。
材料涵盖本地技能、工作流、MCP、客户端、托管连接器以及研究、发布和分析场景;明确列出进程工具、宿主隔离和托管服务的边界,也说明何时不该使用 Runx。对特定平台的覆盖有说明,但不能从样本确认所有环境支持,环境适配得分为2。
README、入门、凭据、安全、运行时契约等文档结构清晰;提供安装前提、命令示例、限制、Apache-2.0 许可证和滚动安全版本策略。包版本为0.0.0而 README 展示 npm 版本徽章,材料未提供清晰的变更日志或可验证维护者身份,因此命名、版本与维护责任未满分。
类型化输入输出、签名收据、授权证明和具体工作流示例使结果可供后续调用和审查,并提供了相对普通提示编排的治理与追溯价值。运行时、宿主和可选托管组件带来部署及配置成本;材料未提供成本量化,故成本效益未满分。
README 的关键声明可在安全策略、权限证明、入门文档和客户端/CLI 源码片段中交叉对应;材料区分了收据完整性、提供方真实结果和宿主身份验证的含义,也限定为本地与托管路径的不同保证。由于这是静态且不完整的样本,不能据此验证实际执行效果;本项评价的是陈述可追溯与事实/推断区分,而非运行正确性。
- 进程工具不受 Runx 的 OS 沙箱隔离;应按宿主操作系统权限审查本地命令。
- 审批记录不证明批准者身份,需由宿主负责身份认证;收据签名仅在验证者信任对应签名密钥时有意义。
- 本次审查仅基于静态文件样本,未执行项目或验证依赖、实际权限执行和外部副作用恢复。
最近版本
来自该项目 GitHub Releases 的最新发布记录,说明为上游原文摘录,未经本站改写或测试。
-
发布说明摘录
Runx CLI 0.11.1 Local registry refreshes now respect the existing record's write permissions while retaining atomic publication. This patch also updates transport dependencies and prepares distribution through the established trusted npm publisher. Highlights - A refused registry update leaves the existing record intact. - Updated MCP and HTTP dependencies retain the native execution boundary. Added - Windows coverage for atomic registry publication, retained readers, no-clobber creation and file access. Changed …在 GitHub 查看 ↗ -
发布说明摘录
Runx CLI 0.11.0 Runx 0.11.0 keeps every secret in one place, runx secret, and a connector whose credential's variable is set needs no setup at all. A name without a version runs at the newest version your runx reads, so a package published for a newer runx no longer breaks an older one. What runx adds to a project now lives under .runx, apart from the skills and connectors you write. Connectors can run as a person's signed-in browser account, and the payment skills settle through Stripe and PayPal as well as x402. Highlights …在 GitHub 查看 ↗ -
发布说明摘录
Full Changelog: https://github.com/runxhq/runx/compare/cli-v0.10.2...runx-py-v0.1.2在 GitHub 查看 ↗
常见问题
运行需要模型或 Runx 账户吗?
--drive 委托模型轮次时,需要配置模型提供商;真实连接器操作也需要相应账户或凭据。人工审批由 Runx 验证身份吗?
收据能证明什么?
可以只在本机运行吗?
Runx 技能工作流运行时 官网是什么?
Runx 技能工作流运行时 免费吗?
Runx 技能工作流运行时 开源吗?
Runx 技能工作流运行时 安全吗?
Runx 技能工作流运行时 还在维护吗?
Runx 技能工作流运行时 是谁开发的?
谢谢反馈,我们会据此改进页面。