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 和原生桌面客户端。