> ## Documentation Index
> Fetch the complete documentation index at: https://getpullrequest.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Assign a task

> Create or sync a task and send it to a paired workspace agent.

## Create in the app

1. Open the board.
2. Create a task with a specific title and acceptance criteria in the body.
3. Assign it to a workspace that is online and has a ready agent.

Vague prompts produce vague plans. Say what files, behavior, and tests matter.

## Sync from GitHub

1. Connect GitHub under **Settings → Connections**.
2. Add label `gpr:agent` on the issue.
3. Assign the issue to yourself.
4. Wait for sync, or open the board and confirm the task appeared.

## Sync from Jira or Slack

* **Jira**: connect under **Settings → Connections**, link a project, then sync issues onto the board.
* **Slack**: connect Slack, then create tasks from supported @mention flows in linked channels.

## What assignment actually does

Assignment targets a **workspace**, not a free-floating model. That workspace’s machine must be online. The queue leases the task, the daemon opens a durable session, and the pipeline starts at checkpoint `none` (plan).

## After assign

* Needs questions → reply on the task ([Monitor progress](/docs/guides/monitor-progress)).
* Host offline → task waits (`waiting_for_agent`) until the daemon reconnects.
* Failure → see [Handle task failures](/docs/guides/handle-task-failures).