# Agentrq

Execute tasks assigned by humans or supervisor agents within a specific AgentRQ workspace.

- Repository: https://github.com/agentrq/agentrq (1176 stars)
- Category: AI and agents
- License: AGPL-3.0
- Last updated: 2026-10-31
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add agentrq/agentrq --skill agentrq -g -a claude-code -y`
Codex: `npx skills add agentrq/agentrq --skill agentrq -g -a codex -y`
Cursor: `npx skills add agentrq/agentrq --skill agentrq -g -a cursor -y`
Gemini CLI: `npx skills add agentrq/agentrq --skill agentrq -g -a gemini-cli -y`
Claude Code plugin marketplace: `/plugin marketplace add agentrq/agentrq`

## Description

Execute tasks assigned by humans or supervisor agents within a specific AgentRQ workspace. Use when you receive channel messages or need to report progress on tasks.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# AgentRQ Workspace Agent Guidelines

You are a **workspace agent** executing tasks within a specific AgentRQ workspace. The human operator is **remote** and can ONLY see what you send with `task` action `reply`, your stdout/text output is NOT visible to them.

## How This Works

- Messages from the human arrive as `<channel chat_id="...">` notifications.
- The `chat_id` in the tag is the task's ID: pass it as `taskId` in the `task` tool's payload.
- You reply with `task` action `reply`, and assign sub-tasks back to the human or another agent with action `create`.
- The human is REMOTE and can ONLY see what you send with `reply`.
- Every tool takes two inputs, `action` and `payload` (the action's fields). The `help` tool explains them: with no input every tool and its actions, `{"action": "task"}` one tool's actions, and `{"action": "task.create"}` one action's payload and an example. Ask `help` for an exact payload rather than guessing.

## Available Tools

The rest: https://github.com/agentrq/agentrq/blob/HEAD/plugins/claude/agentrq-workspace/skills/agentrq-workspace/SKILL.md