终端

DevAgent 的终端与 VS Code 使用的是同一个基于 xterm.js 的终端，并针对 AI-agent 工作流做了一些调优增强。

窗格 与 标签页

终端就是标签页 —— 参见 标签页、窗格与分屏布局。拆分一个终端 窗格 会让你并排得到两个 shell。

Agent 终端标签页会显示 agent 身份以及实时状态：工作中、等待输入、已完成，或已完成但未读。对于 Claude 和 Codex，当 DevAgent 能把 窗格 映射到对应会话时，标签标题还可以显示 AI Vault 会话名称（自定义标题 / 线程名）—— 手动重命名仍然优先。

TUI 剪贴板（OSC 52）

许多终端 UI（Zellij、tmux、Neovim、fzf、Grok）通过 OSC 52 复制，而非操作系统剪贴板 API。DevAgent 默认允许这些写入，使得从远程/TUI 复制在 SSH 下的工作方式与本地相同。

切换开关：设置 → 终端 → Allow TUI Clipboard Writes (OSC 52)。

搜索

Cmd-F 打开在滚动回放中查找。匹配高亮、大小写、正则以及匹配项导航均受支持。

链接操作

对终端链接（HTTP/OSC 8 URL、文件路径、工作区、终端或任务句柄）的普通点击会打开一个紧凑的操作弹出框，而非立即导航。对于本地 web 链接，弹出框提供 DevAgent Browser 和 System Browser；远程链接仅限系统浏览器。Web 链接还会有 Copy link，用于复制解析后的 URL（包括隐藏的 OSC 8 目标）且不关闭弹出框 —— 文件和工作区目标保持不变。Cmd-click（macOS）/ Ctrl-click（Windows / Linux）仍会直接打开，而 Shift+Cmd / Shift+Ctrl-click 仍使用 link-routing 的替代方式。

在 设置 → 浏览器 → Show terminal link actions 下可关闭该弹出框。关闭后，打开链接需要用修饰键点击。

复制终端上下文

右键点击终端并选择 Copy Context，可从该 窗格 复制一段有界的转录内容。当你想把近期的 agent 输出粘贴到另一个工具中而不启动 DevAgent fork 时，就用它。

主题

终端配色主题可在 设置 → 终端 下配置。DevAgent 内置了一批流行主题，并允许你自定义其中任意一个。

Ghostty 导入

如果你使用 Ghostty，DevAgent 可在首次启动时导入它的主题、字体和光标配置。之后你可以从 设置 → 终端 → Import from Ghostty 重新运行导入。

Warp 主题导入

如果你在 Warp 中收集了一些主题，可在 设置 → 终端 下的终端主题选择器中点击 Import themes from Warp 把它们导入为 DevAgent 终端主题。DevAgent 会扫描当前操作系统下的 Warp 主题目录（macOS 上是 ~/.warp/themes，Linux 上是 $XDG_DATA_HOME/warp-terminal/themes，Windows 上是 %APPDATA%\warp\Warp\data\themes），并让你挑选要导入哪些 YAML 主题。它旁边的按钮 Import from YAML 使用同一个选择器，但指向任意存放 Warp 格式 .yaml/.yml 文件的文件夹 —— 当你把主题存在默认位置之外时很有用。

导入的主题会与 DevAgent 的内置主题一起出现在主题下拉菜单中。

Windows shell

Windows 上的默认 shell 可在 设置 → 终端 下在 PowerShell、Command Prompt 和 WSL 之间配置。当 wsl.exe --status 成功时，会自动提供 WSL。标签栏上的 + 下拉菜单还会显示一个子菜单，让你无需更改默认设置就能在任意 shell 中打开一个一次性标签页。

对于位于 WSL 文件系统（\\wsl.localhost\...）上的仓库，DevAgent 会通过 wsl.exe -d <distro> 启动。对于在 WSL 中打开的 Windows 路径仓库，DevAgent 会把 cwd 翻译成 /mnt/<drive>/... 并把你带进一个登录 bash。

快捷键

• Cmd-T —— 在当前 worktree 中新建终端标签页。
• Cmd-Alt-T（macOS）—— 使用你的默认 agent 新建一个 agent 标签页。在 Linux 和 Windows 上此组合键出厂未绑定；请在 设置 → 快捷键 下指派一个（搜索 "New agent 标签页"）。每个受支持的 agent 还有它自己的按 agent "New agent 标签页" 操作 —— 绑定一个组合键即可直接启动特定 CLI，而不经过默认设置。
• Cmd-W —— 关闭当前标签页。
• Cmd-\ —— 向右拆分。
• Cmd-Shift-\ —— 向下拆分。

原生按键绑定

DevAgent 宣告支持 kitty keyboard 协议，因此终端应用能看到真实的 Shift+Enter、Ctrl+Enter 及其他能感知修饰键的按键 —— 这些绑定在 DevAgent 中的工作方式与在 Ghostty、WezTerm 或你的原生终端中完全相同。

对于 macOS 上的日文 JIS 键盘，如果你希望物理日元键在终端会话中发送反斜杠，请启用 设置 → 终端 → JIS Yen (¥) to Backslash (\)。

浮动终端

浮动终端是一个全局 shell 界面，无论你在哪个 worktree 或标签页上，它都只需一个组合键即可唤起。对于新安装，它默认开启。

• 用 Cmd+Option+A（macOS）/ Ctrl+Alt+A（Linux/Windows）切换。同一个组合键在面板已打开时聚焦它，在它已聚焦时关闭它。
• 点击窗口边缘的浮动按钮，或在 设置 → 终端 → Floating terminal 下把触发器移到状态栏。
• 在同一设置下设定起始工作目录（默认为 ~），这样新的浮动标签页就会落在你预期的位置。
• 浮动面板托管自己的标签页并支持编排设置 —— 无需占用一个 worktree 窗格 即可发起后台运行。

Quick Commands

Quick Commands 保存你经常运行的终端命令，例如 npm run dev、pnpm test 或某个项目专属的设置脚本。它们也可以保存可复用的 agent prompt，供 Claude、Codex 等启动时接收 prompt 的 agent 使用。你可从 设置 → Quick Commands 或标签栏的 Add command 按钮创建它们，然后从 worktree 标签栏中的 Quick Commands 分裂按钮或终端右键菜单运行它们。

每个命令都有标签、命令文本和作用域。对于处处适用的命令使用 Global，或用 Project 让命令只在某个特定仓库的 worktree 中显示。标签栏按钮会打开一个全新的终端标签页并运行命令；终端右键菜单可把命令插入当前终端。使用命令行上的复制控件（设置列表、标签栏菜单或移动端 Quick Commands）可把命令主体放到剪贴板。

当你使用配对的 Remote DevAgent Server（或其他执行主机）时，选择器可以并排显示本地和远程集合，并按主机标注（例如 Local Mac 和 DevAgent Server）。Saved on 是命令存储的位置；运行命令仍会在你调用它的终端或工作区中执行 —— 因此一个客户端拥有的命令可以在远程 worktree 内运行。不宣告多主机 Quick Commands 的旧服务器会回退到仅本地列表。