资讯动态

herdr-gpui Teleport 深度解析:带着未提交改动、运行中进程和 Agent 会话跨主机迁移工作树

发布时间:2026/10/15 17:31:46 来源:尧图企业网站定制
【免费下载链接】herdr-gpuiNative client for Herdr on macOS, Linux, and Windows, built with Rust and GPUI. View terminal sessions, workspaces, Git worktrees, and agent activity through your local Herdr daemon.项目地址https://gitcode.com/gh_mirrors/he/herdr-gpui点击查看免费下载herdr-gpui 的Teleport功能让你把一个 Git worktree 连同它的未提交改动、正在运行的程序和 Agent 会话一次性迁移到另一台已连接的主机SSH 远程机、Coder / Daytona / Railway 云设备。整个迁移由本地 herdr daemon 后台脚本驱动你只需在界面点几下鼠标。什么是 Teleport它解决什么问题想象这样一个场景你在家用笔记本上开着feat-multi-currency分支的 worktreeClaude 会话跑了一半几个测试还在执行。到公司后你希望这套进行中的工作状态原封不动地搬到那台 GPU 工作站上继续干——而不是 push 到远端再 pull、再手工把命令重新敲一遍。Teleport 做的就是这件事代码状态分支、提交、staged / unstaged / 未跟踪文件全部带走界面布局tab、分屏、窗口标签在目标主机上原样重建⚙️运行中程序每个窗格里的命令带着原参数重新启动路径自动映射到新 checkoutAgent 会话Claude Code、Codex、opencode、pi 等的会话按各自格式迁移完整历史可续接。源码中的模块说明把功能定义得很直白Move a linked worktree to another connected host with its branch, commits, uncommitted changes, tabs, running programs, and agent sessions. —— crates/herdr-gpui/src/teleport.rs三步完成一次迁移在 herdr-gpui 的 Spaces 侧栏里右键一个已链接 Git 仓库的 worktree选择Teleport...然后按三步走第 1 步选择目标主机对话框会一次性列出所有其他可用的主机在线或离线都列出选中某台之前不会做任何探测。目标主机按以下顺序自动找到落点这个 worktree 曾经迁移离开时留下的那个 checkout配合teleported.json标记目标上已打开的同一仓库——按 Git remote优先origin或仓库名匹配都没有则自动布置在目标主机的家目录下同路径如~/code/app克隆/拷贝仓库origin不可达时会直接从本机连同分支和 tag 复制过去。详细流程见 crates/herdr-gpui/README.md 的 Teleport 章节。第 2 步Review 确认确认框会列出将要迁移的内容清单分支、未推送的提交、变更和未跟踪的文件、以及每个窗格迁移后会变成什么样。安全约束目标上的同名分支必须不存在或是当前分支的祖先目标上不能已有该分支的 checkout避免覆盖分叉的分支如果目标是 GitHub 仓库但目标机器连不上origin界面会提示并可选择借用本机的gh auth token只存到目标仓库的.git/herdr/github-token不会进入工作树或提交。第 3 步执行迁移自动跟随到新窗口点击Teleport后迁移在后台线程进行——关闭对话框不会中断进行中的迁移结果以窗口闪光flash通知。成功后界面自动切换到目标主机上的新 workspace并在需要时等待该主机连接。数据是怎么搬过去的理解机制后你会对未提交改动也能搬这件事更有信心内容迁移方式提交打包成Git bundle只携带目标缺失的部分未提交改动通过临时 index 构造成两个临时 commit传输源 checkout 的索引和分支不受任何影响分支指针设为源分支 commit可 fast-forward绝不覆盖分叉分支工作区状态目标上herdr worktree create检出后staged 索引与工作树被精确还原含二进制文件会话恢复各 Agent 用自己的格式续接见下文注意被.gitignore忽略的文件如.env、构建产物和子模块内容留在原主机环境变量、shell 历史、后台任务和未保存的编辑器缓冲区也不随迁。Agent 会话迁移对照表Agent 会话按各家自己的格式迁移因此完整历史可以续接详见 READMEAgent迁移形式恢复命令Claude Code会话记录写入新 cwd 的~/.claude/projectsclaude --resume idCodex~/.codex/sessions下的 rolloutcodex resume idopencodeopencode export/importopencode --session idpi / omp会话文件放入新 cwd 的会话目录pi --session fileGitHub Copilot CLI~/.copilot/session-state下会话目录copilot --resumeidLetta Code会话留在 Letta 服务器目标需已登录letta --conversation id迁移时会话内部的路径会改写为新的 checkout 路径原始命令行中的模型与权限参数也一并保留。如果目标主机没装对应 Agent或拿不到会话Teleport 会先请原 Agent 把上下文写成一份handoff 笔记.herdr/teleport/handoff-N.md随改动一起搬运再由 Claude Code / Codex / opencode / pi 中最先可用的 Agent 带着这份笔记接棒继续。迁移之后源头与往返源端收尾目标就绪后源 workspace 里的程序被停止tab 被替换成一个空闲的teleported占位 tabworkspace 和 checkout 本身保留。双向标记客户端在状态目录的teleported.json中记住这次迁移源行上出现 teleport 图标菜单变为Go to teleported copy/Clear teleported mark。原路搬回目标上的副本提供Teleport back打开时已指向来源主机搬回前目标当前状态无论是否已提交会先备份到refs/herdr-teleport/backup/...然后接回分支和改动、重建 tab、清除标记。适用限制与实现要点仅在Linux / macOS 客户端提供且 worktree 所在主机必须是本地会话、已保存的 SSH 主机或 Coder / Daytona / Railway 云设备自定义 socket、WSL 端点和--dev开发会话不支持Teleport不会新建云设备也不会在目标上安装 Herdr云设备复用侧栏连接所用的已保存账号之所以绕开 GUI API 走脚本GUI 连接的 API 不暴露布局、进程细节和 Agent 会话因此每一步都在目标主机上以非交互脚本调用 Git 与herdrCLI本地、SSH 或云命令通道UI 线程永不阻塞。核心实现分布在 crates/herdr-gpui/src/teleport/ 下三阶段任务编排见 job.rs对话框状态机见 ui.rs会话迁移见 sessions.rs快照与进程信息见 snapshot.rs。命令行入口teleport --to HOST的说明见 docs/cli.md。小结Teleport 把换机器继续干活从一次手工搬运变成了三步点击选主机 → Review 确认 → 自动跟随。提交、未提交改动、分屏布局和 Agent 会话都有明确的搬运机制和失败回退handoff 笔记且源端 checkout 始终原封不动。对于同时管理多台机器和多个 AI Agent 的开发工作流它是 herdr-gpui 里最能体现工作流连续性的设计。赞分享【免费下载链接】herdr-gpuiNative client for Herdr on macOS, Linux, and Windows, built with Rust and GPUI. View terminal sessions, workspaces, Git worktrees, and agent activity through your local Herdr daemon.项目地址https://gitcode.com/gh_mirrors/he/herdr-gpui点击查看免费下载相关推荐oh-my-openagent Boulder State 深度解析跨会话、跨工作树的活动工作计划跟踪器oh my openagent Boulder State 深度解析跨会话、跨工作树的活动工作计划跟踪器 导读 本文深入剖析 oh my openagent人工智能AI Agent代码智能体多智能体MCP ClientsAgent 编排如何在不同机器间转移活跃的AI Agent会话Happier会话移交深度解析如何在不同机器间转移活跃的AI Agent会话Happier会话移交深度解析 Happier 的 会话移交 Session Handoff让你把一个正在运eve 单工作流会话架构ingress 驱动的跨部署升级交接机制深度解析eve 单工作流会话架构ingress 驱动的跨部署升级交接机制深度解析 导读 本文基于 eve 仓库中的设计文档 research/single workf人工智能AI AgentAgent 框架后端工具调用创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考

读完文章,也想定制专属网站?

尧图设计师 24 小时内与您沟通定制方案

免费获取报价 →
↑