willwill85/TAKT-UI-CC
willwill85/TAKT-UI-CC has 78 GitHub stars and 26 forks. GitHot measured +2 stars in 24 hours. Last checked 2026-11-18 11:57 UTC. Last push 2026-11-06.
实测星标增长
- 24小时
- +2
- 7天
- 正在收集历史
- 15天
- 正在收集历史
- 1个月
- 正在收集历史
各周期内的星标净变化,周期相互重叠,并非每日新增。缺失的测量保持空白。星标代表关注度,不代表软件质量。
关于
Multi-machine workbench for Claude Code over SSH: conversation sidebar, persistent tmux terminals, Syncthing file mirror, and a reverse-tunnelled local MCP server (macOS).
开发工具README.zh-CN.md
原文TAKT-UI-CC
为 Claude Code 打造的多机 SSH 工作台。 一个窗口管理所有 Linux 服务器:左侧项目 / 对话树、永不断线的终端、本地文件预览、双向文件同步, 以及一个远端 Claude 可以反向调用的本机 MCP 服务。
English · 使用指南 · 架构说明 · 配置项 · MCP 工具 · 安全说明

对话视图:对话内图片预览、输入框下方的 5h / 周用量环,以及类似 Codex 的模型与 effort 选择菜单。
它解决什么问题
Claude Code 最适合跑在服务器上(网络好、常驻、离数据近)。但这样你要同时开很多 SSH 窗口, 分不清哪个对话在哪台机器上,本机的工具(Blender、FreeCAD、Xcode、USB 开发板……)也够不着。TAKT-UI-CC 把这些都接起来:
| 多机一个界面 | 可连任意多台 Linux。每个项目和对话都带机器徽标(如 HOME、GPU),一眼看出在哪台。 |
| 对话侧边栏 | 项目 → 对话,直接被动扫描各服务器的 ~/.claude/projects/*.jsonl;支持重命名、删除、打标签、按机器/标签筛选。状态存在本机 SQLite,服务器离线或网络抖动时列表也不会闪烁、不会丢。 |
| 永不断线的终端 | 每个标签页 = ssh + 远端 tmux 会话。关掉应用、断网、合盖,重开就回到原会话;网络闪断自动重连。 |
| 本地文件预览 | 右侧文件树/预览读取服务器工作目录在本机的镜像(Syncthing 双向同步),图片/网页/代码秒开;支持把文件拖进终端。文件变化时目录树实时更新(服务端 fs.watch 经 SSE 推送,断线时自动轮询兜底),不用再手动刷新。 |
| 每台机器独立工作目录 | 机器 1 ↔ ~/.takt-ai/work,机器 2 ↔ ~/.takt-ai/work2 …… 各自独立的 Syncthing 文件夹。 |
| 反向 MCP 隧道 | 本机 MCP 服务(23 个工具:Blender、FreeCAD、嘉立创 EDA、Chrome、Xcode + iPhone 真机部署、USB/串口、MCU 烧录、截屏、本机 Shell……)通过 ssh -R 反向映射到每台服务器,远端的 Claude 可以操控你的本机。仅监听回环地址 + Token 鉴权。 |
| 外观设置 | 左上角 ⚙ 按钮打开设置面板:4 套主题 + 跟随系统(石墨 / 午夜 / 浅色 / 纸张)、强调色、界面 / 对话 / 终端字号、界面与等宽字体、终端行高与光标、圆角、对话宽度、减少动画。即时生效(终端同步),自动记忆。 |
| 项目标签 | 仿 Antigravity 的彩色标签(工作 / 业余 / 实验……),按标签筛选侧边栏。 |
| 状态栏 | 实时显示所有节点的 SSH 延迟、Tailscale、MCP 隧道、Syncthing 状态,一键自愈。 |
当前界面语言为简体中文。欢迎提交 i18n 改造。
架构一图流
flowchart LR
subgraph Mac["你的 Mac(客户端)"]
UI["桌面 App / 浏览器"]
WB["工作台服务 :3080\nnode-pty · SQLite · REST + WS"]
MCP["本机 MCP 服务 :18765"]
ST1["Syncthing"]
LW["~/.takt-ai/work, work2 …"]
UI <--> WB
WB --- LW
ST1 --- LW
end
subgraph L1["Linux 节点 1"]
TM1["每个标签一个 tmux 会话 → claude"]
RW1["~/work"]
ST2["Syncthing"]
ST2 --- RW1
end
WB -- "ssh -tt(终端)" --> TM1
WB -- "ssh(扫描 ~/.claude)" --> L1
MCP -. "ssh -R 18765(反向隧道)" .-> TM1
ST1 <-- "双向同步" --> ST2
环境要求
本机(Mac):
- macOS 13+(桌面 App 与多数 MCP 工具仅 macOS;Web 界面本身也可在 Linux 浏览器运行)
- Node.js ≥ 22.13(使用内置
node:sqlite):brew install node ssh,且能用密钥免密登录服务器(配置在~/.ssh/config)- Xcode 命令行工具(编译原生 App / 无预编译时编译
node-pty):xcode-select --install - 可选: Syncthing(
brew install syncthing),用于本地文件镜像
每台 Linux 服务器:
tmux、python3、curl,并为登录用户装好 Claude Code- 可选:
syncthing。可用scripts/remote-bootstrap.sh一键安装 tmux / python3 / syncthing
快速开始
git clone https://github.com/willwill85/TAKT-UI-CC.git
cd TAKT-UI-CC
bash scripts/install.sh # 检查依赖 + npm install
bash scripts/start.sh # 启动工作台 (:3080) 与本机 MCP 服务 (:18765)
open http://127.0.0.1:3080 # 或构建下方的原生 App
- 先确认
ssh my-server无需输入密码即可登录(见 使用指南)。 - 界面左上角点 节点(服务器图标)→ 从列表选一个 SSH 主机(读取自
~/.ssh/config)→ 保存。 TAKT 会自动创建本地目录、注册 Syncthing、建立 MCP 反向隧道、并在服务器上配置好 Claude Code。 - 用左上角“新建文件夹”图标建项目;鼠标悬停项目点 + 在该服务器打开终端,再点 注入终端 运行
claude(恢复历史对话则是claude -r <id>)。TAKT 不会在你背后自动启动claude,只开 tmux shell 并给出命令。
原生 macOS App(可选)
bash scripts/build-app.sh # → build/TAKT-UI-CC.app
cp -R build/TAKT-UI-CC.app /Applications/
App = WKWebView + 原生 SwiftTerm 终端,采用 ad-hoc 签名,首次打开请右键 → 打开。App 会自己拉起后台服务。
常用命令
| 命令 | 作用 |
|---|---|
npm run start:all / bash scripts/start.sh |
启动工作台 + MCP 服务(幂等;关闭终端不会杀掉服务) |
npm run stop |
停止两者并关闭 MCP 隧道(远端 tmux 会话继续运行) |
npm run doctor |
诊断本机与每个节点(ssh、tmux、claude、MCP 隧道……) |
bash scripts/remote-bootstrap.sh |
在 Linux 上安装 tmux/python3/syncthing:ssh 主机 'bash -s' < scripts/remote-bootstrap.sh |
配置(简版)
全部通过环境变量配置,默认值开箱即用。覆盖项写进 ~/.takt-ai/env(每行 KEY=value)。
| 变量 | 默认 | 含义 |
|---|---|---|
TAKT_HOME |
~/.takt-ai |
数据目录:nodes.json、SQLite、日志、各节点 work 目录、MCP Token |
TAKT_PORT |
3080 |
Web 界面 / API 端口(仅监听 127.0.0.1) |
TAKT_MCP_PORT |
18765 |
本机 MCP 服务端口(仅监听 127.0.0.1) |
TAKT_AUTO_ALLOW_HOST_EXEC |
未设置 | 设为 1 则在远端预先放行 mac_host_exec(默认每次都会询问) |
完整列表见 docs/CONFIGURATION.md。
安全模型(请务必阅读)
MCP 服务能在你的 Mac 上执行命令,因此默认做了收紧:
- 只绑定 127.0.0.1;远端节点只能通过 SSH 反向隧道访问。
/mcp需要Authorization: Bearer <token>(随机 Token 存于~/.takt-ai/mcp-token,权限 0600,并写入各节点的~/.claude.json)。- 不发送 CORS 头,每个请求校验
Host/Origin—— 浏览器里的任何网站都无法访问(防 DNS 重绑定 / CSRF)。 - 远端 Claude 的权限里,
mac_host_exec默认设为询问,除非你主动开启自动放行。 - 工作台本身同样只监听回环地址,并拒绝陌生
Host/Origin。
能以对应 SSH 用户登录某个已连接节点的人,可以访问隧道,并读取该用户 ~/.claude.json 里的 Token 来调用 MCP 工具。只连接你信任的机器。 详见 docs/SECURITY.md。
目录结构
TAKT-UI-CC/
├── config.js 共享的路径 / 端口 / Token(环境变量驱动)
├── server/
│ ├── server.js 工作台:REST API、WebSocket 终端、SQLite 状态、节点自动配置
│ ├── native-ssh-session.sh ssh + 远端 tmux 启动器(含自动重连)
│ └── public/ 单页界面 index.html + 内置 xterm.js
├── mcp-server/server.js 本机 MCP 服务 + 多节点隧道 / Syncthing 看门狗
├── desktop/ Swift 包:原生 macOS 外壳(WKWebView + SwiftTerm)
├── scripts/ install · start · stop · doctor · build-app · remote-bootstrap
├── docs/ 架构、使用指南、配置、MCP 工具、安全(含简体中文)
└── examples/nodes.example.json
排错
npm run doctor 能定位大部分问题。常见问题见 docs/zh-CN/SETUP.md#排错。
许可
MIT,见 LICENSE。内置 xterm.js(MIT);依赖 node-pty、ws、SwiftTerm(MIT)。第三方声明见 THIRD_PARTY_NOTICES.md。