Assign a task

​

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).
• Host offline → task waits (waiting_for_agent) until the daemon reconnects.
• Failure → see Handle task failures.