Repository navigation
Release v0.17.0
SSHX - Agent-native remote host execution over SSH
📋 What's Changed
Added
sshx ros: native MikroTik RouterOS (ROS) support strictly over standard SSH
(port 22) and SFTP protocols. No ROS API service port (8728/8729) or REST port
is required. Features include:- Command catalog mapping RouterOS paths (
ip address,ip firewall,ip route,
interface,system resource, etc.) with output parsing into structured JSON. rawcommand execution for arbitrary RouterOS API paths (e.g.sshx ros -h=host raw /system/resource/print)
with optional--rawflag to bypass output parsing.- Safety guardrails: destructive actions (
/system/reset-configuration,/system/reboot,
/certificate/reset,/disk/format) are blocked without--force, and state-altering
raw mutations are blocked without--allow-write. - Client-side dry-run: preview execution plans and mutation flags without connecting.
- SFTP configuration and file workflows:
file upload,file download,file list,
script put(with--source=@path),backup download(with--cleanup), and
export download(with--compactand--cleanup). - Introspection tools:
commands,help,schema,doctor, andexplain-error. - MCP tool
sshx_rosfor AI agent integration withexpect_plan,dry_run, and
allow_writeguardrails.
- Command catalog mapping RouterOS paths (
🚀 Quick Install
Linux / macOS:
curl -fsSL https://raw.githubusercontent.com/talkincode/sshx/main/install.sh | bashWindows (PowerShell):
irm https://raw.githubusercontent.com/talkincode/sshx/main/install.ps1 | iex📦 Downloads
| Platform | Architecture | File |
|---|---|---|
| Linux | x86_64 | sshx-linux-amd64.tar.gz |
| Linux | ARM64 | sshx-linux-arm64.tar.gz |
| macOS | Intel | sshx-darwin-amd64.tar.gz |
| macOS | Apple Silicon | sshx-darwin-arm64.tar.gz |
| Windows | x86_64 | sshx-windows-amd64.zip |
| Windows | ARM64 | sshx-windows-arm64.zip |
Verify downloads: Use checksums.txt for integrity verification