工单和工作流
把结账相关的工单都挪到待办,支付那个 bug 改成紧急。
list_itemschange_status ×4update_item
已把 4 张工单挪到待办,TOM-31 改成了紧急。
TOMRADE
喵喵,喵喵 MEOW MEOW
给用编程 Agent 做东西的独立开发者和小团队
你的 Agent 负责写代码,Tomrade 记得要做什么、做到哪、改了什么。下一次会话从上一次停下的地方接着做,任何一次运行都能一键撤销。
你的 Agent 凌晨三点还在干活。它读工单、改笔记,偶尔把你所有的东西都重写一遍。Tomrade 是为它们造的工作区,顺便给你配了一个撤销键。
为什么用 Tomrade
每次会话都从零开始。
想法、工单、决定和已经做完的事,跨会话、跨 Agent 都放在一处。下一次运行从上一次停下的地方接着做。
多一个工具,就多一个要盯着的窗口。
Claude Code、Codex 或 Cursor 照旧在你自己的终端里跑。Tomrade 通过 MCP 和 git 连上它们,看板自己跟上进度。
东西被改了,是谁改的?
Agent 的每一次写入都有署名,按运行归组。一次运行改了什么,一键整个撤回:工单、笔记、设置都算。
怎么用
从一个想法到合并的 PR,就这一个循环。下面每一步都是应用里的真实画面。
用大白话说你想要什么,在电脑前或者用手机都行。它会变成看板上的一张工单,随时可以开工。
说一句「整理一下」,助手合并重复、把大单拆成一个 PR 就能做完的工单。你来挑,不满意一键撤回。
在你自己的终端里把工单号报给 Claude Code、Codex 或别的 Agent。它自己认领、在自己的分支上干活,再把进度报回来。
剩下的交给自动执行:夜里顺着依赖图一张张做,通过的就合并,早上给你一份早报。
看视频
下午冒出一个想法,Agent 们排队提问,夜里自动跑,早上收到早报。全部是应用的真实画面,没有摆拍。
Tomrade 的一天 · 1:27
一条侧栏回复所有 Agent。
笔记互相链接,架构图照着代码画。
Issue 进来,分好类,做完上线。
指向一个仓库,它找出你忘了的分支。
宠物、番茄钟、模型、主题,还有它现写给你的插件。
每段都是真实的应用,跑在演示仓库上,Agent 用的是 Claude Code。字幕中英双语。
你的 Agent 和终端
Tomrade 不替代你的 Agent,也不替代你的终端。它给它们派活、记着进度,再把状态放回看板。
Tom + comrade
是战友,不是包工头。
别的工具要么让你只能在它里面干活,要么只会把活派出去。Tomrade 两头都通:配置一次,接着在你调教好的 Claude Code 或 Codex 里、在你自己的终端里干,状态会同步回看板,项目和任务照样管得清清楚楚。
/tomrade:sync,Codex 里是 $tomrade-sync。两个方向都行:在 Tomrade 里点「开始」把工单派出去,或者自己先干、回头再同步。仓库只需连接一次,Tomrade 会提一个 PR,带上 MCP 配置和给 Agent 的说明,之后在这个仓库里干活的 Agent 都能找到 Tomrade。
接入 Agent
Tomrade 会在本机运行一个 MCP 服务。把 Claude Code、Codex、Cursor 或 Gemini CLI 指向它,它们就能列出、读取、创建和更新工单,读写你的文件,还能调整 Tomrade 的设置,规则和其他人完全一样。
{
"mcpServers": {
"tomrade": {
"type": "http",
"url": "http://127.0.0.1:19090/mcp"
}
}
}只监听 127.0.0.1,不对外网暴露。
它们能用的工具
tomrade.list_itemstomrade.get_itemtomrade.create_itemtomrade.update_itemtomrade.change_statustomrade.plan_and_applytomrade.search_filestomrade.write_filetomrade.update_settings
终端
告别在十个终端窗口间反复横跳。
在 Tomrade 自带的终端窗口里直接跑 Claude Code、Codex 或普通 shell,开发和看板不用再来回切。想怎么分屏就怎么分,每个窗格连着它的工单,哪个 Agent 在干活、哪个在等你,一眼就知道。
⌘D 向右,⇧⌘D 向下。顺手的布局存下来,新窗口直接套用。终端窗口基于 herdr,一个开源(Apache 2.0)的 Agent 终端复用器。Tomrade 的窗口只是它的一个客户端:装一次 herdr,窗口自己就能找到;同样的窗格,在任何终端里用 herdr 自带的客户端也能打开。
WindowsWindows 上,终端窗口不用 herdr,而是跑在 Tomrade 自带的终端后端上(基于 ConPTY,默认打开 PowerShell)。用起来和 macOS 上基本一样:分屏窗格、会话自动接上、每个窗格的状态提示都有,退出 Tomrade 后终端和 Agent 也会接着跑。不用另装任何东西。
看得见、撤得回
会话告诉你谁在干活、谁在等你;每一次写入都进历史,按运行归组,一键就能撤销。
会话
六个 agent 在跑,来问你的只有一个地方。
一段 agent 对话能装下整个下午:三张工单、一个问题、一处修补。Tomrade 标出每张工单从哪里开始,同一个会话在助手面板和终端窗口的格子里同时可见,等你的那几个永远排在最前面。
上图用的是内置主题「抹茶」。
跑了 18 条命令 · 测试 79 通过。用撤销代替审批
审批队列?都什么年代了。
Agent 直接写进需求池,不用等你点头。每次运行都打包记账、注明出处;哪次它放飞自我了,一键整体撤回。
历史面板按运行列出谁改了什么。
上下文跟着工作走
笔记、文件、对话和收到的反馈都挨着它们所属的工单,你和你的 Agent 都找得到。
文件与笔记
每个项目都自带一个文件夹:Markdown、HTML、图片,什么都能放。编辑器边写边预览,笔记之间可以互相链接,也能挂到工单上当交付物。
助手
它不只会拆需求池。Tomrade 里的东西它都能处理:工单和工作流、文件和笔记、设计图,连 Tomrade 自己的设置也能改。没活干的时候,陪你聊聊天也行。
把结账相关的工单都挪到待办,支付那个 bug 改成紧急。
list_itemschange_status ×4update_item
已把 4 张工单挪到待办,TOM-31 改成了紧急。
把这周的日记整理成一份周回顾。
search_filesread_file ×5write_file
读了 5 篇日记,存成「周回顾.md」,每一天都链回原文。
换成深色主题,再把猫放到桌面上。
update_settings
好了:深色主题,猫已经在你桌面上了。
我家柯基叫「饼干」还是「麻薯」好?
不调工具,不改东西,纯陪聊。
去公园各喊一遍,喊出来不尴尬的那个就是它。
它做的每处改动都会署名、记进操作历史,⌘Z 就能撤回:工单、文件、设置都一样。API 密钥、MCP 服务和命令行,始终只由你来改。
收件箱
需求池门口,有保安了。
GitHub issue 和各种反馈先落进项目的收件箱。助手先判断每一条是什么:新工单、已有的老问题,还是重复反馈,并拟好回复。你点一下确认就行。
GitHub Issues 是内置的来源。来源也是插件,客服邮箱、反馈表单都能自己接进来。
一个工作区
每个项目都是一块看板加一个文件夹。可以连上代码仓库,也可以只装下你这一周的生活。
把一个功能聊成一个个 PR 大小的工单,再交给 Claude Code 或 Codex,各自在独立分支上实现。
TOM-42本地自动保存草稿评审中TOM-43重新打开时提示恢复进行中跑腿、家务、出行计划,放进看板或表格。把脑子里的一团乱麻倒给助手,它帮你理成待办。
「今日笔记」会在日记文件夹里打开当天的一页。给日子打上标签,用 [[双链]] 把它们串起来。
Journal/2026-10-10.md
2026-10-10
沿河散步,终于把 #自行车 修好了。
Markdown 实时预览、反向链接、全文搜索。每次保存都有版本,还能同步到 GitHub 仓库。
还能这样玩
让和 Agent 一起度过的长长一天轻松一点的小东西。每一个都是插件,不想要就关掉。
带薪如厕,效率拉满。
在 Discord、Slack、Telegram、飞书、钉钉或企业微信里接一个机器人,助手会在私信和 @ 里回复你,同一个项目,同一套工具。
回答我!
桌宠跟着 Agent 的状态变:思考、干活、等你回答、做完了。也可以换成你自己的宠物,每种状态一张图。
你的深色模式暴露了你。
默认是晨曦,破晓是它的夜晚版;曙光、抹茶等也都内置。也可以自己做一套,用任意一张图片都行,还能按一天里的时间自动切换。
你的盆底肌在呼唤你。
专注 25 分钟,休息 5 分钟,还有一个浮在所有窗口上面的桌面时钟。休息时间干什么,你自己决定。
内置插件
Archify 已经内置。让助手、Claude Code 或 Codex 画一张架构图、流程图、时序图、数据流图或状态图,它会直接出现在对话里:能拖动、缩放、追踪路径,还能全屏演示。存进 Files 时连源文件一起保存,之后想改,接着说就行。
你画一下:一张工单怎么从一句话走到合并的 PR。
打开可交互版
你Tomrade 把我的东西放在哪?哪些会离开我的电脑?
打开可交互版
你Claude Code 改一张我锁定的工单,会发生什么?
打开可交互版
你画出工单状态怎么跟着 git 走。
打开可交互版
这些图都由 Tomrade 自带的 Archify 渲染,画的正是 Tomrade 自己。
Archify 是 tt-a1i 的开源项目(MIT)。第一次画图时,Tomrade 会从 GitHub 拉取一个固定版本。
每一个都是插件,不需要的话,在「设置 › 管理插件」里关掉即可。
谁卡着谁,一目了然:需求池画成一张图,还在等未完成工作的工单都会挂上标记。
每张工单都知道自己的分支、worktree 和 PR。状态跟着 git 走,点「开始」就交给编程 Agent。
通过 stdio 或 HTTP 连接任意 MCP 服务,它的工具和内置工具放在一起,助手和每个 Agent 都能用。
每次保存都是一个版本。项目文件通过 GitHub 仓库共享,仓库可以帮你找到或新建。
一份工作流菜单,完全不用模型:离线、免密钥、结果可复现。默认关闭,需要时打开。
说出你想要的插件,Agent 来写、来测;你确认这次构建之后,它才会加载。
插件
数据库、工具注册表、MCP 服务、助手,每一块都是可以替换的插件。用 Apache-2.0 授权的 SDK 写你自己的插件,用任何许可证发布;也可以让 Agent 在 Plugin Studio 里替你写。
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 服务里就都有了。

设计原则
每个项目都是一个纯文本文件夹,可读、可 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 来主导。
工作流、自定义字段和保存的视图。键盘优先,所有操作都能从命令面板找到。
⌘K切换视图…
常见问题
不是。看板、助手和文件对任何项目都适用:家务、旅行、论文、日记都行。项目连了代码仓库,编程 Agent 就能上手;没连,它们也不会来打扰你。
它们分工不同,可以一起用。那类工具负责运行 Agent、帮你审代码;Tomrade 负责记住 Agent 该做什么、每件事做到哪、改了什么。Agent 照旧在你喜欢的地方跑,通过 MCP 和 git 连上 Tomrade、认领工单,看板会跟着它们的分支和 PR 更新。
Tomrade 自己写入的、以及它让 Agent 写入的每一处改动,按运行归组:工单、Files 里的文件和笔记,还有设置。历史里列出每一次运行,撤销一次就把它改的全部恢复。它不管 Tomrade 之外的东西:仓库里的提交、分支和 PR 归 git 管,照常用 git 回退。
不必。本地 git 仓库就够了:在分支名或提交里写上工单号,工单就会跟着走。从 Tomrade 里开 PR、合并 PR 目前用的是 GitHub,Files 也可以选择同步到一个 GitHub 仓库;这两样都不是必需的。
目前是测试版。1.0 之前 Tomrade 都在开发测试中,版本之间功能会变,也会遇到不完善的地方。项目就是你电脑上的普通文件夹,重要的请自行备份。
是的。Tomrade 采用 Apache License 2.0,这是 OSI 认可的开源许可证,应用、所有包和插件 SDK 都适用。你可以使用、修改和再分发,商用也可以。源码就在 GitHub 上。
项目就在你的电脑上,每个项目一个普通文件夹。登录的话,账号里也只保存你的偏好设置和项目列表。只有当你接入模型服务或 git 远程仓库时,项目内容才会离开本机。
不需要。选「不登录,本地使用」,一切都只留在这台电脑上。登录只是为了在几台电脑之间同步偏好设置和项目列表,账号不保存任何项目内容:工单、文件和代码都留在你的项目文件夹里。
内置助手支持 DeepSeek、Anthropic、Gemini、任何 OpenAI 兼容接口以及本地模型。Claude Code 和 Codex 也可以直接驱动 Tomrade,用的是你自己的 CLI 登录。
可以,在设置里关。也可以换成你自己做的桌宠,或者把桌宠插件整个卸载。猫不会往心里去的,大概。
在路上了,下个版本就发布。等不及的话,现在就能在 Discord、Slack、Telegram、飞书、钉钉或企业微信里给助手发消息。只要电脑上的 Tomrade 在跑,它就会回;关掉所有窗口,它也能在后台接着跑。通宵是电脑的事,不是你的事。
官方口径:它只提醒你休息。非官方口径:提示音可以换成任意音频文件。懂的都懂。
macOS(Apple 芯片和 Intel)、Windows 和 Linux(AppImage)。
英文、简体中文、繁体中文、日语、西班牙语、德语、法语和俄语。
免费使用,以 Apache 2.0 开源。你的项目一直在你自己的文件夹里。
测试版 Tomrade 还在开发测试中,难免有不完善的地方,重要的项目请自行备份。
全部下载:macOS(Apple 芯片) 138 MBmacOS(Intel) 143 MBWindows 114 MBLinux x64(AppImage) 133 MBLinux Arm64(AppImage) 131 MB