prb task command reference

Manage tasks. This page documents 21 commands under prb task.

Flags and examples below come from the command definitions. A Required flag is explicitly marked required by Cobra; an unmarked flag can still be needed by runtime validation or a non-interactive workflow. Empty strings and empty lists are registered defaults, not sample values.

Every command also inherits the global flags. Run prb <command> --help to check your installed version. Replace placeholder IDs and names in source examples before running them. Return to the complete CLI command reference to browse another command.

Commands

Command	Description	Usage	Source
prb task	Manage tasks.	prb task <command>	View implementation
prb task activity	Manage task activities.	prb task activity <command>	View implementation
prb task activity list	List activities on a task.	prb task activity list	View implementation
prb task activity view	View a task activity.	prb task activity view <id>	View implementation
prb task comment	Manage task comments.	prb task comment <command>	View implementation
prb task comment create	Add a comment to a task.	prb task comment create	View implementation
prb task comment delete	Delete a task comment.	prb task comment delete <id>	View implementation
prb task comment list	List comments on a task.	prb task comment list	View implementation
prb task comment update	Update a task comment.	prb task comment update <id>	View implementation
prb task comment view	View a task comment.	prb task comment view <id>	View implementation
prb task create	Create a new task.	prb task create	View implementation
prb task delete	Delete a task.	prb task delete <id>	View implementation
prb task link-linear	Link a task to an existing Linear issue.	prb task link-linear <id>	View implementation
prb task list	List tasks in an organization.	prb task list	View implementation
prb task list-linear-issues	Search Linear issues for a team.	prb task list-linear-issues <organization-id>	View implementation
prb task list-linear-teams	Search Linear teams for an organization.	prb task list-linear-teams <organization-id>	View implementation
prb task publish-linear	Publish a task as a new Linear issue.	prb task publish-linear <id>	View implementation
prb task unlink-external	Unlink a task from its external issue.	prb task unlink-external <id>	View implementation
prb task update	Update a task.	prb task update <id>	View implementation
prb task update-linear-settings	Update the organization’s Linear settings.	prb task update-linear-settings <organization-id>	View implementation
prb task view	View a task.	prb task view <id>	View implementation

prb task

Manage tasks.

Usage

prb task <command>

View command implementation.

prb task activity

Manage task activities.

Usage

prb task activity <command>

View command implementation.

prb task activity list

List activities on a task.

Usage

prb task activity list

Accepts no positional arguments.

Flags

Flag	Type	Default	Required	Description
--after	string	""	—	Cursor from the previous page (the Next cursor line)
--json	boolean	false	—	Output JSON (same as —output json)
--limit, -L	integer	30	—	Maximum number of activities to list
--order-direction	string	"DESC"	—	Sort direction (ASC, DESC)
--output, -o	string	""	—	Output format: json, table (default)
--task	string	""	—	Task ID (required)

Examples

# List activities on a task
prb task activity list --task <task-id>

View command implementation.

prb task activity view

View a task activity.

Usage

prb task activity view <id>

Requires 1 positional argument.

Flags

Flag	Type	Default	Required	Description
--json	boolean	false	—	Output JSON (same as —output json)
--output, -o	string	""	—	Output format: json, table (default)

View command implementation.

prb task comment

Manage task comments.

Usage

prb task comment <command>

View command implementation.

prb task comment create

Add a comment to a task.

Usage

prb task comment create

Accepts no positional arguments.

Flags

Flag	Type	Default	Required	Description
--content	string	""	—	Comment content as markdown or ProseMirror JSON. Images and links to /api/files/v1/{id} are kept (required)
--owner	string	""	—	Owner profile ID (defaults to the authenticated user)
--task	string	""	—	Task ID (required)

Examples

# Create a comment interactively
prb task comment create

# Create a comment non-interactively
prb task comment create --task <task-id> --content "Looks good"

View command implementation.

prb task comment delete

Delete a task comment.

Usage

prb task comment delete <id>

Requires 1 positional argument.

Flags

Flag	Type	Default	Required	Description
--yes, -y	boolean	false	—	Skip confirmation prompt

View command implementation.

prb task comment list

List comments on a task.

Usage

prb task comment list

Accepts no positional arguments.

Flags

Flag	Type	Default	Required	Description
--after	string	""	—	Cursor from the previous page (the Next cursor line)
--json	boolean	false	—	Output JSON (same as —output json)
--limit, -L	integer	30	—	Maximum number of comments to list
--order-direction	string	"ASC"	—	Sort direction (ASC, DESC)
--output, -o	string	""	—	Output format: json, table (default)
--task	string	""	—	Task ID (required)

Examples

# List comments on a task
prb task comment list --task <task-id>

View command implementation.

prb task comment update

Update a task comment.

Usage

prb task comment update <id>

Requires 1 positional argument.

Flags

Flag	Type	Default	Required	Description
--content	string	""	—	Comment content as markdown or ProseMirror JSON. Images and links to /api/files/v1/{id} are kept
--owner	string	""	—	Owner profile ID

View command implementation.

prb task comment view

View a task comment.

Usage

prb task comment view <id>

Requires 1 positional argument.

Flags

Flag	Type	Default	Required	Description
--json	boolean	false	—	Output JSON (same as —output json)
--output, -o	string	""	—	Output format: json, table (default)

View command implementation.

prb task create

Create a new task.

Usage

prb task create

Flags

Flag	Type	Default	Required	Description
--assigned-to	string	""	—	Assigned profile ID
--content	string	""	—	Task content as markdown or ProseMirror JSON. Images and links to /api/files/v1/{id} are kept
--deadline	string	""	—	Deadline
--internal-control	string array	[]	—	Internal control ID (repeatable)
--linear-team	string	""	—	Linear team ID. Omit to use the organization’s default Linear team. If the Linear publish attempt fails after the task is created, the task still exists
--name	string	""	—	Task name (required)
--no-linear-team	boolean	false	—	Create the task with no Linear team
--org	string	""	—	Organization ID
--priority	string	""	—	Task priority: URGENT, HIGH, MEDIUM, LOW (required)
--recurrence-interval	string	""	—	Recurrence interval as an ISO-8601 duration, e.g. P7D, P1M or P1Y (requires —deadline). The next task is created when the deadline passes
--state	string	""	—	Task state: BACKLOG, TODO, IN_PROGRESS, DONE, CANCELED, DUPLICATE
--time-estimate	string	""	—	Time estimate

Examples

# Create a task interactively
prb task create

# Create a task non-interactively
prb task create --name "Review access controls" --priority HIGH

View command implementation.

prb task delete

Delete a task.

Usage

prb task delete <id>

Requires 1 positional argument.

Flags

Flag	Type	Default	Required	Description
--yes, -y	boolean	false	—	Skip confirmation prompt

View command implementation.

prb task link-linear

Link a task to an existing Linear issue.

Usage

prb task link-linear <id>

Requires 1 positional argument.

Additional help

Link a task to an existing Linear issue. This updates the Probo task with the Linear issue.

Flags

Flag	Type	Default	Required	Description
--issue-id	string	""	Required	Linear issue ID
--team-id	string	""	Required	Linear team ID
--yes	boolean	false	—	Confirm that linking updates the Probo task

View command implementation.

prb task list

List tasks in an organization.

Usage

prb task list

Accepts no positional arguments.

Flags

Flag	Type	Default	Required	Description
--after	string	""	—	Cursor from the previous page (the Next cursor line)
--assigned-to	string	""	—	Filter by assigned profile ID
--json	boolean	false	—	Output JSON (same as —output json)
--limit, -L	integer	30	—	Maximum number of tasks to list
--order-by	string	""	—	Order by field (PRIORITY_RANK, CREATED_AT)
--order-direction	string	"DESC"	—	Sort direction (ASC, DESC)
--org	string	""	—	Organization ID
--output, -o	string	""	—	Output format: json, table (default)
--query, -q	string	""	—	Search tasks by name
--state	string	""	—	Filter by state (BACKLOG, TODO, IN_PROGRESS, DONE, CANCELED, DUPLICATE)

Examples

# List tasks in the default organization
prb task list

# List in-progress tasks matching a search
prb task ls --query access --state IN_PROGRESS

# List tasks sorted by priority
prb task ls --order-by PRIORITY_RANK --output json

# List tasks assigned to a person
prb task ls --assigned-to <profile-id>

View command implementation.

prb task list-linear-issues

Search Linear issues for a team.

Usage

prb task list-linear-issues <organization-id>

Requires 1 positional argument.

Flags

Flag	Type	Default	Required	Description
--after	string	""	—	Cursor from the previous page (the Next cursor line)
--limit, -L	integer	30	—	Maximum number of issues to list
--query	string	""	—	Search issues in the team
--team-id	string	""	Required	Linear team ID

View command implementation.

prb task list-linear-teams

Search Linear teams for an organization.

Usage

prb task list-linear-teams <organization-id>

Requires 1 positional argument.

Flags

Flag	Type	Default	Required	Description
--after	string	""	—	Cursor from the previous page (the Next cursor line)
--limit, -L	integer	30	—	Maximum number of teams to list
--query	string	""	—	Search teams by name or key

View command implementation.

prb task publish-linear

Publish a task as a new Linear issue.

Usage

prb task publish-linear <id>

Requires 1 positional argument.

Additional help

Publish a task as a new Linear issue. The Probo task status and content are left unchanged.

Flags

Flag	Type	Default	Required	Description
--team-id	string	""	Required	Linear team ID

View command implementation.

prb task unlink-external

Unlink a task from its external issue.

Usage

prb task unlink-external <id>

Requires 1 positional argument.

View command implementation.

prb task update

Update a task.

Usage

prb task update <id>

Requires 1 positional argument.

Flags

Flag	Type	Default	Required	Description
--assigned-to	string	""	—	Assigned profile ID
--content	string	""	—	Task content as markdown or ProseMirror JSON. Images and links to /api/files/v1/{id} are kept
--deadline	string	""	—	Deadline
--internal-control	string array	[]	—	Internal control ID (repeatable, empty value clears all)
--name	string	""	—	Task name
--priority	string	""	—	Task priority: URGENT, HIGH, MEDIUM, LOW
--recurrence-interval	string	""	—	Recurrence interval as an ISO-8601 duration, e.g. P7D, P1M or P1Y (empty clears recurrence). The next task is created when the deadline passes
--state	string	""	—	Task state: BACKLOG, TODO, IN_PROGRESS, DONE, CANCELED, DUPLICATE
--time-estimate	string	""	—	Time estimate

View command implementation.

prb task update-linear-settings

Update the organization’s Linear settings.

Usage

prb task update-linear-settings <organization-id>

Requires 1 positional argument.

Flags

Flag	Type	Default	Required	Description
--clear-team	boolean	false	—	Clear the default Linear team
--issue-import	string	""	—	Issue import: active or inactive
--team	string	""	—	Linear team ID

View command implementation.

prb task view

View a task.

Usage

prb task view <id>

Requires 1 positional argument.

Flags

Flag	Type	Default	Required	Description
--json	boolean	false	—	Output JSON (same as —output json)
--output, -o	string	""	—	Output format: json, table (default)

View command implementation.