---
title: "How to Create a Task in an AgentRQ Workspace | AgentRQ Guidelines"
url: https://agentrq.com/guidelines/tasks/create-a-task-in-a-workspace
description: "Create a task for an AgentRQ workspace's agent in six clicks: open the workspace, click New Task, describe the work, pick Agent or Human, set options and create it."
---

Checked November 16, 2026 | [All Tasks guides](https://agentrq.com/guidelines/tasks/)

# How to Create a Task in an AgentRQ Workspace

To create a task, open the workspace whose agent should do the work, click **New Task**, describe what you want done and click the round arrow button. The task appears under **Not started**, and the workspace's agent picks it up as soon as it is free. You can also press **N** anywhere in AgentRQ to open the form for the workspace you are in.

This page is one of our [task guidelines](https://agentrq.com/guidelines/tasks/). It was checked against AgentRQ on November 16, 2026, and every screenshot comes from a real run of the **storefront-api** workspace.

## Before You Start

- → A workspace. Each workspace has one agent, so create the task in the workspace whose agent knows the code. See [workspaces](https://agentrq.com/features/workspace).
- → An agent connected to it, if you want the task started right away. A task created while the agent is offline waits under **Not started** until it connects. See [connect Claude Code with machines](https://agentrq.com/guidelines/connect-agents/claude-code-and-machines).

## Step by Step: Create a Task

**1. Open the workspace and click New Task**, in the top right corner. Pressing **N** does the same.

![Step 1: the storefront-api workspace with its Not started and Scheduled tasks, and an arrow pointing at the New Task button in the top right corner](https://agentrq.com/assets/guidelines/tasks-now-1-new-task.png)

**2. Describe the task.** This is the only field you must fill in, and it is what the agent reads. Say what to do, why, and what done looks like. Type **/** at the start to pick one of the workspace's [skills](https://agentrq.com/features/distributed-skills).

**3. Give it a title, if you like.** Leave it empty and AgentRQ names the task from its description. The sparkle button beside the field writes a title for you, in your browser.

**4. Choose Agent or Human.** **Agent** hands the task to the workspace's agent. **Human** keeps it on your list, for work you will do yourself.

**5. Set any options.** The row under the description holds them: the paperclip attaches files, the microphone dictates the description, **YOLO** lets the agent run every command without asking you first, and the calendar [schedules](https://agentrq.com/guidelines/tasks/schedule-a-one-time-task) the task. When the workspace has events or workflows, a lightning button picks one to fire when the task completes.

**6. Click the round arrow button** to create the task, or press **Cmd + Enter** (Ctrl + Enter on Windows and Linux).

![Steps 2 to 6: the New Task form with a title and a description filled in, and arrows pointing at the description, the title, the Agent and Human switch, the YOLO option and the create button](https://agentrq.com/assets/guidelines/tasks-now-2-write.png)

**7. Find it under Not started.** AgentRQ takes you back to the workspace and says "Task Created successfully". The task waits under **Not started** until the agent picks it up, then moves to **Ongoing**.

![Step 7: the workspace's task list with the new task, Add retry with backoff to the email sender, highlighted under Not started and a Task Created successfully toast](https://agentrq.com/assets/guidelines/tasks-now-3-created.png)

## What Happens Next

The agent marks the task ongoing when it starts, replies in the task as it works, and asks you in the task when it needs a decision or an approval. Open the task to read its replies and answer. When the agent is done, the task moves to **Completed**. Every status has its own color: see [what each workspace status color means](https://agentrq.com/guidelines/workspaces/workspace-status-colors).

## FAQ

### Can I change a task after I create it?

Yes, until the agent starts on it. Hover over the task in the list and click the pencil to edit it, or the bin to delete it. Once a task is ongoing, write to the agent in the task instead.

### Can an agent create tasks too?

Yes. An agent can create tasks in its own workspace with its AgentRQ tools, and the supervisor can create them in any of your workspaces. They show up in the same lists, marked as created by the agent.

### How big can an attachment be?

Up to 4 MB per request. Larger files are refused when you create the task. See [attachments](https://agentrq.com/docs/howto-attachments).

### What does YOLO change for one task?

The agent skips approval prompts and runs every command in this task without asking you. Turn it on only for work you trust it to do alone. See [YOLO mode](https://agentrq.com/features/yolo-mode).
