2026-11-13· antonio 的博客


目录

我构建了lend让远程智能体在获得我批准的情况下使用我笔记本电脑上的工具。以下是它如何融入我的工作流。

背景#

如今我在工具链中大量使用智能体。我通常同时运行几个:Claude Code 在一个仓库中工作,Codex 在另一个仓库中审查分支,还有一个在后台长时间运行。我也经常让它们互相审查彼此的工作。它们都不在我的笔记本电脑上运行。它们运行在可以随时丢弃的虚拟机上,而我的笔记本电脑保留我在意的东西:我的 SSH 密钥、我的 1Password 保险库,以及那些以我的身份登录的gh和云 CLI。

我在picd上运行这些智能体,那是我们在pico.sh的托管服务。它为我提供了一台自带 Docker 引擎和 SSH shell 的虚拟机。我在那里运行 herdr 和这些智能体,我的主目录在重启后依然保留,所以我的 dotfiles 和工具都还在。

这一切运行得很好,直到某个智能体需要我笔记本电脑上的东西。在这篇文章中,我将介绍我如何用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 --untildone
3herdr agentreadreviewer --source recent

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

Ovis#

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

如果智能体在我离开工位时卡在一个问题上,我可以从手机上回答它,其他智能体则继续运行。

凭据问题#

虚拟机上的智能体仍然需要以我的身份行事。我用它们来监控 CI,配合gh、使用 1Password 中的令牌调用 API,以及 SSH 登录其他主机。有两种常见的实现方式,而这两种我都不喜欢。

第一种是把凭据复制到虚拟机上。放在~/.config/gh/hosts.yml中的令牌,只要令牌有效,该机器上的每个进程都能读取它,包括智能体以及它运行的任何东西。

第二种是用ssh -A转发我的 SSH agent。私钥留在我的笔记本电脑上,但虚拟机可以使用 agent 中的每一把密钥,无需询问,也没有任何关于它签了什么的记录。而且它只覆盖 SSH 密钥。

我想要的是让凭据留在笔记本电脑上,让需要它们的命令也在那里运行。智能体请求运行某个东西,我用 Touch ID 批准,然后智能体拿回输出。

lend#

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

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

1远程:lend exec -- command args2|3转发的 SSH agent socket4|5笔记本电脑: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

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

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

这里我向 VM 上的 Claude Code 询问了 lend 仓库的描述。它用gh repo view调用了该工具,我的 Mac 显示了请求,一次触摸就批准了:

Claude Code on the VM asks to run gh repo view on the laptop. The lend dialog on the Mac lists the request and the caller, Touch ID approves it, and Claude prints the repo description.

对话框会显示可执行文件的完整路径、每个参数、它将在笔记本上运行的目录、原因,以及远程进程对自身的描述。一旦我批准,gh就会在笔记本上运行,stdout、stderr 和退出码会流回智能体。原因和调用方详情来自 VM,因此被标记为未验证。它们只是用来帮我做决定,无法改变策略所允许的内容。

如果你更想跳过 MCP,同样的请求也可以在 VM 上作为普通 CLI 调用:

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

在重连之间保持 socket 稳定#

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

我在固定路径上使用一个符号链接,并从 VM 上的~/.ssh/rc更新它。SSH 会在启动 shell 之前运行它,因此它能看到新连接转发的 socket:

1#!/bin/sh23if [-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
6install -d -m700 "$HOME/.ssh/lend" &&
7ln -sfn --"$SSH_AUTH_SOCK" "$HOME/.ssh/lend/agent.sock"
8fi
910if [-n"${DISPLAY:-}" ] && read-r _ssh_proto _ssh_cookie; then
11  case $DISPLAYin12localhost:*) _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

该检查确认转发的套接字在更新链接之前会响应 lend。该目录对我的用户私有,并使此链接与其他智能体套接字保持分离。我使用 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 钩子会更新符号链接,这些进程在后续请求中会使用新的套接字。已经使用旧套接字路径运行的智能体需要在其环境中使用稳定路径重启一次。

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

智能体永远看不到的机密#

gh之所以可行,是因为它已经在我笔记本电脑上登录了。有些工具需要传入令牌。对于这些工具,命令规则可以用类似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}

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

这是运行中的 VMgh api user并带有一条规则,用于注入GH_TOKEN。在 lend 中批准后,1Password 会先要求它自己的 Touch ID,然后op read返回令牌。VM 拿回了我的登录信息,而它自己的环境里没有GH_TOKEN:

有一个问题:这只有在被批准的命令不打印其环境变量时才有效。如果你批准env或sh,你就把值直接交回去了。允许op本身作为命令也是如此,因为op read会打印密钥,而该输出会直接发送给智能体。

SSH 密钥#

密钥也有自己的策略。未列出的密钥对 VM 隐藏,已列出的密钥可以按允许签名的内容加以限制。max_signatures限制一个密钥在一次会话中最多能进行多少次签名。

租约#

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

查看发生了什么#

lend status --all --watch显示已连接的内容、正在等待的内容、正在运行的内容以及任何活动租约。lend pause --all取消一切并拒绝新请求,直到我恢复。lend history保留运行内容及其批准方式的记录。它省略参数、输出和密钥,你可以选择记录参数。

从笔记本电脑回答智能体提示#

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

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

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 代理代理发送本地执行请求,而op-forward将 1Password CLI 命令转发到具有桌面身份验证的机器。lend 是一个独立的实现,使用相同的智能体扩展技巧,并增加了按请求策略、本地批准和密钥过滤。

试用#

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

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

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