claudeers.
// MCP Servers

TAKT-UI-CC

Multi-machine workbench for Claude Code over SSH: conversation sidebar, persistent tmux terminals, Syncthing file mirror, and a reverse-tunnelled local MCP s…

// MCP Servers[ cli ][ api ][ desktop ][ web ][ claude ]#claude#claude-code#macos#mcp#ssh#syncthing#terminal#tmux#mcp-servers◷ MIT$open-sourceupdated 14 days ago

Install with your AI

Paste into Claude Code, Cursor, or any agent — it reads the repo and wires the tool into your project.

Install and set up TAKT-UI-CC (git-clone project) into my current project.
Found on https://claudeers.com/takt-ui-cc
Repo: https://github.com/willwill85/TAKT-UI-CC
Homepage/docs: —
Detected install method: git-clone → git clone https://github.com/willwill85/TAKT-UI-CC
Category: mcp-servers. Platforms: cli, api, desktop, web.
Read the repo's README for exact setup and env vars, then install it and wire it into my project.

Claudeers Health Verdict:
unknown; community-verified: false. Confirm the source before running anything.
// or clone
git clone https://github.com/willwill85/TAKT-UI-CC

// compatibility

Platformscli, api, desktop, web
Operating systems—
AI compatibilityclaude
LicenseMIT
Pricingopen-source
LanguageHTML

Get your FREE $2.50 API credits to access TickAtlas financial data ↗

TAKT-UI-CC

A multi-machine workbench for Claude Code over SSH. One window for all your Linux servers: projects & conversations in a sidebar, persistent terminals, local file preview, two-way file sync — and a local MCP server your remote Claude can call back into.

简体中文 · Setup guide · Architecture · Configuration · MCP tools · Security

TAKT-UI-CC screenshot

Chat view: inline image previews, 5h / weekly usage rings and a Codex-style model & effort picker under the composer.

The UI language is currently Chinese (简体中文). All code, configuration and docs are in English/Chinese; contributions that add an i18n layer are very welcome.


Why

Claude Code runs best on a server (good network, always on, close to your data). But then you juggle SSH windows, lose track of which conversation lives on which machine, and your local tools (Blender, FreeCAD, Xcode, USB boards…) are out of reach. TAKT-UI-CC fixes that:

Many machines, one UIConnect any number of Linux hosts. Every project and conversation is tagged with the machine it lives on (HOME, GPU, …).
Conversation sidebarProjects → conversations, discovered passively from each server's ~/.claude/projects/*.jsonl. Rename, delete, tag, filter by machine or tag. Backed by a local SQLite database, so the list never flickers or loses entries when a server is offline.
Immortal terminalsEvery tab is ssh + a remote tmux session. Close the app, lose Wi-Fi, reboot your laptop — reopen and you are back in the same session. Auto-reconnect on network drops.
Local file previewThe right-hand file tree and preview read the local mirror of the server's work folder (kept in sync by Syncthing), so opening images/HTML/code is instant and works even if the server is slow. Drag files in/out of the terminal. The tree updates live as files change (server-sent events backed by fs.watch, with a polling fallback).
Per-machine work foldersMachine 1 ↔ ~/.takt-ai/work, machine 2 ↔ ~/.takt-ai/work2, … each with its own Syncthing folder.
Reverse MCP tunnelA local MCP server (23 tools: Blender, FreeCAD, EasyEDA/JLC EDA, Chrome, Xcode + iPhone deploy, USB/serial, MCU flashing, screen capture, host shell…) is reverse-tunnelled (ssh -R) to every node, so Claude running remotely can drive your machine. Protected by a token, loopback-only.
Appearance settingsThe ⚙ button (top-left) opens a settings panel: 4 themes + follow-system (Graphite / Midnight / Light / Paper), accent colour, UI / chat / terminal font sizes, UI and monospace font families, terminal line-height and cursor, corner radius, chat width, reduced motion. Applies instantly (terminals included) and is remembered.
Project tagsAntigravity-style colour tags to group projects (Work / Side project / ML …) and filter the sidebar.
Status barLive SSH latency, Tailscale, MCP tunnel and Syncthing state across all nodes, with one-click tunnel self-heal.

How it fits together

flowchart LR
  subgraph Mac["Your Mac (client)"]
    UI["Desktop app / browser\n(WKWebView + xterm.js)"]
    WB["Workbench server :3080\nnode-pty · SQLite · REST + WS"]
    MCP["Local MCP server :18765\nBlender · FreeCAD · Xcode · USB …"]
    ST1["Syncthing"]
    LW["~/.takt-ai/work, work2 …"]
    UI <--> WB
    WB --- LW
    ST1 --- LW
  end
  subgraph L1["Linux node 1"]
    TM1["tmux session per tab\n→ claude"]
    RW1["~/work"]
    ST2["Syncthing"]
    ST2 --- RW1
  end
  subgraph L2["Linux node 2"]
    TM2["tmux …"]
  end
  WB -- "ssh -tt (terminal)" --> TM1
  WB -- "ssh (scan ~/.claude)" --> L1
  MCP -. "ssh -R 18765 (reverse tunnel)" .-> TM1
  ST1 <-- "two-way sync" --> ST2
  WB --> L2

More detail: docs/ARCHITECTURE.md.

Requirements

On your Mac (client):

  • macOS 13+ (the desktop app and most MCP tools are macOS-only; the web UI itself also runs on Linux in a browser)
  • Node.js ≥ 22.13 (uses the built-in node:sqlite) — brew install node
  • ssh with key-based login to your servers (entries in ~/.ssh/config)
  • Xcode command line tools (only to build the native app / compile node-pty when no prebuild exists): xcode-select --install
  • Optional: Syncthing (brew install syncthing) for the local file mirror

On each Linux server:

  • tmux, python3, curl, and Claude Code installed for the SSH user
  • Optional: syncthing — a helper script installs tmux/python3/syncthing for you: scripts/remote-bootstrap.sh

Quick start

git clone https://github.com/willwill85/TAKT-UI-CC.git
cd TAKT-UI-CC

bash scripts/install.sh          # checks prerequisites + npm install
bash scripts/start.sh            # starts the workbench (:3080) and the local MCP server (:18765)
open http://127.0.0.1:3080       # or build the native app below
  1. Make sure ssh my-server logs in without a password prompt (see SETUP).
  2. In the UI click the 节点 (Nodes) button (server icon, top-left) → pick your SSH host from the list (read from ~/.ssh/config) → Save. TAKT creates the local folder, registers it with Syncthing, opens the MCP reverse tunnel and configures Claude Code on the server — automatically.
  3. Create a project with the folder-plus icon (top-left), hover a project and click + to open a terminal on that server, then press 注入终端 to run claude (resumed conversations use claude -r <id>). TAKT never starts claude behind your back — it only opens a shell in tmux and offers the command.

Native macOS app (optional)

bash scripts/build-app.sh                       # → build/TAKT-UI-CC.app
cp -R build/TAKT-UI-CC.app /Applications/

The app is a WKWebView + native SwiftTerm terminal. It is ad-hoc signed, so on first launch use right-click → Open. It starts the background services itself.

Everyday commands

CommandWhat it does
npm run start:all / bash scripts/start.shStart workbench + MCP server (idempotent, survives closing the terminal)
npm run stopStop both and close the MCP tunnels (remote tmux sessions keep running)
npm run doctorDiagnose local setup and every node (ssh, tmux, claude, MCP tunnel…)
bash scripts/remote-bootstrap.shInstall tmux/python3/syncthing on a Linux server (ssh host 'bash -s' < scripts/remote-bootstrap.sh)

Configuration (short)

Everything is driven by environment variables; defaults work out of the box. Put overrides in ~/.takt-ai/env (KEY=value per line).

VariableDefaultMeaning
TAKT_HOME~/.takt-aiData dir: nodes.json, SQLite DB, logs, per-node work folders, MCP token
TAKT_PORT3080Web UI / API port (bound to 127.0.0.1)
TAKT_MCP_PORT18765Local MCP server port (bound to 127.0.0.1)
TAKT_AUTO_ALLOW_HOST_EXEC(unset)Set to 1 to pre-approve the mac_host_exec tool on remotes (otherwise Claude asks every time)

Full list: docs/CONFIGURATION.md.

Security model (read this)

The MCP server can run commands on your Mac, so it is locked down by default:

  • Binds to 127.0.0.1 only; remote nodes reach it exclusively through the SSH reverse tunnel.
  • /mcp requires Authorization: Bearer <token> (random token in ~/.takt-ai/mcp-token, mode 0600, written into each node's ~/.claude.json).
  • No CORS headers, Host/Origin validation on every request — websites in your browser cannot talk to it (DNS-rebinding / CSRF safe).
  • mac_host_exec is set to ask in the remote's Claude permissions unless you opt in.
  • The workbench itself also only listens on loopback and rejects foreign Host/Origin.

Anyone who can log in to a connected Linux node as the SSH user can reach the tunnel and (with the token, which is readable from that user's ~/.claude.json) call MCP tools. Only connect machines you trust. Details: docs/SECURITY.md.

Repository layout

TAKT-UI-CC/
├── config.js                 shared paths/ports/token (env-driven)
├── server/
│   ├── server.js             workbench: REST API, WebSocket terminals, SQLite state, node provisioning
│   ├── native-ssh-session.sh ssh + remote tmux launcher with auto-reconnect
│   └── public/               single-page UI (index.html) + vendored xterm.js
├── mcp-server/server.js      local MCP server + multi-node tunnel/Syncthing watchdog
├── desktop/                  Swift package: native macOS shell (WKWebView + SwiftTerm)
├── scripts/                  install · start · stop · doctor · build-app · remote-bootstrap
├── docs/                     architecture, setup, configuration, MCP tools, security (+ 简体中文)
└── examples/nodes.example.json

Troubleshooting

npm run doctor finds most problems. Common ones: docs/SETUP.md#troubleshooting.

Credits & licence

MIT — see LICENSE. Bundles xterm.js (MIT); uses node-pty, ws and SwiftTerm (MIT). Third-party notices: THIRD_PARTY_NOTICES.md.

// faq

What is TAKT-UI-CC?

Multi-machine workbench for Claude Code over SSH: conversation sidebar, persistent tmux terminals, Syncthing file mirror, and a reverse-tunnelled local MCP server (macOS).. It is open-source on GitHub.

Is TAKT-UI-CC free to use?

TAKT-UI-CC is open-source under the MIT license, so it is free to use.

What category does TAKT-UI-CC belong to?

TAKT-UI-CC is listed under mcp-servers in the Claudeers registry of Claude-compatible tools.

23 views
★ 18 stars
unclaimed
updated 14 days ago

// embed badge

TAKT-UI-CC on Claudeers
[![Claudeers](https://claudeers.com/api/badge/takt-ui-cc.svg)](https://claudeers.com/takt-ui-cc)

// retro hit counter

TAKT-UI-CC hit counter
[![Hits](https://claudeers.com/api/counter/takt-ui-cc.svg)](https://claudeers.com/takt-ui-cc)

// reviews

// guestbook

0/500

// related in MCP Servers

🔓

f.k.a. Awesome ChatGPT Prompts. Share, discover, and collect prompts from the community. Free and open source — self-host for your organization with complete…

// mcp-serversf/⟨HTML⟩★ 177,810◷ NOASSERTION[ claude ]
🔓

A cross-platform desktop All-in-One assistant for Claude Code, Codex, OpenCode, OpenClaw, Gemini CLI & Hermes Agent. Only official website: ccswitch.io

// mcp-serversfarion1231/⟨Rust⟩★ 155,814◷ MIT[ claude ]
🔓

🪨 why use many token when few token do trick — Claude Code skill that cuts 65% of tokens by talking like caveman

// mcp-serversJuliusBrussee/⟨JavaScript⟩★ 117,780◷ MIT[ claude ]
🔓

An open-source AI agent that brings the power of Gemini directly into your terminal.

// mcp-serversgoogle-gemini/⟨TypeScript⟩★ 108,744◷ Apache-2.0[ claude ]
→ see how TAKT-UI-CC connects across the ecosystem