assh

assh

Язык: Русский | English

SSH-инструмент для LLM-агентов.

assh подготавливает SSH-доступ, открывает persistent tmux-сессию на сервере и не тащит большой вывод в контекст агента. Команды сначала возвращают компактный JSON с метаданными, а агент читает только нужные строки.

Быстрый старт

npm i -g agent-assh
assh version --check  # проверить обновления

export TARGET_PASS="..."
assh connect -H 203.0.113.10 -u root -E TARGET_PASS -n deploy
unset TARGET_PASS

Если вход по ключу уже работает, assh connect не читает TARGET_PASS.

assh connect -H 203.0.113.10 -u root -i ~/.ssh/id_agent_ed25519 -n deploy

Если есть блок с данными сервера от провайдера, сохраните его в локальный файл и дайте assh распарсить его:

assh connect-info --file server.txt -n deploy

connect возвращает session id и next_commands:

{
  "ok": true,
  "sid": "f7a2b3c4",
  "session": "deploy",
  "tmux_name": "assh_f7a2b3c4",
  "next_commands": {
    "exec": "assh session exec -s f7a2b3c4 -- \"pwd\"",
    "read": "assh session read -s f7a2b3c4 --seq 1 --limit 50",
    "close": "assh session close -s f7a2b3c4"
  }
}

Дальше работайте через session API:

assh session exec -s f7a2b3c4 -- "pwd"
assh session read -s f7a2b3c4 --seq 1 --limit 50
assh session close -s f7a2b3c4

Установка скилла assh в AI-агентов

Скилл assh обучает AI-агентов правильно использовать assh для SSH-работы. После установки агент автоматически использует assh для всех SSH-задач.

Агент	Установка
Claude Code	/plugin marketplace add izzzzzi/agent-assh затем /plugin install assh@assh
Codex	codex plugin marketplace add izzzzzi/agent-assh
Cursor	Скопировать .cursor/rules/assh.mdc в .cursor/rules/ проекта
Cline	Скопировать .clinerules/assh.md в корень проекта
Copilot CLI	copilot plugin marketplace add izzzzzi/agent-assh затем copilot plugin install assh@assh
OpenCode	Добавить "plugin": ["./.opencode/plugins/assh.mjs"] в opencode.json
Pi	pi install git:github.com/izzzzzi/agent-assh
Любой агент	Файл AGENTS.md в корне репозитория — универсальная инструкция для всех агентов

Через ctx7:

ctx7 skills install /izzzzzi/agent-assh assh

Что делает connect

assh connect:

• создаёт или переиспользует ~/.ssh/id_agent_ed25519, если не указан --identity;
• сначала пробует вход по ключу;
• использует --password-env только если вход по ключу не сработал;
• добавляет публичный ключ и проверяет повторный вход по ключу;
• проверяет capabilities сервера;
• ставит tmux неинтерактивно, если не указан --no-install-tmux;
• безопасно чистит старые доверенные assh-сессии, если не указан --no-gc;
• открывает доверенную tmux-сессию и сохраняет локальную registry metadata.

Команды

• assh connect: первый bootstrap и открытие session.
• assh connect-info: распарсить provider server-info block и подключиться.
• assh session exec|read|close|gc: persistent workflow через tmux.
• assh session ps|kill: управление процессами.
• assh session service: управление сервисами (status/restart/start/stop/logs).
• assh session exec-async|job-status|job-cancel: фоновые задачи.
• assh session docker-ps|docker-logs|docker-exec: управление Docker.
• assh session db-query: read-only запросы к MySQL/PostgreSQL.
• assh session watch: наблюдение за tmux-сессией агента человеком.
• assh exec: выполнить одну remote-команду и сохранить вывод локально.
• assh read: прочитать сохранённый вывод с пагинацией или через --raw.
• assh transfer put|get|read|list|stat|mkdir|rm|mv|sync: файловые операции и синхронизация. transfer read читает удалённый текстовый файл по ssh и возвращает output_id для постраничного assh read.
• assh forward: port forwarding (start/status/stop).
• assh fleet exec: параллельное выполнение на нескольких хостах.
• assh scan: вернуть JSON-инвентарь хоста (OS, CPU, память, диск, uptime).
• assh capabilities: проверить поддержку session workflow на сервере.
• assh key-deploy: низкоуровневая установка ключа через пароль из env.
• assh audit: читать локальный audit через --last, --host, --failed.
• assh version: вывести метаданные версии.

Экономия токенов

Сначала смотрите метаданные, потом читайте нужные окна вывода: