Project Homepage

roswire:面向 AI Agent 的 RouterOS JSON-first CLI 桥接器

roswire 把传统“人类终端体验”改造成“机器稳定契约”——成功结果走 stdout,结构化错误走 stderr,默认非交互、默认只读, 为 Agent 自动化与 RouterOS 运维之间提供可靠的执行接口。

JSON-first 默认只读 Schema Discovery Protocol Auto Route Structured Error Single Rust Binary

稳定机器契约

不输出颜色、spinner、分页器,避免 Agent 解析噪音,强调可自动化消费的结构化输出。

协议与方言路由

自动探测 REST / API-SSL / API,并按 RouterOS v6/v7 能力选择最优调用路径。

安全默认值

默认只读与 secret 脱敏,写入动作必须显式授权,支持 dry-run 风险预演。

Agent 自描述接口

help --jsonschema commandconfig inspect 等能力让 Agent 可自我修正。

1) 安装与本机诊断

curl -fsSL https://raw.githubusercontent.com/AS153929/roswire/main/scripts/install.sh | sh
roswire doctor --json

2) 初始化与 profile

roswire config init --json
roswire config device add studio host=192.168.88.1 user=admin protocol=auto routeros_version=auto transfer=ssh --json

3) 首条只读命令

roswire --profile studio interface print --json
roswire --profile studio ip route print --json

交互式 3D 工作原理演示

通过可切换阶段的 3D 拓扑,直观理解 Agent → CLI → Schema/Profile → Protocol → RouterOS → stdout/stderr

Stage 1
Agent 发起请求