Create & track tasks

Every workspace has a Plane-style Tasks board. A task has a title (the only required field) and optional description, assignee (a person or an agent), priority (urgent / high / medium / low / none), due date, department, workflow state and labels.

Create a task

By hand:

1. Open Tasks and pick a department. Each department has three sections: Overview, Work items and Pages (see Department Overview and Pages).
2. In Work items, start a new one. The dialog is titled New work item: choose the Department, type a Task title, and optionally add a description, state, priority, due date and assignee.
3. Click Create. The task lands in the department’s default state. Turn on Create more to keep the dialog open for the next one.

From a message: hover a message in a channel and click Create task (also in the message’s ⋮ menu) to turn it into a work item.

Through an agent (in any channel):

1. Ask or @-mention an agent, e.g. “@apex create a task to ship the relay and assign it to me.”
2. The agent calls cyborg7_create_task and replies with the new task id.

Which department does it land in?

Every task lives in a department (called a project in the API, CLI and agent tools), so a create must resolve to one. The agent does not have to ask you. It has three ways to find it:

• Channel auto-resolution: an agent working in a channel files the task in that channel’s department automatically. If the channel has no department of its own, it falls back to the workspace Inbox.
• Sub-tasks inherit: create a task under a parentId and it joins its parent’s department.
• Explicit department: the agent passes a projectId. To find one, it calls cyborg7_list_projects, which returns each department’s id, identifier, name, color, and whether it’s the Inbox.

A create with none of those (no department, no channel, no parent) is rejected with “provide projectId or channelId”.

Track and update

• List and filter: ask an agent to run cyborg7_list_tasks and filter by state, assignee, department, priority or label, or filter directly on the board.
• Move it along: change a task’s state. States are the columns of the department’s board, and each department can have its own (for example Backlog, To do, In progress, Done). Also (re)assign it, re-prioritize, move it between departments, retag its labels, or record a result by editing it on the board or asking an agent to run cyborg7_update_task.
• Tidy up: cyborg7_archive_task hides a finished task (reversible; restore it the same way), cyborg7_delete_task removes one for good, and cyborg7_bulk_update_tasks applies one change (e.g. mark done, reassign) across a batch at once.

From the command line

The same operations are available through the cyborg CLI. Each command takes the workspace id first and the usual --email / --token auth, like every other cyborg command.

# Discover the workspace's departments (projects in the CLI), then create a task in one
cyborg project:list <workspace-id>
cyborg task:create <workspace-id> "Ship the relay" \
  --project <project-id> --assignee <user-id> --priority high --due 2026-07-01

# Or scope it to a channel and let that channel's department be chosen
cyborg task:create <workspace-id> "Fix the login bug" --channel <channel-id>

# See a department's workflow states, then list and filter
cyborg task:states <project-id>
cyborg task:list <workspace-id> --state "In progress" --assignee <user-id>

# Update, archive (use --unarchive to bring it back), or delete
cyborg task:update <workspace-id> <task-id> --state Done --result "Deployed"
cyborg task:archive <workspace-id> <task-id>
cyborg task:delete <workspace-id> <task-id> --yes

# Move a whole batch in one shot
cyborg task:bulk-update <workspace-id> <task-id> <task-id> --state Done

Sync tasks from Jira, ClickUp or GitHub

Work items can also come from your other tools and stay in step with them. See Sync tasks with Jira, ClickUp or GitHub.

Schedule a task

A task assigned to an agent can run on a schedule. Open the task and choose Schedule this task (or Edit schedule if it already has one). See Schedule a recurring job.