TOMRADE

喵喵,喵喵 MEOW MEOW

给用编程 Agent 做东西的独立开发者和小团队

把想法交给 Agent,一路跟到合并。

你的 Agent 负责写代码,Tomrade 记得要做什么、做到哪、改了什么。下一次会话从上一次停下的地方接着做,任何一次运行都能一键撤销。

你的 Agent 凌晨三点还在干活。它读工单、改笔记,偶尔把你所有的东西都重写一遍。Tomrade 是为它们造的工作区,顺便给你配了一个撤销键。

为什么用 Tomrade

Agent 不会替你记住的事。

  1. 每次会话都从零开始。

    长期的需求池

    想法、工单、决定和已经做完的事,跨会话、跨 Agent 都放在一处。下一次运行从上一次停下的地方接着做。

  2. 多一个工具,就多一个要盯着的窗口。

    不用换工具

    Claude Code、Codex 或 Cursor 照旧在你自己的终端里跑。Tomrade 通过 MCP 和 git 连上它们,看板自己跟上进度。

  3. 东西被改了,是谁改的?

    看得见、撤得回

    Agent 的每一次写入都有署名,按运行归组。一次运行改了什么,一键整个撤回:工单、笔记、设置都算。

怎么用

聊、拆、做、合。

从一个想法到合并的 PR,就这一个循环。下面每一步都是应用里的真实画面。

  1. 01聊

    用大白话说你想要什么,在电脑前或者用手机都行。它会变成看板上的一张工单,随时可以开工。

  2. 02拆

    说一句「整理一下」,助手合并重复、把大单拆成一个 PR 就能做完的工单。你来挑,不满意一键撤回。

  3. 03做

    在你自己的终端里把工单号报给 Claude Code、Codex 或别的 Agent。它自己认领、在自己的分支上干活,再把进度报回来。

  4. 04合

    剩下的交给自动执行:夜里顺着依赖图一张张做,通过的就合并,早上给你一份早报。

看视频

一天,从头到尾。

下午冒出一个想法,Agent 们排队提问,夜里自动跑,早上收到早报。全部是应用的真实画面,没有摆拍。

Tomrade 的一天 · 1:27

  • 谁在等你

    一条侧栏回复所有 Agent。

  • 文件、笔记和架构图

    笔记互相链接,架构图照着代码画。

  • 会自己分诊的收件箱

    Issue 进来,分好类,做完上线。

  • 接管没做完的活

    指向一个仓库,它找出你忘了的分支。

  • 一切皆插件

    宠物、番茄钟、模型、主题,还有它现写给你的插件。

每段都是真实的应用,跑在演示仓库上,Agent 用的是 Claude Code。字幕中英双语。

你的 Agent 和终端

用你已有的 Agent 和终端。

Tomrade 不替代你的 Agent,也不替代你的终端。它给它们派活、记着进度,再把状态放回看板。

Tom + comrade

是战友,不是包工头。

活儿在哪干都行,账都记在 Tomrade。

别的工具要么让你只能在它里面干活,要么只会把活派出去。Tomrade 两头都通:配置一次,接着在你调教好的 Claude Code 或 Codex 里、在你自己的终端里干,状态会同步回看板,项目和任务照样管得清清楚楚。

  • 支持 MCP 的 Agent 都能接:Claude Code、Codex、Cursor、Gemini CLI、OpenCode,等等。
  • git 来记账:分支名或提交信息里写上 TOM-42,工单就跟着走到进行中、验证中、已完成。
  • 一条命令同步回来:Claude Code 里是 /tomrade:sync,Codex 里是 $tomrade-sync。
  • 从不强制:没有工单的活照样干,没人逼你先建工单。

两个方向都行:在 Tomrade 里点「开始」把工单派出去,或者自己先干、回头再同步。仓库只需连接一次,Tomrade 会提一个 PR,带上 MCP 配置和给 Agent 的说明,之后在这个仓库里干活的 Agent 都能找到 Tomrade。

接入 Agent

接入你已经在用的 Agent

Tomrade 会在本机运行一个 MCP 服务。把 Claude Code、Codex、Cursor 或 Gemini CLI 指向它,它们就能列出、读取、创建和更新工单,读写你的文件,还能调整 Tomrade 的设置,规则和其他人完全一样。

.mcp.json
{
  "mcpServers": {
    "tomrade": {
      "type": "http",
      "url": "http://127.0.0.1:19090/mcp"
    }
  }
}

只监听 127.0.0.1,不对外网暴露。

它们能用的工具

  • tomrade.list_items
  • tomrade.get_item
  • tomrade.create_item
  • tomrade.update_item
  • tomrade.change_status
  • tomrade.plan_and_apply
  • tomrade.search_files
  • tomrade.write_file
  • tomrade.update_settings
工单详情面板:「开始」和「锁定」按钮、状态、优先级、被它阻塞的工单,以及最近是谁改的。
每张工单都记着最近是谁改的,人还是 Agent。点「开始」就交给你的编程 Agent。

终端

告别在十个终端窗口间反复横跳。

终端,就开在看板旁边。

在 Tomrade 自带的终端窗口里直接跑 Claude Code、Codex 或普通 shell,开发和看板不用再来回切。想怎么分屏就怎么分,每个窗格连着它的工单,哪个 Agent 在干活、哪个在等你,一眼就知道。

  • 想怎么分就怎么分:⌘D 向右,⇧⌘D 向下。顺手的布局存下来,新窗口直接套用。
  • 会话自己连上:开始一个工单,它就出现在一个窗格里;普通终端里的 Agent 一认领工单,这个窗格就成了那张工单的会话。
  • 谁在等你,一眼看清:每个窗格的标题栏和侧栏都标着运行中、需要你还是空闲,点「继续」就能推它一把,不用离开窗口。
  • 什么都不会丢:退出 Tomrade,Agent 照样在干;重启 herdr,布局原样回来,每个 Agent 接着之前的对话。

终端窗口基于 herdr,一个开源(Apache 2.0)的 Agent 终端复用器。Tomrade 的窗口只是它的一个客户端:装一次 herdr,窗口自己就能找到;同样的窗格,在任何终端里用 herdr 自带的客户端也能打开。

WindowsWindows 上,终端窗口不用 herdr,而是跑在 Tomrade 自带的终端后端上(基于 ConPTY,默认打开 PowerShell)。用起来和 macOS 上基本一样:分屏窗格、会话自动接上、每个窗格的状态提示都有,退出 Tomrade 后终端和 Agent 也会接着跑。不用另装任何东西。

看得见、撤得回

每个 Agent 做了什么都看得见,哪次运行都撤得回。

会话告诉你谁在干活、谁在等你;每一次写入都进历史,按运行归组,一键就能撤销。

会话

六个 agent 在跑,来问你的只有一个地方。

一个会话,每张工单各归各位。

一段 agent 对话能装下整个下午:三张工单、一个问题、一处修补。Tomrade 标出每张工单从哪里开始,同一个会话在助手面板和终端窗口的格子里同时可见,等你的那几个永远排在最前面。

上图用的是内置主题「抹茶」。

  • 按章节读,不用翻到底。agent 认领一张工单,就有一条分隔线标出这张单从哪开始;它跑的命令和测试收成一行:跑了 18 条命令 · 测试 79 通过。
  • 一个窗格,两处都能看。终端窗口格子里的会话,在助手面板里也打得开。在哪边打字、允许或回答都行,另一边同步显示,还注明是从哪边来的。
  • 等你的排第一。会话栏按等你、运行中、完成筛选,用大白话说它在等什么:「想运行 git push」。就地允许,或者在菜单栏里点。
  • 按工单回看。结束的会话先给结论,对话能按工单筛,每个窗格都留着时间线,连你在两段会话之间手动做的事也在。

用撤销代替审批

审批队列?都什么年代了。

不设审批,只留撤销。

Agent 直接写进需求池,不用等你点头。每次运行都打包记账、注明出处;哪次它放飞自我了,一键整体撤回。

历史面板按运行列出谁改了什么。

上下文跟着工作走

上下文跟着工单走。

笔记、文件、对话和收到的反馈都挨着它们所属的工单,你和你的 Agent 都找得到。

文件与笔记

看板旁边,就是你的笔记本。

每个项目都自带一个文件夹:Markdown、HTML、图片,什么都能放。编辑器边写边预览,笔记之间可以互相链接,也能挂到工单上当交付物。

  • [[双链]] 和反向链接。笔记改名,链接自动跟着改。
  • #标签 和全文搜索,覆盖每一个文件。
  • 今日笔记:一键打开日记里当天的那一页。
  • 阅读、编辑、分屏三种模式,预览随编辑同步滚动。
  • 每次保存都有版本,可同步到你指定的 GitHub 仓库。
  • 文件能挂到工单上当交付物,Agent 也能搜索你的笔记。

助手

Tomrade 里的事,都能问它。

它不只会拆需求池。Tomrade 里的东西它都能处理:工单和工作流、文件和笔记、设计图,连 Tomrade 自己的设置也能改。没活干的时候,陪你聊聊天也行。

工单和工作流

把结账相关的工单都挪到待办,支付那个 bug 改成紧急。

list_itemschange_status ×4update_item

已把 4 张工单挪到待办,TOM-31 改成了紧急。

文件和笔记

把这周的日记整理成一份周回顾。

search_filesread_file ×5write_file

读了 5 篇日记,存成「周回顾.md」,每一天都链回原文。

Tomrade 自己

换成深色主题,再把猫放到桌面上。

update_settings

好了:深色主题,猫已经在你桌面上了。

或者就聊聊

我家柯基叫「饼干」还是「麻薯」好?

不调工具,不改东西,纯陪聊。

去公园各喊一遍,喊出来不尴尬的那个就是它。

它做的每处改动都会署名、记进操作历史,⌘Z 就能撤回:工单、文件、设置都一样。API 密钥、MCP 服务和命令行,始终只由你来改。

收件箱

需求池门口,有保安了。

反馈先在门口等着,不直接塞进需求池。

GitHub issue 和各种反馈先落进项目的收件箱。助手先判断每一条是什么:新工单、已有的老问题,还是重复反馈,并拟好回复。你点一下确认就行。

  • 接受为工单、并入已有工单,或者按「不做」「重复」关闭。助手只给建议,拍板的是你。
  • 同一个问题再被报一次,会记在它的工单上,大家反复踩的坑一眼就看得出。
  • 反馈人在哪儿提的,就在哪儿收到回音:issue 下的回复,工单发版后还能顺手关掉 issue。

GitHub Issues 是内置的来源。来源也是插件,客服邮箱、反馈表单都能自己接进来。

一个工作区

不只是写代码。

每个项目都是一块看板加一个文件夹。可以连上代码仓库,也可以只装下你这一周的生活。

做软件

把一个功能聊成一个个 PR 大小的工单,再交给 Claude Code 或 Codex,各自在独立分支上实现。

  • TOM-42本地自动保存草稿评审中
  • TOM-43重新打开时提示恢复进行中

管日常

跑腿、家务、出行计划,放进看板或表格。把脑子里的一团乱麻倒给助手,它帮你理成待办。

  • 续签护照
  • 约牙医
  • 规划周六爬山

写日记

「今日笔记」会在日记文件夹里打开当天的一页。给日子打上标签,用 [[双链]] 把它们串起来。

Journal/2026-10-10.md

2026-10-10

沿河散步,终于把 #自行车 修好了。

写文档

Markdown 实时预览、反向链接、全文搜索。每次保存都有版本,还能同步到 GitHub 仓库。

  • 入职指南.md3 条反向链接
  • 定价.md
  • 路线图.md

还能这样玩

工作很严肃,Tomrade 不必。

让和 Agent 一起度过的长长一天轻松一点的小东西。每一个都是插件,不想要就关掉。

  • 带薪如厕,效率拉满。

    用手机给它发消息

    在 Discord、Slack、Telegram、飞书、钉钉或企业微信里接一个机器人,助手会在私信和 @ 里回复你,同一个项目,同一套工具。

  • 回答我!

    盯着 Agent 干活的猫

    桌宠跟着 Agent 的状态变:思考、干活、等你回答、做完了。也可以换成你自己的宠物,每种状态一张图。

  • 你的深色模式暴露了你。

    内置主题,外加你自己的

    默认是晨曦,破晓是它的夜晚版;曙光、抹茶等也都内置。也可以自己做一套,用任意一张图片都行,还能按一天里的时间自动切换。

  • 你的盆底肌在呼唤你。

    状态栏里的番茄钟

    专注 25 分钟,休息 5 分钟,还有一个浮在所有窗口上面的桌面时钟。休息时间干什么,你自己决定。

内置插件

一句话,画出设计图。

Archify 已经内置。让助手、Claude Code 或 Codex 画一张架构图、流程图、时序图、数据流图或状态图,它会直接出现在对话里:能拖动、缩放、追踪路径,还能全屏演示。存进 Files 时连源文件一起保存,之后想改,接着说就行。

这些图都由 Tomrade 自带的 Archify 渲染,画的正是 Tomrade 自己。

  • 五种图:架构、流程、时序、数据流、生命周期。
  • 一个自包含的 HTML 页面:拖动、缩放、追踪路径、全屏演示。
  • 每次渲染都自动检查:方框不重叠、连线不交叉、文字不截断。
  • 保留 JSON 源文件,下次提修改是在原图上改,不用推倒重画。

Archify 是 tt-a1i 的开源项目(MIT)。第一次画图时,Tomrade 会从 GitHub 拉取一个固定版本。

盒子里还有

每一个都是插件,不需要的话,在「设置 › 管理插件」里关掉即可。

  • 依赖图

    谁卡着谁,一目了然:需求池画成一张图,还在等未完成工作的工单都会挂上标记。

  • 代码关联

    每张工单都知道自己的分支、worktree 和 PR。状态跟着 git 走,点「开始」就交给编程 Agent。

  • MCP 客户端

    通过 stdio 或 HTTP 连接任意 MCP 服务,它的工具和内置工具放在一起,助手和每个 Agent 都能用。

  • 文件同步到 GitHub

    每次保存都是一个版本。项目文件通过 GitHub 仓库共享,仓库可以帮你找到或新建。

  • 脚本引擎

    一份工作流菜单,完全不用模型:离线、免密钥、结果可复现。默认关闭,需要时打开。

  • Plugin Studio

    说出你想要的插件,Agent 来写、来测;你确认这次构建之后,它才会加载。

插件

一切皆插件,包括你写的

数据库、工具注册表、MCP 服务、助手,每一块都是可以替换的插件。用 Apache-2.0 授权的 SDK 写你自己的插件,用任何许可证发布;也可以让 Agent 在 Plugin Studio 里替你写。

src/index.ts
import { definePlugin, defineTool } from "@tomradex/plugin-sdk";
import { z } from "zod";

export default definePlugin({
  inject: ["items", "tools"],
  async apply(ctx) {
    await ctx.tools.register(defineTool({
      name: "stale_list_items",
      title: "List stale items",
      description: "Open issues untouched for two weeks.",
      input: z.object({ projectId: z.string() }),
      execute: async ({ projectId }) =>
        (await ctx.items.list({ projectId }))
          .filter((i) => Date.now() - i.updatedAt > 14 * 86_400_000)
    }));
  }
});

注册一次工具,助手和 MCP 服务里就都有了。

设置对话框,列出 Tomrade 的各个模块以及提供它们的插件。

设计原则

让 Agent 跑得快,又不踩到你。

文件夹就是真相

每个项目都是一个纯文本文件夹,可读、可 diff、可备份。数据库只是缓存。

~/Tomrade/projects/my-app/.tomrade/
├── project.json
├── state/
│   └── items.jsonl
├── log/
│   └── macbook.jsonl
└── README.md
缓存删了?没事,它自己会回来。

人的工作优先

每次 AI 写入都记录出处和版本。你锁定的字段不会被覆盖,基于过期数据的写入一律拒绝,不管是谁发的。

优先级高已被你锁定

update_item 被拒:字段已锁定

数据已过期:读的是 v12,现在是 v13

动手之前,先问你

Shell 命令会等你选「允许一次」「本轮都允许」或「拒绝」。编码代理按你点 Start 时选的权限运行。API Key、MCP 服务器和命令行设置,永远轮不到 Agent 来改。

一套工具,处处可用

应用内的助手和编辑器里的 Agent 调用的是同一套工具。加一次工具,所有地方都能用。

应用内助手tomrade.*你的编辑器

模型自己选

DeepSeek、Anthropic、Gemini、任何 OpenAI 兼容接口或本地模型都行,也可以让你自己的 Claude Code 或 Codex CLI 来主导。

  • DeepSeek
  • Anthropic
  • OpenAI-compatible
  • 本地模型
  • Claude Code
  • Codex

看板、表格、依赖图

工作流、自定义字段和保存的视图。键盘优先,所有操作都能从命令面板找到。

⌘K切换视图…

  • 看板
  • 表格
  • 依赖图

许可证

免费使用,Apache 2.0 开源

Tomrade 采用 Apache License 2.0 开源,应用、所有包和插件 SDK 都一样。代码就在 GitHub 上。它还在开发测试阶段,代码每周都在变。

  • 可以使用、修改和再分发,个人和工作中都行,商用也可以。
  • 一份许可证管全部:应用、所有包和 SDK。
  • 插件归你所有,可以用任何许可证发布,商业许可证也行。
  • 唯一不授予的:Tomrade 的名称和标志。

常见问题

常见问题

Tomrade 只适合程序员吗?

不是。看板、助手和文件对任何项目都适用:家务、旅行、论文、日记都行。项目连了代码仓库,编程 Agent 就能上手;没连,它们也不会来打扰你。

我已经在用 Orca、Cursor 或别的 Agent 工具了,还需要 Tomrade 吗?

它们分工不同,可以一起用。那类工具负责运行 Agent、帮你审代码;Tomrade 负责记住 Agent 该做什么、每件事做到哪、改了什么。Agent 照旧在你喜欢的地方跑,通过 MCP 和 git 连上 Tomrade、认领工单,看板会跟着它们的分支和 PR 更新。

撤销能撤到哪一步?

Tomrade 自己写入的、以及它让 Agent 写入的每一处改动,按运行归组:工单、Files 里的文件和笔记,还有设置。历史里列出每一次运行,撤销一次就把它改的全部恢复。它不管 Tomrade 之外的东西:仓库里的提交、分支和 PR 归 git 管,照常用 git 回退。

必须用 GitHub 吗?

不必。本地 git 仓库就够了:在分支名或提交里写上工单号,工单就会跟着走。从 Tomrade 里开 PR、合并 PR 目前用的是 GitHub,Files 也可以选择同步到一个 GitHub 仓库;这两样都不是必需的。

Tomrade 现在能日常使用吗?

目前是测试版。1.0 之前 Tomrade 都在开发测试中,版本之间功能会变,也会遇到不完善的地方。项目就是你电脑上的普通文件夹,重要的请自行备份。

Tomrade 是开源的吗?

是的。Tomrade 采用 Apache License 2.0,这是 OSI 认可的开源许可证,应用、所有包和插件 SDK 都适用。你可以使用、修改和再分发,商用也可以。源码就在 GitHub 上。

我的数据存在哪里?

项目就在你的电脑上,每个项目一个普通文件夹。登录的话,账号里也只保存你的偏好设置和项目列表。只有当你接入模型服务或 git 远程仓库时,项目内容才会离开本机。

需要注册账号吗?

不需要。选「不登录,本地使用」,一切都只留在这台电脑上。登录只是为了在几台电脑之间同步偏好设置和项目列表,账号不保存任何项目内容:工单、文件和代码都留在你的项目文件夹里。

支持哪些 AI 模型?

内置助手支持 DeepSeek、Anthropic、Gemini、任何 OpenAI 兼容接口以及本地模型。Claude Code 和 Codex 也可以直接驱动 Tomrade,用的是你自己的 CLI 登录。

猫可以关掉吗?

可以,在设置里关。也可以换成你自己做的桌宠,或者把桌宠插件整个卸载。猫不会往心里去的,大概。

有手机 App 吗?

在路上了,下个版本就发布。等不及的话,现在就能在 Discord、Slack、Telegram、飞书、钉钉或企业微信里给助手发消息。只要电脑上的 Tomrade 在跑,它就会回;关掉所有窗口,它也能在后台接着跑。通宵是电脑的事,不是你的事。

番茄钟会提醒我提肛吗?

官方口径:它只提醒你休息。非官方口径:提示音可以换成任意音频文件。懂的都懂。

支持哪些平台?

macOS(Apple 芯片和 Intel)、Windows 和 Linux(AppImage)。

界面支持哪些语言?

英文、简体中文、繁体中文、日语、西班牙语、德语、法语和俄语。

Tomrade 和 Orca、Cursor 等 Agent 工具怎么分工 →

多交付,少审批。

免费使用,以 Apache 2.0 开源。你的项目一直在你自己的文件夹里。