agent-ssh-cli

Консольный SSH-инструмент для агентов: выполнение команд, загрузка и скачивание файлов, белые и черные списки команд.

  • 88 ★ репозитория
  • Последний коммит
  • MIT
CLI

Широкий доступ

Почему такой уровень

  • Агент выполняет команды и меняет файлы на реальных серверах
  • В конфигурации лежат данные для входа на серверы
Все причины и проверки

sleepinginsummer/agent-ssh-cli

Установка

Работает в

В терминале, через SkillFoxx CLI

npx skillfoxx add cli/agent-ssh-cli

Определит агенты на машине, покажет уровень доступа и зафиксирует версию.

Другие способы установки

Доступ и проверки

Как мы проверяем

Широкий доступИнструмент может менять данные, выполнять команды или работать с секретами.

  • Агент выполняет команды и меняет файлы на реальных серверах
  • В конфигурации лежат данные для входа на серверы

Это чужой код. Посмотрите файлы в репозитории перед установкой.

Что делает

agent-ssh-cli, команда `agentsshcli`, дает агенту доступ к SSH-серверам из локальной конфигурации. Агент выводит список подключений, выполняет команды на выбранном сервере, загружает файлы и скачивает их обратно. Проект сделан по образцу MCP-сервера ssh-mcp-server и переписан как самостоятельный CLI. Загрузка сначала пишет файл во временный `<remotePath>.part` с метаданными для продолжения, после проверки размера переименовывает его, а прерванную загрузку продолжает с того же места. Допустимые команды ограничивают белым и черным списками. Настройки подключений правят в браузере: список, группы и теги, маршрут и аутентификация, правила команд, проверка соединения. Рядом лежит `SKILL.md`, который добавляют агенту.

Для кого. Администраторам и разработчикам, которые поручают агенту выкладку и обслуживание своих серверов по SSH.

Подходит, если

  • Нужно обновить контейнеры Docker на сервере и перезапустить службу без ручного входа.
  • Конфигурацию nginx или сертификаты правит агент по заданию, а команды ограничены списком.
  • Большой файл загружают на сервер, и обрыв связи не должен начинать передачу заново.
  • Несколько серверов с группами и тегами надо описать в одном конфиге, не используя MCP-сервер.

Не подходит, если

  • Доступ к серверу нельзя давать ИИ: агент выполнит любые команды, которые пропускают списки.
  • Нужен MCP-сервер: здесь отдельный CLI, подключаемый через `SKILL.md`.
  • Требуется работа без Node.js 18 или новее.

Пример запроса к агенту

Загрузи собранный архив на сервер staging, перезапусти контейнер и покажи вывод команды, разрешенной белым списком.

Ограничения

Нужны Node.js 18 или новее и npm 8 или новее, готовые сборки есть для macOS arm64 и x64, Linux x64 и arm64, Windows x64. Конфигурация лежит в `~/.agent-ssh-cli/config.json` и совместима с ssh-mcp-server, в ней хранятся реальные данные подключения, поэтому файл защищают. Режим демона держит пул соединений: `agentsshcli stop-daemon` останавливает его целиком и затрагивает остальные задачи, это не отмена одной загрузки. Основная документация написана по-китайски, английская версия лежит в `README_EN.md`.

Как отключить. Удалите пакет командой `npm uninstall -g agent-ssh-cli`, остановите демон через `agentsshcli stop-daemon` и уберите `SKILL.md` из навыков агента. Файл `~/.agent-ssh-cli/config.json` с данными подключения удалите вручную.

Частые вопросы

Как установить?

Командой `npm install -g agent-ssh-cli`, затем `agentsshcli --help`. После этого добавьте `SKILL.md` агенту.

Где хранятся данные подключения?

В `~/.agent-ssh-cli/config.json`. Формат совместим с ssh-mcp-server, а править его можно и в браузерном редакторе.

Что будет при обрыве загрузки?

Недогруженная часть остается в `<remotePath>.part`, и повторная загрузка того же файла продолжится с этого места, если локальный файл не менялся.

Как ограничить команды?

Белым и черным списками команд в конфигурации. Правила можно настроить в визуальном редакторе и проверить соединение.

Чем отличается от ssh-mcp-server?

Это отдельный CLI с пулом соединений и редактором настроек в браузере, MCP-сервера в нем нет. Формат конфигурации совместим с ssh-mcp-server.

Обсуждение

Вопросов и отзывов пока нет.

MCP SSH Agent, MCP-сервер, берет хосты из ~/.ssh/config, запускает команды и копирует файлы через системные ssh и scp.

MCP-серверШирокий доступ105Звезды репозитория

CLI ставит общие скиллы, команды, субагентов, хуки и MCP-серверы сразу в восемь ИИ-инструментов в их родных форматах

CLIРасширенный доступ91Звезды репозитория

Скилл SSH для Codex и Claude Code: команды на серверах, передача файлов и туннели с единым JSON-ответом и защитой от повторов.

СкиллШирокий доступ561Звезды репозитория

MCP SSH Manager

mcp-ssh-manager

Управление несколькими SSH-подключениями из Claude Code и Codex: команды, перенос файлов, базы данных и бэкапы. Стабильная ветка в npm, в GitHub бета 4.0

MCP-серверШирокий доступ539Звезды репозитория

MCP-сервер для SSH: агент выполняет команды, читает и пишет файлы по SFTP, передает файлы и запускает долгие задачи, а пароли остаются у вас

MCP-серверШирокий доступ1 тыс.Звезды репозитория

CLI reach направляет кодинг-агента на любую машину по SSH: ключи и диалог остаются у вас, цель ничего не устанавливает

CLIШирокий доступ219Звезды репозитория

Коротко о README

Описаны возможности CLI, надежность загрузки, установка через npm и с помощью агента, настройка и очистка, а также визуальный редактор конфигурации.

Бейдж для README

Сообщить о проблеме