Tasks

Tasks are the core work item in Convoy. Each task belongs to a project and gets a stable ref like WEB-42, computed from the project alias.

A task carries title, description, status, priority, assignee, due date, type, tags — plus comments, attachments, and artifacts for context.

Statuses and workflow

Convoy supports a real workflow rather than a single done checkbox. Projects can use statuses such as To Do, In Progress, In Review, Done, and Canceled. Optional statuses can be disabled per project while preserving compatibility with existing tasks.

Backlog is a system List rather than a workflow status: a task sits in the Backlog list until it is promoted into active work.

Views

Task views are optimized for different work styles:

List view — dense editing, search, hierarchy, and drag-and-drop ranking. Most keyboard shortcuts target this view.
Board view — Kanban-style progress by status.
Task detail sidebar — description, metadata, comments, files, artifacts, and related threads for one task.

Subtasks

A subtask is a task with a parent task in the same project. Subtasks let teams break a larger outcome into independently trackable pieces while keeping the same project, refs, permissions, and workflow model.

Recommended pattern:

keep the parent task focused on the outcome
use subtasks for concrete deliverables
avoid deep nesting unless it adds real value

Tasks can move under a parent or back to the top level from the UI (Tab / Shift+Tab in the list view) or from the CLI with convoy tasks move.

Ordering, archiving, and search

Tasks are manually rankable — drag rows or use Mod+↑ / Mod+↓ in the list view.
Completed work can be archived (Mod+Shift+A archives completed tasks); archived tasks stay searchable.
Search covers active tasks by default and can include archived work.

Common actions

create a task from the project UI (C) or inline below the current row (Enter)
duplicate (Mod+D), delete (Mod+Backspace), or open details (Mod+Enter)
copy a task link by Mod+Click on the ref

Comments, attachments, and artifacts
Keyboard shortcuts
One-shot commands — script task operations from the terminal