agent-ssh-cli
A command-line SSH tool for agents: remote execution, file upload and download, and command allow and block lists.
- 88 ★ on the repository
- Last commit
- MIT
Broad access
Why this level
- The agent runs commands and changes files on real servers
- The configuration holds server login data
Install
- Works in
In your terminal, with SkillFoxx CLI
npx skillfoxx add cli/agent-ssh-cliDetects the agents on your machine, shows the access level and pins the version.
Other ways to install
Access and checks
How we reviewBroad accessThe tool can change data, run commands or handle secrets.
- The agent runs commands and changes files on real servers
- The configuration holds server login data
This is third-party code. Review the repository files before installing.
What it does
agent-ssh-cli, the `agentsshcli` command, gives an agent access to SSH servers from a local configuration. The agent lists connections, runs commands on a chosen server, uploads files and downloads them back. The project follows the design of the ssh-mcp-server MCP server and is rewritten as an independent CLI. An upload first writes a temporary `<remotePath>.part` with resume metadata, renames it after a size check and continues an interrupted upload from the same place. Allowed commands are restricted with allow and block lists. Connection settings are edited in the browser: list, groups and tags, route and authentication, command rules and connection testing. A `SKILL.md` sits alongside to be added to the agent.
Who it is for. Administrators and developers who entrust an agent with deploying and maintaining their own servers over SSH.
Good fit when
- Docker containers on a server must be updated and a service restarted without a manual login.
- An agent edits nginx configuration or certificates on assignment while commands are limited by a list.
- A large file is uploaded to a server and a dropped connection must not restart the transfer.
- Several servers with groups and tags must be described in one config without an MCP server.
Not a fit when
- An AI must not get server access: the agent will run any command the lists let through.
- An MCP server is needed: this is a standalone CLI connected through `SKILL.md`.
- Operation without Node.js 18 or newer is required.
Example request
Upload the built archive to the staging server, restart the container and show the output of a command allowed by the allow list.Limitations
Needs Node.js 18 or newer and npm 8 or newer, with prebuilt packages for macOS arm64 and x64, Linux x64 and arm64 and Windows x64. The configuration sits in `~/.agent-ssh-cli/config.json` and is compatible with ssh-mcp-server; it holds real connection data, so protect the file. Daemon mode keeps a connection pool: `agentsshcli stop-daemon` stops it entirely and affects other tasks, so it is not a cancel for a single upload. The main documentation is in Chinese, and the English version is in `README_EN.md`.
How to disable. Remove the package with `npm uninstall -g agent-ssh-cli`, stop the daemon with `agentsshcli stop-daemon` and take `SKILL.md` out of the agent's skills. Delete `~/.agent-ssh-cli/config.json` with connection data by hand.
FAQ
How do I install it?
With `npm install -g agent-ssh-cli`, then `agentsshcli --help`. After that add `SKILL.md` to the agent.
Where is connection data stored?
In `~/.agent-ssh-cli/config.json`. The format is compatible with ssh-mcp-server, and it can also be edited in the browser editor.
What happens if an upload is interrupted?
The partial data stays in `<remotePath>.part`, and uploading the same file again resumes from there if the local file is unchanged.
How do I restrict commands?
With command allow and block lists in the configuration. Rules can be set in the visual editor and the connection tested.
How does it differ from ssh-mcp-server?
This is a standalone CLI with a connection pool and a browser settings editor and not an MCP server. The configuration format is compatible with ssh-mcp-server.
Discussion
No questions or reviews yet.
Related
CLI toolsMCP SSH Agent is an MCP server that reads hosts from ~/.ssh/config, runs commands and copies files through system ssh and scp.
A CLI that installs shared skills, commands, subagents, hooks and MCP servers into eight AI coding tools in their native layouts
An SSH skill for Codex and Claude Code: remote commands, file transfer and tunnels with one JSON result and replay protection.
MCP SSH Manager
mcp-ssh-manager
Managing several SSH connections from Claude Code and Codex: commands, file transfer, databases and backups
SSH MCP Server (classfang): remote commands over SSH
SSH MCP Server (classfang)
An SSH MCP server: the agent runs commands, reads and writes files over SFTP, transfers files and starts long jobs while credentials stay with you
The reach CLI points a coding agent at any machine over SSH: keys and conversation stay with you and the target installs nothing
README in short
Covers CLI capabilities, upload reliability, installation through npm and through an agent, configuration and cleanup, and the visual configuration editor.