agentrq/agentrq

AgentRQ: Human-in-loop realtime conversational task manager for AI Agents. Self-hosted! Control your own agents from wherever you want Mobile, Web, Desktop. Designed to work well with your own Claude subscriptions and any harness with ACP support.

AgentRQ – 人類與 AI 智能體的協作平台

簡介 – AgentRQ 是一個開源、可自託管的 Web/桌面應用程式，讓人類操作員和一個或多個 AI 智能體（例如 Claude、Antigravity、Codex）共享一個通用的任務工作區。該平台暴露了一個模型上下文協議（MCP）伺服器，智能體可以像調用一組遠端工具一樣調用它：建立任務、更新狀態、回覆訊息、觸發事件、讀寫「記憶」筆記等。由於智能體看到的狀態與人類 UI 相同，它們可以在用戶保持參與的情況下自主工作。

核心功能（如 README 中所述）

功能	您將獲得什麼
視覺化任務板	智能體建立的每個任務的即時看板/列表檢視，包含狀態、要求和歷史記錄。
任務排程	分配啟動日期或重複頻率（15 分鐘-小時-天-週-自訂）。背景輪詢器會在到期時準確生成任務 – 無需伺服器端「始終在線」的智能體。
事件與工作流	命名訊號（`qa_passed`、`deploy_finished`、…），可以在其他工作區觸發新任務。拖放圖編輯器無需 YAML 或 DSL 即可建立事件到工作區的管線。
工具呼叫歷史	任務執行中每個工具呼叫和聊天訊息的時間軸檢視，可搜尋並可下鑽。
自動標題生成	使用小型裝置端語言模型（快取在瀏覽器中，無 API 呼叫）進行一鍵標題建立。
語音轉文字	用於任務描述或回覆的瀏覽器內 Whisper 轉錄 – 本地處理，從不上傳。
訊息傳送延遲	訊息到達智能體前的可選倒數計時（3-60 秒）；可以取消或立即傳送。
鍵盤驅動 UI	全域快捷鍵（`⌘K`/`Ctrl+K` 任務查找器、`N` 新任務、`M/T` 聊天/軌跡檢視、`?` 說明）用於快速、無滑鼠工作。

架構（高層）

後端 – Go (Fiber) REST API + 基於 SSE 的 MCP 伺服器（mcp-go）。資料透過 GORM 儲存在 SQLite 中，認證透過 Google OAuth2 + JWT，內部發布/訂閱用於即時更新。
前端 – Vue 3 + Vite，使用 Pinia 進行狀態管理，使用 Tailwind CSS 和玻璃擬態 UI 進行樣式設計。
桌面客戶端 – Electron 包裝器，執行相同的 Vue UI，新增原生通知、托盤選單、全域快捷鍵、深度連結處理（agentrq://…）和自動更新。
擴充 – 在 GitHub（agentrq-extension 主題）上發現的僅限桌面的 Node 模組。擴充可以新增頁面、動作、快捷鍵或排程工作；它們以使用者權限執行，並由核心應用程式中介（無伺服器端程式碼執行）。

AI 智能體如何與 AgentRQ 通訊

MCP URL 和令牌 – 每個工作區發布一個唯一的 MCP 端點（https://<workspace>.mcp.agentrq.com/?token=…）。
.mcp.json – 放置在專案目錄中；告訴智能體使用哪個 MCP 伺服器。
Claude 整合 – .claude/settings.local.json 檔案可以預先批准一組 MCP 工具（createTask、reply、loadMemory 等），以便 Claude Code 可以在不每次提示使用者的情況下操作。
ACP 閘道 – 對於使用 Agent Client Protocol 的智能體（Antigravity、Codex），@agentrq/acp-gateway 橋接 ACP ↔ MCP，處理認證、任務路由和即時通知。

入門（來自 README 的快速入門步驟）

先決條件 – Go 1.21+、Node 18+、Google OAuth2 客戶端 ID/金鑰。

複製並安裝

git clone https://github.com/agentrq/agentrq.git
cd agentrq
make install          # 拉取 Go 模組、npm 套件等

本地執行

make dev               # 同時啟動後端（Fiber）和前端（Vite）
# 在另一個終端中用於桌面 UI
make desktop-dev

UI 將在 http://localhost:5173 上可存取。

桌面建置 – 預建置的安裝程式可在 Releases 頁面上使用，或透過單行命令安裝：
```
curl -fsSL https://agentrq.com/install.sh | sh -s -- --quit
```
自託管 – Docker 映像和 SETUP.md 提供生產就緒的 compose 檔案。

典型用例

AI 輔助專案管理 – 讓 Claude 產生、排程和更新工單，而人類進行審查並提供偶爾的澄清。
持續整合管線 – 發出事件（deploy_finished），自動為 AI 審查者產生部署後驗證任務。
知識庫建置 – 智能體寫入 memory.md（工作區筆記），這些筆記在執行之間持久化，實現累積學習。
混合編碼輔助 – Codex 或 Antigravity 可以連接到同一工作區，接收任務分配並回覆程式碼片段，所有這些都可以在共享儀表板中檢視。

了解更多

完整功能列表: https://agentrq.com/features
桌面指南: docs/DESKTOP.md
擴充開發: docs/EXTENSIONS.md
MCP 協議規範: 從儲存庫連結（WebMCP 整合）
ACP 閘道文件: docs/WEBMCP.md、docs/SLASH_COMMANDS.md

結論 – AgentRQ 是一個具體的、生產級平台，將現代 LLM 智能體與人類友善的任務板橋接，暴露一個定義明確的工具協議（MCP）用於自主但受監督的 AI 工作。它完全開源、可自託管，並包含 Web 和原生桌面客戶端。