Skip to content
melon95Public

About

Open-source desktop workbench for running multiple CLI coding agents (Codex, Claude Code, Gemini CLI…) side by side, each in its own PTY — with a built-in editor, shell and Git diff.

Resources

Stars

16 stars

Watchers

0 watching

Forks

Latest commit

 

History

306 Commits

Folders and files

Repository files navigation

Tandock 图标

Tandock

简体中文 · English

把 Agent、代码和变更放在同一个工作台。

macOS 14+ · Swift / SwiftUI / AppKit · Apple Silicon / Intel

下载 Tandock · 快速开始 · 从源码构建 · MIT License

Tandock 原生工作台:项目侧栏、新建会话、待办与文件面板

Tandock 是 macOS 原生多 Agent 工作台。通过独立 PTY 运行 Claude Code、Codex、Pi 或自定义 CLI,在一个窗口里管理项目和会话、查看文件、审阅 Git 变更、跟进待办。Agent 的交互保留在真实终端中。

工作台里有什么

  • 项目与会话:按项目组织会话,搜索、过滤、置顶、归档与恢复;项目也可在独立窗口中打开。Agent 可单独启停,停用保留配置和已有会话。
  • 多会话画布:支持浏览器式顶部标签页,也可最多同时显示 4 个分屏会话;切换布局和焦点时保留终端进程。
  • 可组合面板:文件、变更、待办和项目终端可同时打开,调整排列与宽度。
  • 文件与编辑:文件树、预览与固定标签、基础语法高亮、手动编辑和保存,支持 Markdown、SVG 与图片预览,处理外部文件修改冲突。
  • Git 审阅:内联 diff、目录树视图、逐块暂存、提交、分支切换及 Fetch / Pull / Push,也可查看会话检查点。
  • 待办与集成:按队列、进行中和已完成管理任务;提供 MCP 待办工具、Agent hook 与系统通知。历史搜索和用量统计依赖对应 Agent 的本地记录。
  • 需关注:汇总审批提醒(待核实)、本轮结束未读和进程异常;支持显式已读、多窗口同步及会话定位。窄窗口下可切换所有已打开的面板。
  • Skills 与 MCP:按 CLI 查看全局配置、来源路径和停用数量,在 CLI 支持的范围内启停;项目配置不在此页管理,Claude 全局 MCP 只读展示。
  • 原生外观:浅色、深色与跟随系统,中英文界面,独立调整界面、编辑器和终端字号。

文件与代码

在终端会话旁查看目录和源文件,直接完成小幅修改。

文件树与 Swift 源码基础语法高亮

Git 变更

按文件浏览差异,在工作区变更视图中暂存并提交;需要时展开目录树定位文件。

Git 变更面板中的 Swift 和 Markdown 文件差异

截图来自原生版 0.7.0 的英文界面,使用独立的 Welcome 演示项目与英文待办数据。

快速开始

  1. 从 GitHub Releases 下载原生 macOS ZIP,解压后将 Tandock.app 拖入「应用程序」。发布包为 Apple Silicon / Intel 通用版本。
  2. 安装并登录需要使用的 Agent CLI。Tandock 默认提供 Claude Code 和 Codex 配置;Pi 和其他 CLI 可在「设置 → Agent」中添加或启用检测到的配置,命令、参数和环境变量按工具要求配置。
  3. 按 ⌘O 添加本地项目目录。需要查看变更和提交时,选择 Git 仓库。
  4. 按 ⌘N,选择 Agent 开始会话;用顶部按钮打开文件、变更、待办或项目终端。
  5. 按 ⌘K 搜索会话、待办、历史内容和可用动作。正式发行版可通过 Tandock 菜单中的「检查更新」获取后续版本。

Tandock 不包含 Agent CLI、模型服务或订阅。各 Agent 的运行依赖、登录和费用由对应工具提供。

常用快捷键

快捷键 操作
⌘O 添加项目
⌘N 新建会话
⌘K 命令面板
⌘B 显示 / 隐藏项目侧栏
⌘1 / ⌘2 / ⌘3 / ⌘4 开关文件 / 变更 / 待办 / 终端面板
⌥⌘→ 显示 / 隐藏面板区
⇧⌘1 — ⇧⌘4 聚焦对应会话窗格
⌘F 搜索当前终端
⌘S 保存编辑的文件
⇧⌘O 在独立窗口打开项目

当前范围

当前维护 macOS 原生版本。编辑器定位为文件查看、基础语法高亮与手动编辑保存,不提供 LSP、语义诊断或定义跳转。新建会话中的 worktree 隔离入口尚未接入;请使用普通项目会话。

旧 Tauri 版本与原生版使用不同的更新协议,首次升级需手动安装原生版。开发包使用独立的数据目录,且不启用正式更新源。

从源码构建

需要 macOS 14 及以上、带 Swift 6 工具链的 Xcode,以及可用的 git。

git clone https://github.com/melon95/Tandock.git Tandock
cd Tandock/macos
swift test
scripts/build_and_run.sh run
命令(在 macos/ 下执行) 用途
swift test 运行 Swift 测试
scripts/build_and_run.sh build 构建并打包
scripts/build_and_run.sh run 构建并启动
scripts/build_and_run.sh verify 构建、启动并检查进程与签名

产物为 macos/dist/Tandock.app,构建日志为 macos/dist/build.log。开发版本号取自 macos/VERSION,构建编号来自 Git 提交。

默认使用本机唯一的 Apple Development 证书;没有证书时回退到 ad-hoc 签名,多个证书时需通过 DEV_SIGNING_IDENTITY 指定。开发签名不等于 Developer ID 分发签名或公证。更多开发说明见 macos/README.md。

应用使用 Swift Package 管理 SwiftTerm、swift-markdown、Sparkle 和 TOMLKit,不需要 Node 前端依赖。外部 Agent 仍需要各自的运行环境。

工程与文档

更名与升级兼容说明见 Tandock 更名说明。

路径 用途
macos/TandockApp/ SwiftUI / AppKit 界面
macos/Core/ 项目、会话、PTY、SQLite、历史、Git 与协议服务
macos/EditorSupport/ 原生编辑与语法高亮
macos/Helpers/ Swift CLI、MCP 和通知辅助程序
macos/Resources/ 应用资源、图标源数据和许可证
macos/Tests/ 单元测试与验证工具
macos/scripts/ 构建、打包、迁移与回归脚本
docs/ 功能说明、设计资料和迁移记录

历史迁移文档和 HTML 设计稿已标明参考状态;其中的旧路径、测试结果与未完成项仅对应当时环境。当前范围见产品说明,暂缓方案不作为主线待办。

License

MIT。第三方图标来源与许可见 IconSources,许可证随应用一并打包。

About

Open-source desktop workbench for running multiple CLI coding agents (Codex, Claude Code, Gemini CLI…) side by side, each in its own PTY — with a built-in editor, shell and Git diff.

Resources

Stars

16 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages