Newshot

在不交出凭据的情况下运行编码代理

Translation(model translation, not the source's own text)

目录

  • 凭据问题
  • lend 在重连之间保持 socket 稳定 代理永远看不到的秘密 SSH 密钥 租约 查看发生了什么 从笔记本上回答代理的提问
  • 在重连之间保持 socket 稳定
  • 代理永远看不到的秘密
  • 查看发生了什么
  • 从笔记本上回答代理的提问
  • lend 无法防护的情况
我构建了 lend,让远程代理在获得我批准的情况下使用我笔记本上的工具。以下是它如何融入我的工作流程。

背景

如今我在工具链中大量使用代理。我通常会同时运行几个:Claude Code 在一个仓库里工作,Codex 在另一个仓库里审查分支,还有某个长期运行的任务在后台。我也经常让它们互相审查对方的工作。它们都不在我的笔记本上运行。它们运行在我可以随时丢弃的 VM 上,而我的笔记本保留我在意的东西:我的 SSH 密钥、我的 1Password 保险库,以及以我的身份登录的 gh 和云 CLI。

这一切都运转良好,直到某个代理需要用到这些东西。在本文中,我将介绍我如何用 herdr 和 Ovis 并行运行代理,以及我为处理凭据而写的工具 lend。

herdr

herdr 是一个为编码代理构建的终端复用器。你拥有常见的工作区、标签页和窗格,它还能知道每个窗格里运行着哪个代理、正在做什么。侧边栏会显示每个代理是在工作、在等我,还是已完成,这样我一眼就能看出哪个需要关注。

CLI 与正在运行的会话通信,因此代理可以互相驱动。一个代理可以在另一个窗格中启动 Codex,给它一个提示,等它完成,然后读取它说了什么:


        1herdr agent start reviewer --kind codex --pane "$PANE"
2herdr agent prompt reviewer "Review the diff on am/fix-retries" --wait --until done
3herdr agent read reviewer --source recent
      

远程主机的工作方式相同。herdr machine add agent-vm 会在 VM 上设置 herdr,并将其会话添加到我本地的客户端。这些会话在我断开连接后仍会继续运行。

Ovis

Ovis 是 herdr 的浏览器和手机客户端。它把每个代理的对话记录显示为聊天,实时终端只需轻点一下即可打开。当代理请求批准或有疑问时,Ovis 会把它变成一张我可以回答的卡片,并向我发送推送通知。它会读取 herdr 中保存的机器,因此我的 VM 无需额外设置就会出现。我通过 Tailscale 访问它。

如果代理在我离开办公桌时卡在某个问题上,我可以从手机上回答它,其他代理则继续运行。

凭据问题

VM 上的代理仍然需要以我的身份行事。我用它们通过 gh 监控 CI、用来自 1Password 的令牌调用 API,以及 SSH 登录其他主机。通常有两种方法可以实现这一点,而这两种我都不喜欢。

第一种是把凭据复制到 VM 上。~/.config/gh/hosts.yml 中的令牌可以被该机器上的每个进程读取,包括代理及其运行的任何东西,只要令牌仍然有效。

第二种是用 ssh -A 转发我的 SSH agent。私钥留在我的笔记本上,但 VM 可以在不询问、也没有任何签名记录的情况下使用 agent 中的每一个密钥。而且它只覆盖 SSH 密钥。

我想要的是让凭据留在笔记本上,并且需要它们的命令也在笔记本上运行。代理请求运行某个命令,我用 Touch ID 批准,然后代理拿回输出。

lend

这就是 lend 的用武之地。lend 是一个位于你现有 SSH agent 前面的代理,你转发它的 socket 来代替真正的 socket。SSH 和 Git 照常工作,而 lend 增加了一种通过 SSH agent 扩展来运行命令的方式。

当 VM 上的代理请求运行 gh 时,请求通过 socket 传过来,gh 在我的笔记本上以我的登录身份运行。令牌永远不会离开笔记本,因此代理永远拿不到它。每个请求,无论是签名还是命令,都会对照笔记本上的策略进行检查,并且在任何事情发生之前都需要我的批准。

文章标题:在没有交出凭据的情况下运行编码代理

正文:


        1Remote: lend exec -- command args
2                  |
3          转发的 SSH agent socket
4                  |
5Laptop: lend agent -> 策略 + 本地批准 -> 本地命令
6                                           -> 原始 SSH agent(签名)
      

策略放在笔记本电脑上,列明虚拟机可以请求什么。其余一律拒绝。我的策略很短:


        1{
 2  "default": "deny",
 3  "commands": [
 4    {"executable": "/opt/homebrew/bin/gh", "approval": "biometric:inline"}
 5  ],
 6  "ssh": {
 7    "default": "deny",
 8    "keys": [
 9      {"fingerprint": "SHA256:...", "approval": "biometric:inline"}
10    ]
11  }
12}
      

规则也可以接受 args_prefix,比如 ["pr", "view"],如果你只想允许部分子命令。biometric:inline 会把 Touch ID 直接放进请求对话框,于是我读取请求并触摸一次即可批准。普通 biometric 会在我点击 Allow 之后,再弹出一个提示来要求 Touch ID。

连接时,我从笔记本电脑运行 lend ssh。它为这一次连接启动一个代理,并在 SSH 退出时停止它:


        1lend ssh --config ./policy.json -- agent-vm
      

我在虚拟机上运行 herdr。Claude Code 通过 lend mcp 与 lend 通信,这是一个 MCP 服务器,只有一个名为 run_local_command 的工具。该工具接受要运行的命令和一个原因,原因是必填的:


        1{
2  "mcpServers": {
3    "laptop": {"command": "lend", "args": ["mcp"]}
4  }
5}
      

这里我在虚拟机上让 Claude Code 获取 lend 仓库的描述。它用 gh repo view 调用了该工具,我的 Mac 显示了请求,一次触摸就批准了:

虚拟机上的 Claude Code 请求在笔记本电脑上运行 gh repo view。Mac 上的 lend 对话框列出了请求和调用方,Touch ID 批准后,Claude 打印出仓库描述。
虚拟机上的 Claude Code 请求在笔记本电脑上运行 gh repo view。Mac 上的 lend 对话框列出了请求和调用方,Touch ID 批准后,Claude 打印出仓库描述。

对话框显示可执行文件的完整路径、每个参数、它在笔记本电脑上运行的目录、原因,以及远程进程对自己的说明。我批准后,gh 在笔记本电脑上运行,stdout、stderr 和退出码会流回代理。原因和调用方详情来自虚拟机,因此被标记为未验证。它们用来帮我做决定,不能改变策略允许的内容。

如果你不想用 MCP,同样的请求在虚拟机上作为普通 CLI 调用也可以:


        1lend exec --reason "Read the repo description" -- gh repo view antoniomika/lend
      

在重连之间保持 socket 稳定

herdr 窗格能在 SSH 断开后存活,但转发的 socket 属于那次连接。当我重新连接时,SSH 会给我一个新的 socket 路径。仍在窗格里运行的代理会保留旧的 SSH_AUTH_SOCK。

我在固定路径上使用一个符号链接,并通过虚拟机上的 ~/.ssh/rc 更新它。SSH 在启动 shell 之前运行这个文件,所以它能看到新连接转发的 socket:


        1#!/bin/sh
 2
 3if [ -n "${SSH_AUTH_SOCK:-}" ] &&
 4    [ "$SSH_AUTH_SOCK" != "$HOME/.ssh/lend/agent.sock" ] &&
 5    "$HOME/.local/bin/lend" doctor --remote --socket "$SSH_AUTH_SOCK" --timeout 1s >/dev/null 2>&1; then
 6  install -d -m 700 "$HOME/.ssh/lend" &&
 7    ln -sfn -- "$SSH_AUTH_SOCK" "$HOME/.ssh/lend/agent.sock"
 8fi
 9
10if [ -n "${DISPLAY:-}" ] && read -r _ssh_proto _ssh_cookie; then
11  case $DISPLAY in
12    localhost:*) _ssh_display="unix:${DISPLAY#localhost:}" ;;
13    *) _ssh_display=$DISPLAY ;;
14  esac
15  printf 'add %s %s %s\n' "$_ssh_display" "$_ssh_proto" "$_ssh_cookie" | /usr/bin/xauth -q -
16fi
      

这项检查确认转发的 socket 会响应 lend,然后再更新链接。该目录仅我的用户可访问,并让这个链接与其他代理 socket 分开。我使用 lend 的绝对路径,因为这段代码在我的 shell 把 ~/.local/bin 加入 PATH 之前运行。X11 块处理 cookie 设置,当该文件存在时,SSH 会把这项设置委托给它。

我的 ~/.bashrc 在导出稳定路径之前会先检查它:


        1if [ -S "$HOME/.ssh/lend/agent.sock" ] &&
2    "$HOME/.local/bin/lend" doctor --remote --socket "$HOME/.ssh/lend/agent.sock" --timeout 1s >/dev/null 2>&1; then
3  export SSH_AUTH_SOCK="$HOME/.ssh/lend/agent.sock"
4fi
      

当这条路径可用时,herdr 窗格中新建的 Bash shell 会采用这个稳定路径。如果检查失败,Bash 就保持 SSH_AUTH_SOCK 不变。当我启动 MCP、审批钩子和 Git 时,它们会继承该路径。重新连接后,SSH 钩子会更新符号链接,这些进程在后续请求中就会使用新的 socket。已经以旧 socket 路径运行的 agent 需要用环境中的稳定路径重启一次。

从笔记本电脑发起的 SSH 连接仍然必须保持打开。断开期间请求会失败,重新连接会启动一个新的 lend 会话,带有全新的审批和租约。该链接一次只指向一个连接,所以最后一次更新生效。

Secrets the agent never sees

gh 之所以能用,是因为它已经在我笔记本电脑上登录了。有些工具需要传入 token。对于这些工具,命令规则可以用类似 op read 的方式读取密钥,并作为环境变量交给已批准的的命令:


        1{
 2  "secret_reader": "/opt/homebrew/bin/op",
 3  "secret_reader_args": ["read", "--no-newline"],
 4  "commands": [
 5    {
 6      "executable": "/opt/homebrew/bin/gh",
 7      "args_prefix": ["pr", "view"],
 8      "approval": "biometric",
 9      "secrets": {"GH_TOKEN": "op://Development/github/token"}
10    }
11  ]
12}
      

当 agent 请求运行 gh pr view 且我批准时,lend 会从 1Password 读取 token,在设置 GH_TOKEN 的情况下运行 gh,并把输出发回。token 留在笔记本电脑上。VM 无法选择设置哪些变量或读取哪些引用。提示中会显示变量名和引用,而值永远不会出现在提示或历史记录中。

下面是 VM 在注入 GH_TOKEN 的规则下运行 gh api user。我在 lend 中批准后,1Password 在 op read 返回 token 之前会要求它自己的 Touch ID。VM 拿回了我的登录信息,而它自己的环境里没有 GH_TOKEN:

有一个注意事项:这只有在已批准的命令不打印其环境时才有效。如果你批准了 env 或 sh,你就把值直接交回去了。允许 op 本身作为命令也是如此,因为 op read 会打印密钥,而该输出会直接发给 agent。

SSH keys

密钥也有自己的策略。未列出的密钥对 VM 隐藏,已列出的密钥可以通过允许签名的内容加以限制。max_signatures 限制一个密钥在会话中可以生成多少个签名。

Leases

规则可以在批准时提供一个租约,比如五分钟或三次使用。租约只存在于 lend ssh 会话内部,并且只匹配我批准的确切命令和参数。会话结束或屏幕锁定时,租约就会消失。

Seeing what happened

lend status --all --watch 显示什么已连接、什么在等待、什么在运行,以及任何活动租约。lend pause --all 取消一切并拒绝新请求,直到我恢复。lend history 保留运行了什么以及如何被批准的记录。它不包含参数、输出和密钥,你可以选择记录参数。

Answering agent prompts from the laptop

Agent 也会为与我的凭据无关的事情请求许可,比如在 VM 上运行 shell 命令、编辑文件或获取 URL。lend approve 会把这些发到我 Mac 上的同一个对话框。它不在笔记本电脑上运行任何东西。它询问我,然后由 agent 决定如何处理答案。

对于 Claude Code,它是 VM 上的一个 PermissionRequest 钩子:


        1{
2  "hooks": {
3    "PermissionRequest": [
4      {"matcher": "*", "hooks": [{"type": "command", "command": "lend approve --hook claude-code"}]}
5    ]
6  }
7}
      

现在当 Claude Code 通常会在终端停下并询问时,我的 Mac 会显示命令或工具输入,我用 Touch ID 来批准。笔记本上的策略列出了允许发起询问的主题,每个主题都有自己的审批方式:


        1"approvals": {
2  "topics": [{"name": "claude-code", "approval": "biometric:inline"}]
3}
      

针对 Codex、Antigravity 和 pi 都有适配器,另外还有一种适用于其他任何工具的纯 JSON 格式。你也可以在脚本中使用:lend approve --topic deploy --title "terraform apply" && terraform apply 只有在我于笔记本上批准后才会执行。如果无法连接到笔记本,钩子会保持不介入,智能体就会像平常一样在自己的 UI 中询问。

lend 无法防护的情况

已批准的命令以我的用户身份运行,可以访问我的文件。审批决定运行什么,lend 并不会对它进行沙箱隔离。如果我批准了一个 shell、一个解释器,或任何从 stdin 读取指令的东西,我基本上就等于批准了在我的笔记本上运行任何东西,因为 stdin 在批准之后才会流式传输,并且不会显示在提示中。

提示中的调用方详情来自 VM,可以被伪造。任何能访问 VM 上转发套接字的人,包括 root,都可以在会话打开期间发起请求。策略仍然限制他们能请求什么,而且每个请求仍然需要我的批准。

lend 仍处于早期阶段,运行在 macOS 和 Linux 上。它不分配 PTY,因此交互式程序无法通过它工作。在 Linux 上,审批是一个 Zenity 对话框或终端提示,而生物识别审批仅限 macOS。

先前技术

ssh-rev-exec 通过 SSH agent 代理发送本地执行请求,op-forward 则将 1Password CLI 命令转发到具有桌面认证的机器上。lend 是一个单独的实现,使用了相同的 agent 扩展技巧,并增加了按请求策略、本地审批和密钥过滤。

试用

在你的笔记本和远程主机上都安装 lend:


        1brew install antoniomika/tap/lend
2# or
3curl -fsSL https://github.com/antoniomika/lend/releases/latest/download/install.sh | sh
      

在笔记本上运行 lend doctor 来检查你的策略、可执行文件、上游 agent 和审批设置。在 VM 上运行 lend doctor --remote 来检查转发套接字是否确实是 lend。入门指南会带你走完第一次会话,文档则涵盖策略、审批和 MCP。如果你试用了,我很想在 GitHub 上听听进展如何。

The translation is machine-generated and individual terms may be off. Nothing is rewritten or cut; the original is authoritative.

Published by Hacker News
This site only summarises and aggregates; copyright stays with the original author. Headlines and summaries follow the source — where they differ, the original wins.
Read the original ↗