🌾 Agent Farm · AI 代理農場

繁體中文 · English

一座用 Blender 算圖的 2.5D 等角農場：電腦上每個 AI agent 都是一隻農場動物。誰在工作、誰在思考、誰在等你回覆，看一眼就知道。

Agent Farm 白天

支援多平台：Claude Code、OpenAI Codex、Cursor、Gemini CLI、Google Antigravity、OpenCode、Ollama 會自動偵測；其他任何程式用一行 HTTP 請求就能加入。
每個 agent 一種動物：狐狸、貓、兔子、貓頭鷹、乳牛、豬、綿羊、母雞、鴨子、柯基、山羊、小馬，同一個工作階段會一直是同一隻。
零安裝：不用 npm install、不用 Blender，美術圖已經算好放在 repo 裡。
只在你的電腦上跑：唯讀各平台的本機紀錄，不上傳任何東西。
白天／夜晚、繁中／English、手機版、需要你回覆時跳桌面通知。

下載

版本	下載
Apple Silicon（M 系列）	AgentFarm-1.1.0-macOS-AppleSilicon.dmg
Intel	AgentFarm-1.1.0-macOS-Intel.dmg
Windows 10/11（64 位元）	AgentFarm-1.1.0-Windows-x64-setup.exe
Linux（x64：`.AppImage` 或 `.deb`；arm64：`.AppImage`）	最新發行版

打開 DMG，把 Agent Farm 拖進 Applications，就這樣。不用安裝 Node.js，不用開終端機。

App 會自動在背景跑伺服器、開視窗。關掉視窗之後繼續跑在選單列（右上角圖示）；有 agent 在等你回覆時會跳原生通知。

Windows / Linux： 用法相同，只是常駐在系統匣而不是選單列。Windows 安裝檔目前還沒有程式碼簽章，SmartScreen 會顯示「Windows 已保護您的電腦」，請按其他資訊 → 仍要執行。Linux 的 AppImage 需要先 chmod +x，或直接安裝 .deb。GNOME 預設沒有系統匣，要裝 AppIndicator 擴充套件才看得到圖示（沒裝的話，再開一次 App 就能把視窗叫回來）。

也可以從原始碼跑：

快速開始

需要 Node.js 20 以上（要看 OpenCode 的話需要 22.13 以上）。

git clone https://github.com/irons163/agent-farm.git
cd agent-farm
npm start

打開 http://127.0.0.1:5180。電腦上最近 12 小時用過的 agent 會自己出現。

還沒有 agent 在跑也沒關係，可以先看示範：

npm run demo

動物在做什麼

狀態	動物
🌱 工作中	在自己的菜圃幹活，工具用得越多，作物長得越大
💭 思考中	站在菜圃旁，頭上冒思考泡泡
❗ 等你回覆	跑到農舍門廊等你（要授權、有問題要問），並跳通知
⚠️ 出錯	頭上有烏雲閃電
✅ 待命	在草地上散步
💤 休息	閒置 15 分鐘後回到穀倉旁睡覺

風車轉速和煙囪的煙會隨工作中的 agent 數量變化。農場上最多 12 隻，其他的列在右側清單裡。滾輪縮放、拖曳移動，點動物看牠最近做了什麼。

Agent Farm 夜晚

支援的平台

平台	從哪裡讀（唯讀）	狀態
Claude Code	`~/.claude/projects/`（或 `CLAUDE_CONFIG_DIR`）	✅ 已實測
OpenAI Codex（CLI／桌面版）	`~/.codex/sessions/`（或 `CODEX_HOME`）	✅ 已實測
Cursor Agent	`~/.cursor/projects/*/agent-transcripts/`	✅ 已實測
Google Antigravity	`~/.gemini/antigravity/`	✅ 已實測
OpenCode	`~/.local/share/opencode/opencode.db`	✅ 已實測
Gemini CLI	`~/.gemini/tmp/*/chats/`	⚠️ 依紀錄格式實作，尚未實測
Ollama	`http://127.0.0.1:11434/api/ps`（或 `OLLAMA_HOST`）	⚠️ 尚未實測
任何其他程式	`POST /api/report`，見下面	✅

在 macOS 上開發和測試；Linux 和 Windows 的路徑都有處理，但還沒實際測過，有問題歡迎開 issue。

讓其他 AI 也上農場

OpenAI Agents SDK、LangGraph、AutoGen、DeepSeek、你自己的機器人……任何程式都能回報狀態：

curl -X POST http://127.0.0.1:5180/api/report -H 'content-type: application/json' \
  -d '{"id":"support-bot","platform":"openai","status":"working","tool":"search","detail":"order #1932"}'

node bin/farm-report.mjs --id researcher --platform deepseek --status thinking

import requests
requests.post("http://127.0.0.1:5180/api/report", json={
    "id": "researcher", "platform": "deepseek", "status": "working", "tool": "web_search"})

status 可以是 working、thinking、waiting、error、idle、sleeping，或用 offline 讓牠離開。其他可選欄位：name、model、project、task、detail、tokens、animal（指定動物）、color（#RRGGBB）。

Claude Code 即時掛鉤（選用）

不加也能用：狀態是從對話紀錄判斷的。加上 hooks 之後，「等待授權」這類狀態會即時、準確地顯示。網頁右上角「?」裡有一段已經填好路徑的設定，貼進 ~/.claude/settings.json 就好。

設定

參數	環境變數	預設	說明
`--port 5181`	`PORT`	`5180`	連接埠
`--demo`	`FARM_DEMO=on`	`off`	顯示示範動物
`--host 0.0.0.0`	`HOST`	`127.0.0.1`	開放給其他裝置，需要搭配權杖，見「安全性」
`--token …`	`FARM_TOKEN`	無	權杖
	`FARM_WINDOW_HOURS`	`12`	超過幾小時沒動作就不顯示
	`FARM_SLEEP_MIN`	`15`	閒置幾分鐘後去睡覺
	`FARM_ONESHOT_MIN`	`30`	一次性工作階段結束後幾分鐘消失
	`FARM_COLLECTORS`	全部	只啟用部分平台，例如 `claude-code,codex`

參數要加在 -- 後面，例如 npm start -- --port 5181，在 Windows 也能用。

臨時工作階段：在暫存資料夾（/tmp、/var/folders）裡跑的，或只問一句、沒用任何工具的一次性工作階段，會標上「臨時」並排在最後，不會搶真實 agent 的動物和菜圃。要完全隱藏：右上角「?」→「臨時工作階段」→ 隱藏。

安全性與隱私

農場畫面會顯示你的提示詞片段、專案路徑和工作階段 ID，所以：

預設只聽 127.0.0.1，而且只接受 localhost、127.0.0.1 這類主機名稱（擋 DNS rebinding）。瀏覽器送來的寫入請求必須來自農場自己的網址，其他網站和本機其他網頁都改不了。
各平台的紀錄只讀不寫，不會上傳到任何地方。唯一會連外的是 Google Fonts 字型。App 也不會自己檢查更新；想知道有沒有新版，請從說明頁或托盤選單的「檢查更新」開啟發行頁面。
想在手機或區網其他電腦上看，一定要設權杖，否則伺服器不會啟動：
```
npm start -- --host 0.0.0.0 --token 換成一串很長的亂碼
```
每台裝置第一次打開 http://<這台電腦的 IP>:5180/?token=<權杖>，之後會用 cookie 記住。farm-report 和 Claude Code hook 會讀環境變數 FARM_TOKEN。權杖走的是明文 HTTP，只在信任的網路上這樣用。

常見問題

Port 5180 is already in use：農場可能已經在跑了；或換一個連接埠：npm start -- --port 5181。
看不到我的 agent：右上角「?」會列出每個平台有沒有偵測到。超過 12 小時沒動作的工作階段不會顯示。
OpenCode 顯示需要更新 Node：讀 OpenCode 的資料庫要 Node.js 22.13 以上。

授權

MIT