AgentRQ CLI(agentrq-ws)完全指南:在终端管理Workspace与任务

发布时间:2026/10/15 19:50:29
AgentRQ CLI(agentrq-ws)完全指南:在终端管理Workspace与任务 【免费下载链接】agentrqAgentRQ: 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.项目地址https://gitcode.com/gh_mirrors/ag/agentrq点击查看免费下载如果你正在使用 AgentRQ 管理 AI Agent 的工作队列那么 AgentRQ CLI包名agentrq-ws就是你在终端里管理 Workspace 与任务的瑞士军刀 ️一条命令查看工作区、领取下一个任务、回复消息、下载附件全程无需打开浏览器也无需消耗 Agent 的 token。它是 AgentRQ 官方提供的命令行客户端直接复用 Workspace 的 MCP 服务器和.mcp.json配置在终端、CI 脚本和自动化流水线中与 AI Agent 协作都极为顺手。为什么需要 agentrq-ws 命令行工具AI Agent 通过 MCP 协议与 Workspace 通信每次调用都是一层 JSON 封装对人来说这既啰嗦又费 token。agentrq-ws把同样的能力翻译成普通的 shell 命令输出则是人类可读的纯文本不烧 token查任务、下附件这类体力活直接由终端完成不用唤起 Agent零配置读取当前目录最近的.mcp.json与 Agent 用的是同一个文件在工作区检出目录里开箱即用无运行时依赖npx即取即用适合 CI 和一次性脚本附件不再让你头疼上传传文件路径下载直接写盘你永远不用手动处理 base64快速安装一行 npx 即可上手无需安装任何东西用npx按需拉取npx -y agentrq/agentrq-wslatest help想长期使用的情况下全局安装npm install -g agentrq/agentrq-ws agentrq-ws help⚠️ 要求 Node.js 20.6 或更高版本见 cli/agentrq-ws/package.json 中的engines字段。零配置连接服务器它如何找到你的 Workspaceagentrq-ws会像git一样从当前目录逐级向上查找.mcp.json因此即使在子目录里执行也没问题。这个文件正是你在 AgentRQ Workspace 的 Setup 页签中配置给 Claude Code 等客户端的文件包含 Workspace 的 MCP URL 与 token。当.mcp.json里定义了多个服务器时用--server指名一个也可以直接用--config指向别的配置文件agentrq-ws workspace --server agentrq-workspace agentrq-ws workspace --config ../other/.mcp.json在 CI 等没有.mcp.json的场景可用环境变量直接指定服务器地址完全绕开配置文件环境变量作用AGENTRQ_WS_URL直接使用该 URL忽略.mcp.jsonAGENTRQ_WS_SERVER指定.mcp.json中使用哪个 server配置解析的具体实现见 cli/agentrq-ws/src/config.js。核心命令速览管理Workspace与任务下表是最高频的命令完整列表见 cli/agentrq-ws/README.md命令作用workspace查看工作区标题与使命missiontask get taskId按 id 获取任务--conversation附带对话历史task next领取下一个未开始任务——注意这会出队dequeuetask create title创建任务支持--clear-context、--attach等task status taskId status修改任务状态reply taskId text向任务发送一条消息task help [action]查看服务端task工具的各操作说明几个值得注意的细节task status接受六种状态notstarted、ongoing、completed、rejected、cron、blocked见 cli/agentrq-ws/src/commands.js 中的TASK_STATUSEStask next之所以是独立动词而不是task get是设计上的刻意选择它会声明式地占用工作命令名本身就告诉你队列被改动了task create还支持--cron 30 * * * *5 段 cron 定时、--event id完成后发布事件每个命令、每个命令族都支持--helpagentrq-ws task --help列出全部子命令试试第一条命令cd ~/code/my-workspace npx -y agentrq/agentrq-wslatest workspace附件处理上传传路径下载写文件底层 MCP 工具双向都讲 base64而 CLI 替你把它屏蔽掉了上传只给路径文件名、媒体类型、编码都自动推断agentrq-ws reply 0isnjTCkpW5 Build is green — log attached --attach ./run.log agentrq-ws task create Review the design --body brief.md --attach ./mock.png下载直接写文件并打印落盘路径不带--out时进入系统临时目录$ agentrq-ws attachment get 0isp9dJxr85 --task 0isnjTCkpW5 /tmp/agentrq-ws-help.txt--out可以传目录保留附件原名或完整文件路径重命名agentrq-ws attachment get 0isp9dJxr85 --task 0isnjTCkpW5 --out ~/Downloads agentrq-ws attachment get 0isp9dJxr85 --task 0isnjTCkpW5 --out ./report.pdf--task是必填的因为附件隶属于任务——CLI 会先取附件的公开链接再下载到磁盘。长文本技巧file与 stdin 管道凡是期望散文的参数位置--body、--content、--payload以及reply的正文都支持两种扩展写法路径从文件读取-从标准输入读取agentrq-ws task create Post-mortem --body notes.md git log --oneline -20 | agentrq-ws reply 0isnjTCkpW5 - agentrq-ws memory save release-notes.md --content CHANGELOG.md这让把 git 历史、构建日志等管道内容直接喂给任务成为一行命令的事。扩展 Workspace 能力memory、skill 与 Pano 文档agentrq-ws覆盖的是 Workspace 服务器的全部工具除了任务你还能在终端管理命令族能力memory load / save / delete读写跨任务保留的 Workspace 记忆load不带名字时读取索引memory.mdskill search / load / save / delete管理本工作区技能skill://name即读取其SKILL.mdpano save / edit / read / comment / attach / delete读写账号级共享的 Pano Markdown 文档--version乐观锁防止并发覆盖event publish name发布命名事件触发订阅工作区的任务tools/tools help/call tool列出服务器工具、查看用法或直接以 JSON 调用任意工具逃生通道例如用版本锁安全地追加一段 Pano 文档agentrq-ws pano read 0iabc123 --version agentrq-ws pano edit 0iabc123 --version 4 --append 结论通过评审 ✅向人类提问与网站工具终端里的人机协作ask命令向人类提问并阻塞等待回答默认最长 1 小时支持两种模式# 表单模式多个 --field 组成问题表单 agentrq-ws ask 0isnjTCkpW5 Which branch should I release from? \ --field branch:string:Branch name --field sign:boolean:Sign the tag? # 链接模式给人一个要去操作的链接 agentrq-ws ask 0isnjTCkpW5 Approve the deploy, then confirm --url https://example.com/approve**站点工具site-tools**则面向 AgentRQ 的 WebMCP 能力——人类通过 Chrome 扩展把网站的工具共享给工作区后你可以在终端里搜索、查看详情乃至调用agentrq-ws site-tools search # 按 q 排序列出共享网站及其工具 agentrq-ws site-tool agentrq.com navigate # 查看单个工具的输入 schema agentrq-ws call-site-tool agentrq.com navigate --task 0isnjTCkpW5 --args {url:https://example.com}面向脚本的输出--json与错误约定默认打印服务器返回的文本加--json则输出原始 JSON 结果方便接jqagentrq-ws tools --json | jq -r .[].name失败时只打印一行原因并以非零码退出看到堆栈stack trace则说明是 CLI 自身的 bug而不是你命令写错了常见问题速查现象原因与解法no .mcp.json found没有在任何上级目录找到配置换到工作区目录执行或设置AGENTRQ_WS_URLdefines several servers … choose one with --server.mcp.json有多个 server 且无法自动判定用--server name指名--task taskId is required下载附件必须说明它属于哪个任务--version is required to change a docPano 文档的写入需要带上你读取时的版本号pano read会打印它写在最后agentrq-ws把 AgentRQ Workspace 的全部 MCP 工具翻译成了地道的 shell 体验像git一样从目录自动发现配置、像管道工具一样可组合、像 CLI 一样零 token 成本。无论是快速核对队列、给 Agent 补充上下文还是在 CI 中自动化任务流转它都是浏览器界面的最佳搭档 。延伸阅读CLI 完整文档cli/agentrq-ws/README.md命令实现全部命令与参数cli/agentrq-ws/src/commands.js服务器配置发现逻辑cli/agentrq-ws/src/config.jsMCP 服务器与工具设计docs/agents/mcp-and-tasks.mdWorkspace 接入与.mcp.json配置README.zh-CN.mdPano 文档机制docs/PANO.md赞分享【免费下载链接】agentrqAgentRQ: 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.项目地址https://gitcode.com/gh_mirrors/ag/agentrq点击查看免费下载相关推荐gws tasks 完全指南用 Google Workspace CLI 管理 Google Tasks 任务列表与任务gws tasks 完全指南用 Google Workspace CLI 管理 Google Tasks 任务列表与任务 导读 gws tasks 是 Goo如何把Claude Code接入AgentRQ.mcp.json配置与实时任务流转实战如何把Claude Code接入AgentRQ.mcp.json配置与实时任务流转实战 想让 Claude Code 直接认领任务、实时汇报进度的新手可以按Conductor CLI 完全指南在终端中管理工作流、任务、计划、密钥与本地服务器Conductor CLI 完全指南在终端中管理工作流、任务、计划、密钥与本地服务器 Conductor CLI conductor 是 Conducto后端流程编排工作流自动化微服务创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考

关于本文作者

来自尧图内容编辑团队

尧图内容编辑团队 内容团队

尧图内容编辑团队

本文由尧图网络内容编辑团队执笔。团队由资深项目经理、前端工程师与设计师组成,所有内容均来自亲手交付的真实项目,先讲清问题、再给出可落地的解法。尧图深耕北京网站建设十年,服务过京华建材集团、智造科技等各行业客户,把一线经验沉淀为可复用的行业观察。

  • 十年建站经验,覆盖建材、制造、服务、文创等
  • 项目经理把关选题与事实准确性
  • 工程师与设计师联合撰写专业细节
  • 统一编辑规范,保证文风与排版一致
  • 每月复盘转化数据,迭代选题方向

延伸阅读

相关资讯与近期热门内容

深度阅读推荐

建站决策前值得细读的三篇

网站改版的5个关键决策
2024-08-12

网站改版的5个关键决策

什么时候该改版、改到什么程度、如何避免流量掉光,京华建材集团改版复盘给出答案。

获取专属建站方案

看完文章,把您的行业与预算告诉我们,免费获取一份量身定制的官网建设方案与报价。

立即免费咨询