assh
为 LLM 代理准备的 SSH 工作流助手:一次连接、持久 tmux 会话、按需分页读取输出,避免大输出塞满上下文。
- Star 数
- ★ 22
- 最近更新
- 11 天前
- License
- MIT
- 主语言
- Go
- FA 评分
- 65/100 · 存在缺口
30 秒速览
- 运行形态
- 可在哪里用
- 通用 · 跨平台Codex · Claude CodeChatGPT(不支持)
- 费用
- 免费,无需付费服务
- 上手难度
- 低 · 几分钟可跑通
- 开始前需要
- 典型场景
- 终端里的编码代理(Claude Code、Codex、OpenCode 等)需要在远程服务器上查看日志、重启服务,但不想把整段 journalctl 输出灌进上下文。
- 不适合
- 只想用一次 SSH 手工登录、不需要持久会话的用户
- 必须完全交互式密码提示或需要 Windows 远程主机的场景
- 需要独立签名校验发布来源的高安全团队
- 维护状态
- 近 30 天有提交最近提交 2026-11-09最新版本 v1.4.0(2026-11-09)
- 源码审查
- 65/100 · 存在缺口
这个 Agent 能做什么,适合哪些场景?
assh 是一个用 Go 编写、通过 npm 分发的 SSH 命令行工具,专门面向 LLM 代理的远程运维工作流。它的核心是 assh connect:自动创建或复用 SSH 密钥、在必要时用环境变量里的密码首次部署公钥、安装 tmux、清理旧的受信会话,然后在服务器上打开一个持久 tmux 会话并返回 session id 与 next_commands。后续所有远程操作通过 assh session exec/read/close 完成,命令先返回紧凑 JSON 元数据(rc、seq、行数),代理再按 seq 和行窗口分页读取真正需要的输出。除会话外还提供 exec/read 单命令模式、transfer 文件操作与同步、forward 端口转发、fleet exec 多主机并行执行、scan 主机盘点、audit 审计与节省统计、capabilities 能力探测,以及键值/密码安全处理与命令安全分类器。它还以技能和插件形式分发给 Claude Code、Codex、Cursor、Cline、Copilot CLI、OpenCode、Pi 等终端代理。
assh connect 使用 --identity 指定的密钥(默认 ~/.ssh/id_agent_ed25519,不存在则生成),先尝试密钥登录,失败且提供了 -E 环境变量名时才用密码部署公钥并验证二次登录;随后检查服务器 capabilities、非交互安装 tmux、清理受信旧会话,开启 assh_<sid> 的 tmux 会话并写入本地 registry。命令输出先返回 {ok, rc, seq, stdout_lines, ...} 之类元数据,assh session read --seq N --limit M 再按行分页返回 content/total_lines/has_more,--raw 输出纯文本。长任务用 exec-async 提交并通过 job-status/job-cancel 管理;transfer put|get|read|list|stat|mkdir|rm|mv|sync 处理文件;forward 管理端口转发;fleet exec 在多主机上并行执行并汇总 failed 计数;scan 返回 OS/CPU/内存/磁盘/uptime 的 JSON;audit --savings 统计被分页 withhold 的行数。所有远程命令经过 destructive 命令分类器,输出默认做密钥/令牌脱敏,--profile readonly|ops|admin 可按 ~/.config/assh/profiles.json 限制会话内可执行命令。
- 终端里的编码代理(Claude Code、Codex、OpenCode 等)需要在远程服务器上查看日志、重启服务,但不想把整段 journalctl 输出灌进上下文。
- 运维人员拿到云厂商给的 server-info 文本块,希望一条命令完成首次密码登录、装公钥并进入可复用会话。
- 需要在一个持久 shell 里连续执行多条命令、保留工作目录和环境变量的调试场景。
- 需要把构建脚本通过 stdin 送到远端执行,或在大文件传输时使用 transfer put/get/sync 的场景。
- 需要在多台主机上并行跑同一条检查命令并快速找出失败主机的场景。
- 希望以插件/技能方式给 Claude Code、Codex、Cursor、Cline、Copilot CLI、OpenCode 或 Pi 增加 SSH 能力的团队。
安装与配置要点
摘自下方的安装和使用说明,以项目 README 的最新说明为准。
- 安装 / 启动命令
npm i -g agent-assh
- 环境变量
JOB_ID- 配置文件
~/.ssh/id_ed25519
如何安装或部署这个 Agent?
通过 npm 安装包装器,它会从 GitHub Releases 下载对应的 Go 二进制;需要本机有 Node.js/npm,远端需要 OpenSSH 与可安装的 tmux(Unix-like 主机)。
npm i -g agent-assh也可以直接从 GitHub Releases 手动下载归档;安装器会用同一 release 的 checksums.txt 校验 SHA-256,但仓库说明这不能防发布被替换,需要来源验证时请从源码构建。
https://github.com/izzzzzi/agent-assh/releases如何使用这个 Agent?
首次连接:密钥登录或首次密码登录(密码只通过环境变量传递)。
assh connect -H 203.0.113.10 -u root -i ~/.ssh/id_ed25519 -n deploy
export TARGET_PASS="..."
assh connect -H 203.0.113.10 -u root -E TARGET_PASS -n deploy
unset TARGET_PASS返回 sid 后使用 session API;connect 的响应里包含 next_commands。
assh session exec -s f7a2b3c4 -- "pwd"
assh session read -s f7a2b3c4 --seq 1 --limit 50
assh session read -s f7a2b3c4 --seq 1 --limit 50 --raw
assh session close -s f7a2b3c4长任务、stdin 脚本、端口转发与文件传输:
assh session exec-async -s f7a2b3c4 -- "make build"
assh session job-status -s f7a2b3c4 --job-id JOB_ID
cat script.sh | assh session exec -s f7a2b3c4 --stdin -- "bash -s"
assh forward start -H HOST -u USER -i KEY
assh transfer put -H HOST -u USER -i KEY ./local /remote/path给代理安装技能,例如 Claude Code 与 Codex:
/plugin marketplace add izzzzzi/agent-assh
/plugin install assh@asshcodex plugin marketplace add izzzzzi/agent-assh
codex plugin add assh@assh这个 Agent 有哪些优点和局限?
connect一条命令完成密钥、密码首登、tmux 安装、旧会话清理和会话建立,并返回可直接使用的next_commands。- 分页读取模型让代理先看元数据再按
--seq/--limit读取窗口,audit --savings还能统计被 withhold 的行数。 - 安全细节明确:密码只经环境变量,审计日志不记录密码与命令原文,输出默认脱敏,destructive 命令分类器拦截高危操作。
- 使用 ControlMaster 连接池复用 SSH 套接字,并为长时间任务提供
exec-async/job-status/job-cancel。 - 同一个 CLI 同时覆盖会话、文件传输、端口转发、多主机并行和主机盘点,并提供多代理插件/技能安装路径。
- 分类器和 profile 都是基于模板的护栏,README 明确说明不处理
--stdin传入的脚本、解释器,也不识别docker rm、DROP DATABASE等。 - 依赖系统 OpenSSH;
transfer sync需要 rsync,transfer list/stat需要 GNU find/stat,缺少时返回unsupported_remote。 - tmux 会话面向 Unix-like 远程主机,v1 不支持交互式密码提示,
--force-pty下 stderr 与 stdout 会合并。 - npm 包装器从同一 release 取
checksums.txt,没有 Sigstore/cosign 独立签名,来源验证需自行从源码构建。 - 会话内建议一次只跑一个
session exec,命令共用一个 shell,且session exec默认超时 300 秒。
这个 Agent 与同类方案有什么区别?
与相关度最高的同类 agent 并排比较关键指标。
| Agent | 源码审查 | 形态 / 费用 | Star | 最近更新 | 主语言 | 完整支持的平台 |
|---|---|---|---|---|---|---|
| assh 当前 | 65 · 存在缺口 | 命令行工具免费 | ★ 22 | 11 天前 | Go | Codex · Claude Code |
| APN 智能体支付节点 | 80 · 表现良好 | 命令行工具免费 | ★ 73 | 2 天前 | TypeScript | — |
| Agency Orchestrator:一句话组队 AI 专家团队 | 71 · 存在缺口 | 命令行工具免费 + 模型费 | ★ 2.5k | 10 天前 | TypeScript | Codex · Claude Code · OpenAI API · Claude API |
| OpenOSINT:AI 驱动的 OSINT 调查代理 | 68 · 存在缺口 | 命令行工具免费 + 模型费 | ★ 2k | 5 天前 | Python | Claude Code · Claude.ai · OpenAI API |
FollowAgents 如何评估这个 Agent?
查看各维度的扣分理由
最小权限:提供 readonly/ops/admin 配置与安全分类器,但明确声明只是护栏而非安全边界,且 exec/transfer/fleet 不受 profile 约束,故仅 2。用户确认:破坏性命令需 --confirm-danger,且 exec/exec-async/fleet 无此开关,多主机破坏性执行被刻意禁止,但分类器为模式匹配、可被脚本绕过,故 2。数据流透明:README 说明密码经环境变量/文件传入、审计只存命令哈希、输出默认脱敏,但本地会话转录保留命令原文,透明性有缺口,故 2。敏感数据处理:无 --password 参数、密码不入审计、默认脱敏,但脱敏为尽力而为且 --no-redact 可关闭,故 2。依赖安全:go.mod 仅 cobra/pflag/mousetrap,依赖面小,但未见 go.sum 或漏洞扫描证据,npm postinstall 下载二进制仅校验同源 checksums.txt、无独立签名,故 1。外部影响:默认 -T、accept-new 主机密钥、清理仅限受信元数据,影响受控,故 2。回滚:有 session close/gc 与 job-cancel,但无对已执行破坏性操作的恢复机制,故 1。来源归属:插件/包元数据指向 izzzzzi,但发布者未经 FollowAgents 验证,身份未知,故 1。
自一致性:README、AGENTS.md、SKILL.md 的命令与错误码描述一致,且 AGENTS.md 由脚本从 skill 生成并有 CI 校验副本同步,故 2。依赖可用性:依赖系统 OpenSSH、tmux、rsync、GNU find/stat,跨平台受限且未在包内声明这些外部依赖的检测,故 1。失败信息:错误码表(dangerous_command_requires_confirmation、command_not_allowed、timeout 等)给出明确处置建议,故 3。
受众与场景:面向 LLM agent 的 SSH 工作流,覆盖连接、会话、传输、作业、fleet,场景清晰,故 2。能力边界:明确列出分类器/脱敏非安全边界、不支持交互式密码、tmux 仅 Unix、stdin 上限 4 MiB 等,边界说明充分,故 3。触发精度:SKILL.md description 指明 SSH/远程命令/日志/传输/部署场景,触发条件较明确,但“任何 SSH 工作都用 assh”较宽泛,故 2。环境适配:支持多 agent 安装方式与 --force-pty、--ssh-config、跳板机,但依赖 Unix 远端与系统工具,故 2。
信息架构:README 分节清晰、有架构图与命令清单,AGENTS.md 与 SKILL.md 结构一致,故 2。安装说明:给出 npm 全局安装、各 agent 安装方式与手动下载,但 postinstall 下载二进制机制说明较简,故 2。命名稳定性:包名 agent-assh、命令 assh、插件名 assh 一致,版本 1.4.0 多处一致,故 2。示例与 FAQ:有大量命令示例与错误处置表,但无独立 FAQ,故 2。已知限制:Limitations 一节详尽列出平台、依赖、并发、stdin 等限制,故 3。许可证:MIT,LICENSE 文件与元数据一致,故 3。版本与变更日志:有版本号与 release 工作流,但未见 CHANGELOG 文件,故 1。维护责任:SECURITY.md 给出报告渠道与支持版本,但发布者身份未验证、无明确维护者承诺,故 1。
输出可用性:返回紧凑 JSON、next_commands、分页读取与 --raw,对 agent 解析友好,故 3。边际价值:相比裸 ssh 提供会话持久化、输出分页、脱敏与安全分类器,价值明确但可由现有工具组合替代,故 2。成本收益:需安装 Go 二进制与远端 tmux,收益为上下文节省与安全护栏,权衡合理但引入额外依赖,故 2。
声明可追溯:README 声明有 CI 徽章与工作流文件佐证,但多数安全/行为声明无对应源码在包内展示,故 1。跨源印证:README、AGENTS.md、SKILL.md、SECURITY.md、CI 配置相互印证命令与安全策略,故 2。事实与推断分离:文档区分“护栏非边界”“尽力而为脱敏”等限定,未夸大,故 2。
- 安全分类器与 profile 仅为模式匹配护栏,可被 --stdin 脚本、解释器或未分类命令(docker rm、DROP DATABASE、git reset --hard)绕过,不能作为安全边界。
- npm postinstall 从 GitHub Releases 下载二进制,仅校验同源 checksums.txt,无独立签名,存在发布被替换的风险;敏感环境建议从源码构建。
- 本地会话转录保留命令原文,切勿在命令中内联密钥;脱敏为尽力而为且可被 --no-redact 关闭。
- 发布者身份未经 FollowAgents 验证,安装前应自行核实来源与发布完整性。
- 依赖系统 OpenSSH、tmux、rsync 与 GNU 工具,非 Unix 远端或缺失工具时功能受限。
最近版本
来自该项目 GitHub Releases 的最新发布记录,说明为上游原文摘录,未经本站改写或测试。
-
发布说明摘录
Changelog * 745024878c9149d8eb66a1eaf15018dc2ce5a866 Merge: pause dependabot updates * f0b44fbf4e426e22182e6f58d9bbc0e820563195 Merge: release 1.4.0 * 3d9fc3be3edbdebf65480109c437bc7a0cce6961 chore: pause dependabot updates (remove config temporarily) * a43bd0fa955431c3c4f6652748ba3838e9dbb53b fix: close quote-desync and process-substitution bypasses, honour --batch * c63230e285264ab3089b7f7ff81b34ba82d41d6d release: 1.4.0 — safer sessions, one-source skill, installable plugin在 GitHub 查看 ↗ -
发布说明摘录
Changelog * 769b6147c00f42c9ea8b4af71220925faa4f56d1 Bump version to 1.3.3 * fd94f091772bc100fdc0695524fe0518bf341e3e Merge branch 'docs/assh-skill-usage-fixes' * 488e87bcb6d4a449c6d479f4fbc70150fea9e9ba Merge: bump version to 1.3.3 * 8bd7d7a972e5eca4fec028895ba095d621b9b8dd Merge: ci rerun * bfd75aec956e8a4b68d48edec10f256ae8bb71ee Merge: docs accuracy pass * 1055de660c80b921488ac2cfb1f2bbae7bca128d Merge: fix golangci v2 config * bb4f677a5847cb8f42f3e5bb09c8ca62bd08c6f1 Merge: remove docker/db-query wrappers …在 GitHub 查看 ↗ -
发布说明摘录
Changelog * 08bc624af9346c646e9a4426fbdb19eb5c3348da chore: bump version to 1.3.2 * 7db8e9d85b7fe64dceca4cb0f29a6b553bd5cf34 chore: ignore agent scratch files * a4114bcf96af4d8e91bdf8a6f2d0a0e8df8c7dc0 feat: label session list liveness as ttl-only * 721627db2cbf652e6b69ed93a2a5eb3f15ab2f90 feat: report stale remote tmux sessions * f635591d54858f9ee0b82113821b5f64d7bd04e1 feat: report unreachable registered sessions * 34d119d188cf86bf8fcec23097e06a0cdf746789 fix: add recovery hints for missing session output在 GitHub 查看 ↗
常见问题
它自己会调用大模型吗?
密码是怎么传的,会出现在日志里吗?
connect 和 key-deploy 只接受环境变量名(-E),没有 --password 参数;connect-info 从文件或 stdin 读入 provider 文本块。审计日志保存命令哈希而非原文,密码值不写入,但本地 session transcript 会保留命令文本,因此不要把密钥写进命令。分页读取会不会丢输出?
--seq、--offset、--limit 和 --stream stderr 翻页读取;阅读页按行而非按字节计算,超长单行会被完整返回,建议在服务器端用 | cut -c1-500 之类截断。命令卡住或超时怎么办?
session exec 默认等待 300 秒(-t 可调),超时后命令仍在会话中继续,应稍后用它的 seq 读取,而不是盲目重跑;未知时长的任务改用 exec-async 加 job-status/job-cancel。适合生产环境吗,能限制权限吗?
--profile readonly 或 ops 限制会话内可执行命令,并通过 ~/.config/assh/safety.rules(0600)追加禁止命令;但仓库自己强调这些是防误操作护栏,真正的边界是远端账号权限,高风险环境应配合 --host-key-policy strict 和最小权限账号。assh 免费吗?
assh 开源吗?
assh 还在维护吗?
assh 是谁开发的?
谢谢反馈,我们会据此改进页面。