AgEnD（Agent Engineering Daemon）把你的 Telegram 或 Discord 變成 AI coding agent 的指揮中心。一個 bot，多種 CLI 後端，無限專案 — 每個都是獨立 session，crash 自動恢復，不用顧。

English · 功能文件 · CLI 參考

為什麼用 AgEnD？

| 沒有 AgEnD | 有 AgEnD | |---|---| | 關掉終端機，agent 就斷線 | 系統服務常駐，重開機也不怕 | | 一個終端機 = 一個專案 | 一個 bot，無限專案同時跑 | | 長時間 session 累積過時 context | 依 max age 自動輪替 session，保持新鮮 | | 不知道 agent 半夜在幹嘛 | 每日花費報告 + 卡住偵測通知 | | Agent 各做各的，無法協作 | 點對點協作，透過 MCP tools | | 無人看管時帳單暴增 | 每個 instance 每日花費上限，自動暫停 |

功能亮點

🚀 Fleet 管理 — 一個 bot、N 個專案。每個 Telegram Forum Topic 就是獨立的 agent session。

🔄 多後端支援 — Claude Code、Gemini CLI、Codex、OpenCode、Kiro CLI，自由切換或混用。

🤝 Agent 協作 — Agent 之間透過 MCP tools 互相發現、喚醒、傳訊。General Topic 用自然語言把任務路由到對的 agent。

📱 手機操控 — 從 Telegram inline 按鈕核准工具使用、重啟 session、管理整個 fleet。

🛡️ 自主又安全 — 花費上限、卡住偵測、model failover、context 輪替，fleet 不用顧也能穩穩跑。

⏰ 持久化排程 — cron 排程任務，SQLite 儲存，重啟不遺失。

🎤 語音訊息 — 用 Groq Whisper 轉文字，用說的跟 agent 溝通。

📄 HTML 對話匯出 — 把任何 agent session 匯出成獨立 HTML 檔，方便分享或存檔。

🪞 Mirror Topic — 跨 instance 可見性。從另一個 topic 即時觀看其他 agent 的工作。

🖥️ Web Dashboard — 瀏覽器即時 fleet 監控，SSE 更新 + 整合聊天介面。

🔌 可擴充 — Discord adapter、webhook 通知、health endpoint、外部 session 透過 IPC 連入。

開始用

npm install -g @suzuke/agend    # 1. 安裝
agend quickstart                # 2. 設定 — bot token、backend，搞定
agend fleet start               # 3. 啟動 fleet 🎉

打開 Telegram，傳訊息給你的 bot，開始用手機寫 code。

運作原理

graph LR
  You["你<br/>(手機 / 電腦)"] <-->|訊息| Channel["Telegram / Discord<br/>/ Web UI"]
  Channel <-->|路由| Daemon["AgEnD Daemon"]

  subgraph Fleet
    Daemon --> General["General<br/>Dispatcher"]
    Daemon --> A["Instance A<br/>Claude Code<br/>專案 X"]
    Daemon --> B["Instance B<br/>Gemini CLI<br/>專案 Y"]
    A <-.->|MCP Tools| B
    General -.->|路由任務| A
    General -.->|路由任務| B
  end

1. 你傳訊息給 Telegram/Discord bot
2. 傳到 General Topic 的訊息會被解讀並路由到對的 agent。傳到特定 topic 的訊息則直接送到該 instance。
3. Agent instance 在獨立的 tmux session 跑，各有自己的專案和 CLI 後端
4. Agent 之間協作 — 透過 MCP tools 委派任務、分享 context、回報結果
5. 結果回傳到你的聊天室。權限請求以 inline 按鈕呈現。

支援的後端

| Backend | 安裝 | 認證 | |---------|------|------| | Claude Code | curl -fsSL https://claude.ai/install.sh \| bash | claude（OAuth）或 ANTHROPIC_API_KEY | | OpenAI Codex | npm i -g @openai/codex | codex（ChatGPT 登入）或 OPENAI_API_KEY | | Gemini CLI | npm i -g @google/gemini-cli | gemini（Google OAuth） | | OpenCode | curl -fsSL https://opencode.ai/install \| bash | opencode（設定 provider） | | Kiro CLI | brew install --cask kiro-cli | kiro-cli login（AWS Builder ID） |

系統需求

• Node.js >= 20
• tmux
• 以下任一 AI coding CLI（需安裝並完成認證）
• Telegram bot token（@BotFather）或 Discord bot token
• Groq API key（選用，語音轉文字用）

⚠️ 所有 CLI 後端都以 --dangerously-skip-permissions（或等效參數）執行。詳見 Security。

文件

• Features — 功能詳細說明
• CLI Reference — 所有指令與選項
• Configuration — fleet.yaml 完整設定參考
• Security — 信任模型與安全強化

已知限制

• 支援 macOS（launchd）和 Linux（systemd），不支援 Windows
• 全域 enabledPlugins 裡有官方 Telegram plugin 會造成 409 polling 衝突
• OpenCode 和 Kiro CLI 不讀取 MCP server 的 instructions 欄位 — fleet context 和 workflow template 不會注入到這些 backend 的 system prompt。等待上游修復。

授權

MIT