claudeers.
// Automation & Workflows

agent-farm

A 2.5D farm where every AI agent (Claude Code, Codex, Cursor, Gemini, OpenCode, Ollama…) is a farm animal showing its live status.

Install with your AI

Paste into Claude Code, Cursor, or any agent — it reads the repo and wires the tool into your project.

Install and set up agent-farm (git-clone project) into my current project.
Found on https://claudeers.com/agent-farm
Repo: https://github.com/irons163/agent-farm
Homepage/docs: —
Detected install method: git-clone → git clone https://github.com/irons163/agent-farm
Category: automation. Platforms: cli, api.
Read the repo's README for exact setup and env vars, then install it and wire it into my project.

Claudeers Health Verdict:
unknown; community-verified: false. Confirm the source before running anything.
// or clone
git clone https://github.com/irons163/agent-farm

// compatibility

Platformscli, api
Operating systems—
AI compatibilityclaude
LicenseMIT
Pricingopen-source
LanguageJavaScript

Get your FREE $2.50 API credits to access TickAtlas financial data ↗

🌾 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.2-macOS-AppleSilicon.dmg
IntelAgentFarm-1.1.2-macOS-Intel.dmg
Windows 10/11(64 位元)AgentFarm-1.1.2-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/⚠️ 依紀錄格式實作,尚未實測
Ollamahttp://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 5181PORT5180連接埠
--demoFARM_DEMO=onoff顯示示範動物
--host 0.0.0.0HOST127.0.0.1開放給其他裝置,需要搭配權杖,見「安全性」
--token …FARM_TOKEN無權杖
FARM_WINDOW_HOURS12超過幾小時沒動作就不顯示
FARM_SLEEP_MIN15閒置幾分鐘後去睡覺
FARM_ONESHOT_MIN30一次性工作階段結束後幾分鐘消失
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

// faq

What is agent-farm?

A 2.5D farm where every AI agent (Claude Code, Codex, Cursor, Gemini, OpenCode, Ollama…) is a farm animal showing its live status.. It is open-source on GitHub.

Is agent-farm free to use?

agent-farm is open-source under the MIT license, so it is free to use.

What category does agent-farm belong to?

agent-farm is listed under automation in the Claudeers registry of Claude-compatible tools.

16 views
★ 10 stars
unclaimed
updated 11 days ago

// embed badge

agent-farm on Claudeers
[![Claudeers](https://claudeers.com/api/badge/agent-farm.svg)](https://claudeers.com/agent-farm)

// retro hit counter

agent-farm hit counter
[![Hits](https://claudeers.com/api/counter/agent-farm.svg)](https://claudeers.com/agent-farm)

// reviews

// guestbook

0/500

// related in Automation & Workflows

🔓

The agent that grows with you

// automationNousResearch/⟨Python⟩★ 264,763◷ MIT[ claude ]
🔓

The API to search, scrape, and interact with the web at scale. 🔥

// automationfirecrawl/⟨TypeScript⟩★ 199,533◷ AGPL-3.0[ claude ]
🔓

🌐 Make websites accessible for AI agents. Automate tasks online with ease.

// automationbrowser-use/⟨Python⟩★ 121,235◷ MIT[ claude ]
🔓

Taste-Skill - gives your AI good taste. stops the AI from generating boring, generic slop

// automationLeonxlnx/⟨JavaScript⟩★ 110,676◷ MIT[ claude ]
→ see how agent-farm connects across the ecosystem