🌊 现代化块式终端

TideTerm

融合传统终端与图形化块的下一代工作站。
内置 MCP 服务器管理、AI API 代理、多会话终端，
支持 macOS · Linux · Windows 三平台。

26 Stars
Go Language
Apache-2.0 License
3 Platforms
⬇️ 下载安装 ★ 查看源码 了解特性 ↓
TideTerm — ~/workspace
❯ tideterm --version
TideTerm v0.13.1-tideterm.3
❯ wsh mcp list
claude-code ● enabled stdio
codex-cli ● enabled stdio
gemini-cli ○ disabled stdio
❯ wsh proxy status
WaveProxy listening on :3000
channels: messages(3) responses(2) gemini(1)
❯
项目概述

不只是终端，是你的全能工作站

TideTerm 是 Wave Terminal 的 fork，在保留强大终端功能的基础上，增加了 MCP 服务器管理、AI API 代理、中英双语等大量增强功能。

🔱 TideTerm 基于 Wave Terminal（Apache-2.0，Command Line Inc.）fork 开发，独立维护，与上游无关联。配置目录使用 TIDETERM_* 独立命名空间，可与 Wave 共存。
🧩
块式工作区

将终端、文件浏览、Web 预览、代码编辑器、AI Chat 等功能统一在一个可拖拽重排的块式布局中，打造高效工作流。

Block-based Workspace
🖥️
远程连接（SSH / WSL）

通过 SSH 或 WSL 连接远程主机，可在远程文件系统上浏览、预览、编辑文件，支持 wsh 远程助手自动安装与路由自愈。

Remote SSH / WSL
📋
多会话终端块

在单个终端块中创建并切换多个终端会话，会话侧栏可调整宽度并持久化，新会话自动继承当前连接和工作目录。

Multi-session Terminal
🔌
内置 MCP 服务器管理

可视化管理 MCP 服务器，支持 Claude Code / Codex CLI / Gemini CLI 的导入与同步，支持 stdio、http、sse 三种传输类型。

MCP Manager
⚡
AI API 代理（WaveProxy）

内置多通道 AI API 代理，统一路由 Claude / Codex / Gemini 请求，提供指标监控、请求历史、断路器与自动故障转移。

WaveProxy
🌐
中英文双语界面

支持 English 与简体中文两种语言，切换立即生效无需重启，完整覆盖文件面板右键菜单、远程文件菜单等区域。

i18n Bilingual
MCP 服务器管理

统一管理你的 AI 工具链

TideTerm 内置 MCP 服务器管理界面，无需手动编辑配置文件，通过图形界面即可管理 Claude Code、Codex CLI、Gemini CLI 的 MCP 服务器。

  • 新增 / 编辑 / 删除 MCP 服务器定义
  • 按应用粒度启用或禁用服务器
  • 从已安装应用一键导入 MCP 配置
  • 批量同步到多个 AI 工具（claude.json / codex / gemini）
  • 支持 stdio / http / sse 三种传输协议
~/.claude.json (同步后)
{ "mcpServers": { "filesystem": { "type": "stdio", "command": "npx", "args": [ "-y", "@modelcontextprotocol/server-filesystem", "/home/user/projects" ] }, "github": { "type": "http", "url": "http://localhost:8080" } } }
WaveProxy — AI API 代理

多通道 AI 代理，统一管理所有 API

WaveProxy 是 TideTerm 内置的 AI API 代理服务，将 Claude / Codex / Gemini 等多个 AI 服务统一通过一个端口暴露，支持多 Key 轮换、故障转移。

  • 支持 messages / responses / gemini 三类通道
  • 每通道支持多个 API Key、Base URL、优先级配置
  • 支持 x-api-key / bearer / both 三种鉴权模式
  • 兼容 OpenAI 风格路由（/v1/responses、/v1/models）
  • 内置断路器、亲和性调度、自动故障转移
  • Ping 健康检查、指标统计与请求历史查看
  • 本地通道一键同步到远程连接
~/.config/tideterm/waveproxy.json
{ "port": 3000, "accessKey": "your-proxy-key", "channels": { "messages": [ { "name": "anthropic-primary", "baseUrl": "https://api.anthropic.com", "apiKeys": ["sk-ant-..."], "authType": "x-api-key", "priority": 1 } ] } }
远程工作流

SSH 连接，像本地一样工作

TideTerm 的远程连接功能经过深度增强，wsh 助手自动安装，断网重连后会话自动恢复。

🔧
wsh Shell 扩展

首次连接自动安装 wsh 远程助手（~/.tideterm/bin/wsh），提供文件浏览、预览、远程文件右键操作等能力。临时安装失败不会永久禁用 wsh。

🔄
tmux 会话续连

远程终端默认使用 tmux 保持会话（term:remotetmuxresume=true），断网、休眠重连后无缝恢复，无需重新执行命令。

🗂️
tmux 会话管理器

可视化查看远程所有 tmux 会话，支持接入、强制接入、重命名、结束单个会话或一键全部结束，轻松管理远程工作状态。

🩹
路由自愈

如果已连接会话的 conn:* 路由丢失，TideTerm 自动重新检查、启用 wsh 并等待路由重新注册，而不是直接报错失败。

📁
拖拽路径到终端

从 Finder/Explorer 将文件拖入本机终端块，自动插入绝对路径；远程 Files 块的文件也可拖入远程终端，多文件以空格分隔。

📂
在新块中打开当前目录

终端块右键可在新 Files 块中打开当前目录，通过 OSC 序列追踪 CWD，在 tmux 中通过 OSC 透传机制确保目录可被正确识别。

快速开始

安装指南

TideTerm 提供多种安装方式，支持直接下载预编译包或从源码构建

1 前往 GitHub Releases 下载对应平台的安装包
https://github.com/sanshao85/tideterm/releases 📋
2 选择对应平台的安装包
macOS
.dmg / .zip
🐧
Linux
.AppImage / .deb
🪟
Windows
.exe Installer
3 安装并启动 TideTerm

按操作系统标准方式安装即可。首次启动时语言默认为 English，可在 Settings → General → Language 切换为简体中文。

1 克隆仓库
git clone https://github.com/sanshao85/tideterm.git && cd tideterm 📋
2 安装依赖（需要 Go + Node.js + task）
task init 📋
3 开发模式运行（热更新）
task dev 📋
4 打包构建（产物在 make/ 目录）
task package 📋
⚠️ macOS Gatekeeper 可能会提示 "应用已损坏"，这是因为未经 Apple 公证的应用会被隔离。执行以下命令解除隔离即可。
1 解除 macOS 隔离限制
sudo xattr -dr com.apple.quarantine "/Applications/TideTerm.app" 📋
2 重新打开应用即可正常使用

执行完上述命令后，双击 TideTerm.app 即可正常启动，无需重新下载。

平台支持

三平台配置路径

TideTerm 使用独立的 TIDETERM_* 环境变量，可与 Wave Terminal 共存

macOS
Data: ~/Library/Application Support/tideterm/
Config: ~/.config/tideterm/
Proxy: ~/.config/tideterm/waveproxy.json
🐧
Linux
Data: ~/.local/share/tideterm/
Config: ~/.config/tideterm/
Proxy: ~/.config/tideterm/waveproxy.json
🪟
Windows
Data: %LOCALAPPDATA%\tideterm\
Config: %USERPROFILE%\.config\tideterm\
Proxy: %USERPROFILE%\.config\tideterm\waveproxy.json

环境变量覆盖

TIDETERM_CONFIG_HOME=~/.config/tideterm
TIDETERM_DATA_HOME=~/.local/share/tideterm
技术架构

现代化技术栈

TideTerm 以 Go 为后端核心，React + Electron 构建跨平台桌面 UI

Go
TypeScript
React 19
Electron
Vite
TailwindCSS
WebGL Terminal
SQLite
WebSocket
tmux
OpenAI API compat

TideTerm vs Wave Terminal 功能对比

功能 TideTerm Wave Terminal (上游)
块式工作区（终端/文件/Web/编辑器） ✓ ✓
SSH / WSL 远程连接 ✓ 增强 ✓
多会话终端块 ✓ 新增 ✗
内置 MCP 服务器管理 ✓ 新增 ✗
AI API 代理（WaveProxy） ✓ 新增 ✗
简体中文界面 ✓ 新增 ✗
tmux 会话管理器 ✓ 新增 ✗
窗口标题自动/手动命名 ✓ 增强 △
默认禁用遥测 ✓ ✗
拖拽路径到终端 ✓ 增强 △
常见问题

FAQ

TideTerm 和 Wave Terminal 有什么关系？ ▼
TideTerm 是 Wave Terminal（Apache-2.0，Command Line Inc.）的 fork，两者完全独立运行，没有官方关联或背书关系。TideTerm 使用独立的配置目录（TIDETERM_*）和 App ID，可与 Wave Terminal 共存而互不干扰。
TideTerm 会收集用户数据吗？ ▼
不会。TideTerm 默认禁用遥测（telemetry:enabled=false）和自动更新（autoupdate:enabled=false），详见仓库中的 PRIVACY.md。你可以在设置中查看和修改这些选项。
WaveProxy 代理是否安全？ ▼
WaveProxy 运行在本机（或你指定的远程机器上），支持代理级 accessKey 认证，以及每通道的 authType 控制。你的 API Key 存储在本地配置文件（~/.config/tideterm/waveproxy.json），不会上传到任何第三方服务。
远程 wsh 安装失败怎么办？ ▼
可使用本机 CLI 手动重装：
wsh conn status
wsh conn reinstall 'user@host:port'
如果遇到 SIGKILL（退出码137），一般是远程主机内存不足，检查 dmesg 并增加资源限制后重连即可。
如何切换界面语言？ ▼
打开 Settings → General → Language，从下拉菜单中选择 English 或 简体中文。语言切换立即生效，无需重启 TideTerm。
终端渲染出现问题怎么处理？ ▼
可以尝试在设置中禁用 WebGL 渲染（term:disablewebgl）；如果整体窗口出现 GPU 相关问题，可以禁用硬件加速（window:disablehardwareacceleration）。
🌊

开始使用 TideTerm

免费开源，Apache-2.0 协议。下载安装包或从源码构建，开启下一代终端体验。

⬇️ 立即下载 ★ GitHub 仓库