TOMRADE

一起，向前 FORWARD, TOGETHER

任务、笔记和 Agent，都在你自己的文件夹里。

Tomrade 是为独立创作者和小团队打造的本地优先工作区。代码项目、这周的待办、日记、一摞文档，都能在同一个应用里管。说一句话，助手就把整个需求池拆好；工单交给 Claude Code 或 Codex 去做；Agent 的任何一次运行都能一键撤销。

下载 macOS（Apple 芯片）

0.1.0 版，2026年10月10日发布

全部下载:macOS（Apple 芯片） 228 MB macOS（Intel） 235 MB Windows 版 186 MB Linux 版（AppImage） 240 MB

Tomrade 看板：左侧是视图和工作流，中间是待办和进行中的工单卡片，右侧是助手面板。

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

一个工作区

不只是写代码。

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

做软件

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

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

管日常

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

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

写日记

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

Journal/2026-10-10.md

2026-10-10

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

写文档

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

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

一句话 → 需求池

从一句话到一个 PR。

01聊
用大白话说出你想要什么。Agent 会追问必要的细节，和你一起把需求理清楚。
标签页一崩，用户写的草稿就没了。
草稿要跨设备同步，还是在本机恢复就够了？
先在本机恢复就行。
02拆
拆成史诗和一个 PR 就能完成的功能，对照已有内容去重，并指出还缺什么。
史诗草稿恢复
本地自动保存草稿1 个 PR
重新打开时提示恢复1 个 PR
提交后清除草稿1 个 PR
还缺：两个标签页同时编辑同一份草稿？
03落
整棵需求树一次写入。没有审批队列：立即生效，整次运行一键撤销。
已写入 1 个史诗、3 个功能撤销本次运行
审批队列：无。效率：拉满。
04做
在工单上点「开始」，你自己的 Claude Code 或 Codex 会在独立分支上接手，边写代码边更新工单。
TOM-43本地自动保存草稿开始
Claude Code · tom-43-autosave-drafts
TOM-43 → 进行中

用撤销代替审批

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

不设审批，只留撤销。

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

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

文件与笔记

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

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

Journal/2026-10-10.md阅读编辑分屏

1# 2026-10-102登录页的日出上线了。#tomrade3[[宣传站]] 待办：4- 说清楚不只是写代码5- 把猫猫挪到插件后面6- 让大家换上自己的桌宠

2026-10-10

登录页的日出上线了。#tomrade

宣传站待办：

说清楚不只是写代码

把猫猫挪到插件后面

让大家换上自己的桌宠

反向链接 · 2

周回顾.md周五，见 [[2026-10-10]]：日出上线了。
发布清单.md宣传文案在 [[2026-10-10]] 写好了初稿。

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

设计原则

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

文件夹就是真相

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

~/Tomrade/projects/my-app/.tomrade/
├── project.json
├── state/
│   └── items.jsonl
├── log/
│   └── macbook.jsonl
└── README.md

缓存删了？没事，它自己会回来。

人的工作优先

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

优先级高已被你锁定

update_item 被拒：字段已锁定

数据已过期：读的是 v12，现在是 v13

一套工具，处处可用

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

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

模型自己选

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

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

看板、表格、依赖图

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

⌘K切换视图…

看板
表格
依赖图

接入 Agent

接入你已经在用的 Agent

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

.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.extract_tickets
tomrade.gap_analysis

工单详情面板：「开始」和「锁定」按钮、状态、优先级、阻塞它的工单、版本号和最后写入者。 — 每张工单都显示版本号和最后写入者。点「开始」就交给你的编程 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)
    }));
  }
});