跳到主要内容
项目档案应用项目

thinkany-ai/termany 是什么?用途、安装与使用指南

Termany 是面向多 AI 编码代理并行场景的原生终端工具,支持单窗口管理数十个代理会话,内置主流编码代理集成,可同步查看代码差异、工作树、端口占用与 token 消耗,适配桌面与 Web 端使用。

413TypeScriptStar 于 2026年9月14日2026年9月16日 更新

AI 总结

Termany 是一款面向多 AI 编码代理场景的原生终端工具,支持在同一窗口内统一管理数十个编码代理会话,内置主流编码代理集成,可同步查看代码差异、工作树、端口占用与 token 消耗,解决多代理并行管理的混乱问题。

中文项目介绍

Termany 是专为多 AI 编码代理并行工作场景设计的原生终端工具,定位为“Agent-Native Terminal”,核心能力是在单个窗口内统一管理大量编码代理会话,同时集成常规终端所需的多工作区、SSH 远程连接、内联文件编辑预览等能力。 它主要解决多编码代理并行场景下的管理痛点:包括多会话状态难追踪、不同代理切换成本高、同一项目多工作树端口冲突、远程开发任务断连丢失、多代理协作流程分散等问题。 它适合同时运行 5 个以上编码代理、在同一仓库混合使用 Claude/Codex 等多款代理、维护同一项目多个工作树的开发者使用,也支持作为普通终端使用 splits、主题、内联文件查看功能。技术层面采用 npm workspaces monorepo 架构拆分服务端、Web 客户端、桌面端三个独立模块,遵循本地优先设计原则,用户 API 密钥等敏感信息采用 BYOK 模式本地存储,不上传云端。

详细信息与使用说明

1. 项目定位与用途

Termany 定位为“Agent-Native Terminal”,是面向 AI 编码代理并行工作场景设计的原生终端工具,核心目标是在单个窗口内统一管理大量编码代理会话,同时兼容普通终端的 splits、主题、内联文件查看等基础能力。它采用「工作区>垂直标签>水平标签」的分层布局结构,支持桌面端原生应用与 Web 端两种使用形态,适配不同开发场景的使用需求。

2. 解决的问题

Termany 主要解决多编码代理并行开发场景下的系列管理痛点:一是多代理会话状态难追踪,需要频繁切换多个终端窗口查找需要关注的会话;二是不同编码代理切换成本高,Claude、Codex 等代理分散在不同终端中运行,协作流程割裂;三是同一项目多工作树运行时容易出现端口冲突,且跨工作树的代码差异、状态查看分散;四是远程开发任务在笔记本休眠后容易断连丢失,长时运行任务缺乏稳定运行环境。

3. 适用场景

Termany 最适合以下三类开发者使用:一是同时运行 5 个以上编码代理会话的开发者,可通过单窗口统一管理所有会话状态,无需在多个终端窗口间切换;二是需要在同一仓库混合使用 Claude、Codex、Gemini 等多款编码代理的开发者,可统一配置、启动和管理不同代理的会话;三是需要维护同一项目多个工作树、或需要将长时开发任务放到远程 dev box 运行的开发者,可解决端口冲突、任务断连等问题。此外,不需要使用编码代理的开发者也可将其作为功能丰富的普通终端使用。

4. 安装方式

Termany 采用 npm workspaces monorepo 架构管理依赖,本地开发安装需先克隆仓库,在项目根目录执行 npm install 即可统一安装所有模块的依赖,安装后会自动执行 postinstall 脚本修复 PTY 相关权限,保障终端功能正常使用。项目提供 macOS 平台的本地打包脚本与发布脚本,支持生成 macOS 安装包,Web 端与桌面端的具体安装方式可参考官网 termany.sh 的下载与文档说明,仓库中未明确给出其他平台的安装指引。

5. 使用方式

本地开发阶段可通过 npm run dev 命令同时启动服务端、Web 客户端、桌面端三个组件,Web 端需通过环境变量 VITE_PTY_URL、VITE_API_URL 配置服务端地址,默认连接本地 5174 端口的服务端。日常使用支持通过 ⌘P 搜索命令、页面、标签与面板,通过 ⌘E 切换面板的 Shell、文件、Git 差异、对话、浏览器等视图,通过 ⌘D、⇧⌘D 拆分面板,通过 ⌥⌘N 打开第二个同工作区窗口。内置 Claude、Codex、OpenClaw 等主流编码代理,默认启用 Claude、Codex、OpenClaw,其余代理可在设置中一键开启,也支持自定义添加代理。

6. 补充说明与实现特点

Termany 遵循本地优先、云就绪的设计原则,用户 API 密钥等敏感信息采用 BYOK(Bring Your Own Key)模式本地存储在 ~/.termany/termany.db 中,不会上传至云端。服务端模块 @termany/server 负责 PTY 进程管理、接口请求处理等核心能力,Web 客户端模块 @termany/web 提供浏览器端使用界面,桌面端模块 @termany/desktop 基于 Tauri 构建提供原生桌面体验。项目当前版本为 0.2.3,采用 AGPL-3.0 许可证,官网 termany.sh 提供下载、文档与版本更新说明。

思维导图

当前仓库信息不足,或结构不够稳定,暂时没有生成可靠的思维导图。

常见问题

Termany 支持哪些编码代理?

仓库信息显示 Termany 内置支持 Claude、Codex、Gemini、Grok Build、OpenClaw、FastClaw、Hermes、OpenCode、Cursor、Kimi、OMP 等编码代理,其中 Claude、Codex、OpenClaw 默认启用,其余代理可在设置中一键开启,也支持自定义添加代理。

Termany 的安装方式是什么?

本地开发可克隆仓库后执行 npm install 统一安装所有模块依赖,安装后会自动修复 PTY 权限;正式版本可前往官网 termany.sh 下载,仓库仅明确提供了 macOS 平台的打包脚本,其他平台安装方式未在仓库中明确给出。

Termany 是否支持远程开发?

支持,每个面板可独立配置 SSH 连接,可在单个标签页中同时运行本地 Shell 与多个远程主机的会话,解决远程开发任务断连、长时任务丢失的问题,仓库中未明确给出 SSH 连接的具体配置步骤。

Termany 的 API 密钥如何存储?

Termany 遵循本地优先设计原则,用户的模型提供商 API 密钥采用 BYOK 模式本地存储在 ~/.termany/termany.db 中,不会上传至云端,仓库中未明确给出密钥管理的具体操作界面细节。