工單和工作流
把結帳相關的工單都移到待辦，付款那個 bug 改成緊急。
list_itemschange_status ×4update_item
已把 4 張工單移到待辦，TOM-31 改成了緊急。
TOMRADE
喵喵，喵喵 MEOW MEOW
給用程式 Agent 做東西的獨立開發者和小團隊
把想法交給 Agent，一路跟到合併。
你的 Agent 負責寫程式，Tomrade 記得要做什麼、做到哪、改了什麼。下一次會話從上一次停下的地方接著做，任何一次執行都能一鍵復原。
你的 Agent 凌晨三點還在工作。它讀工單、改筆記，偶爾把你所有的東西都重寫一遍。Tomrade 是為它們打造的工作區，順便給你配了一顆復原鍵。
為什麼用 Tomrade
Agent 不會替你記住的事。
每次會話都從零開始。
長期的需求池
想法、工單、決定和已經做完的事，跨會話、跨 Agent 都放在同一處。下一次執行從上一次停下的地方接著做。
多一個工具，就多一個要盯著的視窗。
不用換工具
Claude Code、Codex 或 Cursor 照舊在你自己的終端機裡跑。Tomrade 透過 MCP 和 git 連上它們，看板自己跟上進度。
東西被改了，是誰改的？
看得見、復原得了
Agent 的每一次寫入都有署名，按執行歸組。一次執行改了什麼，一鍵整個復原：工單、筆記、設定都算。
運作方式
聊、拆、做、合。
從一個想法到合併的 PR，就這一個循環。下面每一步都是 App 裡的真實畫面。
01聊
用大白話說你想要什麼，在電腦前或用手機都行。它會變成看板上的一張工單，隨時可以開工。
02拆
說一句「整理一下」，助理合併重複、把大單拆成一個 PR 就能做完的工單。你來挑，不滿意一鍵復原。
03做
在你自己的終端機裡把工單號報給 Claude Code、Codex 或別的 Agent。它自己認領、在自己的分支上工作，再把進度回報。
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 來記帳：分支名稱或 commit 訊息裡寫上 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 的設定，規則和其他人完全一樣。
{
"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向下。順手的版面存起來，新視窗直接套用。 - 工作階段自己連上：開始一張工單，它就出現在一個窗格裡；一般終端機裡的 Agent 一認領工單，這個窗格就成了那張工單的工作階段。
- 誰在等你，一眼看清：每個窗格的標題列和側欄都標著執行中、需要你還是閒置，按「繼續」就能推它一把，不必離開視窗。
- 什麼都不會丟：結束 Tomrade，Agent 照樣在做；重啟 herdr，版面原樣回來，每個 Agent 接著先前的對話。
終端機視窗建構於 herdr 之上，一個開源（Apache 2.0）的 Agent 終端多工器。Tomrade 的視窗只是它的一個用戶端：裝一次 herdr，視窗自己就找得到；同樣的窗格，在任何終端機裡用 herdr 自帶的用戶端也能打開。
Windows在 Windows 上，終端機視窗不用 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 自己的設定也能改。沒事做的時候，陪你聊聊天也行。
檔案和筆記
把這週的日記整理成一份每週回顧。
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、Feishu、DingTalk 或 WeCom 裡接一個機器人，助理會在私訊和 @ 裡回覆你，同一個專案，同一套工具。
回答我！
盯著 Agent 工作的貓
桌寵跟著 Agent 的狀態變：思考、工作、等你回答、做完了。也可以換成你自己的寵物，每種狀態一張圖。
你的深色模式，出賣了你的個性。
內建主題，加上你自己的
預設是晨曦，破曉是它的夜晚版；曙光、抹茶等也都內建。也可以自己做一套，用任何一張圖片都行，還能依一天裡的時間自動切換。
你的骨盆底肌來電了。
狀態列裡的番茄鐘
專注 25 分鐘，休息 5 分鐘，還有一個浮在所有視窗上面的桌面時鐘。休息時間做什麼，你自己決定。
內建外掛
一句話，畫出設計圖。
Archify 已經內建。請助理、Claude Code 或 Codex 畫一張架構圖、流程圖、循序圖、資料流程圖或狀態圖，它會直接出現在對話裡：能拖曳、縮放、追蹤路徑，還能全螢幕簡報。存進 Files 時連原始檔一起儲存，之後想改，接著說就行。
你畫一下：一張工單怎麼從一句話走到合併的 PR。
開啟互動版
你Tomrade 把我的東西放在哪？哪些會離開我的電腦？
開啟互動版
你Claude Code 改一張我鎖定的工單，會發生什麼事？
開啟互動版
你畫出工單狀態怎麼跟著 git 走。
開啟互動版
這些圖都由 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 裡幫你寫。
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 伺服器裡就都有了。
設計原則
讓 Agent 跑得快，又不踩到你。
資料夾就是真相
每個專案都是一個純文字資料夾，可讀、可 diff、可備份。資料庫只是快取。
~/Tomrade/projects/my-app/.tomrade/
├── project.json
├── state/
│ └── items.jsonl
├── log/
│ └── macbook.jsonl
└── README.md快取刪了？沒關係，它自己會回來。人的工作優先
每次 AI 寫入都記錄出處和版本。你鎖定的欄位不會被覆寫，基於過期資料的寫入一律拒絕，不管是誰送的。
優先順序高已被你鎖定
update_item 被拒：欄位已鎖定
資料已過期：讀到的是 v12，現在是 v13
動手之前，先問你
Shell 指令會等你選「允許一次」「本輪都允許」或「拒絕」。程式 Agent 依你按下「開始」時選的權限執行。API 金鑰、MCP 伺服器和命令列設定，永遠輪不到 Agent 來改。
一套工具，處處可用
App 內的助理和編輯器裡的 Agent 呼叫的是同一套工具。加一次工具，所有地方都能用。
App 內助理
tomrade.*你的編輯器模型自己選
DeepSeek、Anthropic、Gemini、任何 OpenAI 相容端點或本機模型都行，也可以讓你自己的 Claude Code 或 Codex CLI 來主導。
- DeepSeek
- Anthropic
- OpenAI-compatible
- 本機模型
- Claude Code
- Codex
看板、表格、相依圖
工作流、自訂欄位和儲存的檢視。鍵盤優先，所有操作都能從指令面板找到。
⌘K切換檢視…
- 看板
- 表格
- 相依圖
常見問題
常見問題
Tomrade 只適合程式設計師嗎？
不是。看板、助理和檔案適用於任何專案：家務、旅行、論文、日記都行。專案連了程式碼儲存庫，程式 Agent 就能上手；沒連，它們也不會來打擾你。
我已經在用 Orca、Cursor 或別的 Agent 工具了，還需要 Tomrade 嗎？
它們分工不同，可以一起用。那類工具負責執行 Agent、幫你審程式碼；Tomrade 負責記住 Agent 該做什麼、每件事做到哪、改了什麼。Agent 照舊在你喜歡的地方跑，透過 MCP 和 git 連上 Tomrade、認領工單，看板會跟著它們的分支和 PR 更新。
復原能復原到哪一步？
Tomrade 自己寫入的、以及它讓 Agent 寫入的每一處改動，按執行歸組：工單、「檔案」裡的檔案和筆記，還有設定。歷史裡列出每一次執行，復原一次就把它改的全部還原。它不管 Tomrade 之外的東西：儲存庫裡的提交、分支和 PR 歸 git 管，照常用 git 回退。
一定要用 GitHub 嗎？
不用。本機的 git 儲存庫就夠了：在分支名稱或提交裡寫上工單號，工單就會跟著走。從 Tomrade 裡開 PR、合併 PR 目前用的是 GitHub，「檔案」也可以選擇同步到一個 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、Feishu、DingTalk 或 WeCom 裡傳訊息給助理。只要電腦上的 Tomrade 在跑，它就會回；關掉所有視窗，它也能在背景繼續跑。熬夜是電腦的事，不是你的事。
番茄鐘會提醒我提肛嗎？
官方說法：它只提醒你休息。非官方說法：提示音可以換成任何音訊檔。懂的都懂。
支援哪些平台？
macOS（Apple 晶片和 Intel）、Windows 和 Linux（AppImage）。
介面支援哪些語言？
英文、簡體中文、繁體中文、日文、西班牙文、德文、法文和俄文。
多交付，少審核。
免費使用，以 Apache 2.0 開源。你的專案一直在你自己的資料夾裡。