# 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](/docs/developers/cli/commands#global-flags). Run `prb --help` to check your installed version. Replace placeholder IDs and names in source examples before running them. Return to the [complete CLI command reference](/docs/developers/cli/commands) to browse another command. ## Commands | Command | Description | Usage | Source | | --------------------------------------------------------------------- | ------------------------------------------ | --------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------- | | [`prb task`](#prb-task) | Manage tasks. | `prb task ` | [View implementation](https://github.com/getprobo/probo/blob/main/pkg/cmd/task/task.go#L42) | | [`prb task activity`](#prb-task-activity) | Manage task activities. | `prb task activity ` | [View implementation](https://github.com/getprobo/probo/blob/main/pkg/cmd/task/activity/activity.go#L31) | | [`prb task activity list`](#prb-task-activity-list) | List activities on a task. | `prb task activity list` | [View implementation](https://github.com/getprobo/probo/blob/main/pkg/cmd/task/activity/list/list.go#L84) | | [`prb task activity view`](#prb-task-activity-view) | View a task activity. | `prb task activity view ` | [View implementation](https://github.com/getprobo/probo/blob/main/pkg/cmd/task/activity/view/view.go#L72) | | [`prb task comment`](#prb-task-comment) | Manage task comments. | `prb task comment ` | [View implementation](https://github.com/getprobo/probo/blob/main/pkg/cmd/task/comment/comment.go#L34) | | [`prb task comment create`](#prb-task-comment-create) | Add a comment to a task. | `prb task comment create` | [View implementation](https://github.com/getprobo/probo/blob/main/pkg/cmd/task/comment/create/create.go#L64) | | [`prb task comment delete`](#prb-task-comment-delete) | Delete a task comment. | `prb task comment delete ` | [View implementation](https://github.com/getprobo/probo/blob/main/pkg/cmd/task/comment/delete/delete.go#L43) | | [`prb task comment list`](#prb-task-comment-list) | List comments on a task. | `prb task comment list` | [View implementation](https://github.com/getprobo/probo/blob/main/pkg/cmd/task/comment/list/list.go#L76) | | [`prb task comment update`](#prb-task-comment-update) | Update a task comment. | `prb task comment update ` | [View implementation](https://github.com/getprobo/probo/blob/main/pkg/cmd/task/comment/update/update.go#L58) | | [`prb task comment view`](#prb-task-comment-view) | View a task comment. | `prb task comment view ` | [View implementation](https://github.com/getprobo/probo/blob/main/pkg/cmd/task/comment/view/view.go#L66) | | [`prb task create`](#prb-task-create) | Create a new task. | `prb task create` | [View implementation](https://github.com/getprobo/probo/blob/main/pkg/cmd/task/create/create.go#L96) | | [`prb task delete`](#prb-task-delete) | Delete a task. | `prb task delete ` | [View implementation](https://github.com/getprobo/probo/blob/main/pkg/cmd/task/delete/delete.go#L43) | | [`prb task link-linear`](#prb-task-link-linear) | Link a task to an existing Linear issue. | `prb task link-linear ` | [View implementation](https://github.com/getprobo/probo/blob/main/pkg/cmd/task/link-linear/link.go#L66) | | [`prb task list`](#prb-task-list) | List tasks in an organization. | `prb task list` | [View implementation](https://github.com/getprobo/probo/blob/main/pkg/cmd/task/list/list.go#L78) | | [`prb task list-linear-issues`](#prb-task-list-linear-issues) | Search Linear issues for a team. | `prb task list-linear-issues ` | [View implementation](https://github.com/getprobo/probo/blob/main/pkg/cmd/task/list-linear-issues/list.go#L68) | | [`prb task list-linear-teams`](#prb-task-list-linear-teams) | Search Linear teams for an organization. | `prb task list-linear-teams ` | [View implementation](https://github.com/getprobo/probo/blob/main/pkg/cmd/task/list-linear-teams/list.go#L67) | | [`prb task publish-linear`](#prb-task-publish-linear) | Publish a task as a new Linear issue. | `prb task publish-linear ` | [View implementation](https://github.com/getprobo/probo/blob/main/pkg/cmd/task/publish-linear/publish.go#L61) | | [`prb task unlink-external`](#prb-task-unlink-external) | Unlink a task from its external issue. | `prb task unlink-external ` | [View implementation](https://github.com/getprobo/probo/blob/main/pkg/cmd/task/unlink-external/unlink.go#L51) | | [`prb task update`](#prb-task-update) | Update a task. | `prb task update ` | [View implementation](https://github.com/getprobo/probo/blob/main/pkg/cmd/task/update/update.go#L69) | | [`prb task update-linear-settings`](#prb-task-update-linear-settings) | Update the organization's Linear settings. | `prb task update-linear-settings ` | [View implementation](https://github.com/getprobo/probo/blob/main/pkg/cmd/task/update-linear-settings/set.go#L72) | | [`prb task view`](#prb-task-view) | View a task. | `prb task view ` | [View implementation](https://github.com/getprobo/probo/blob/main/pkg/cmd/task/view/view.go#L82) | ## prb task Manage tasks. ### Usage ```text prb task ``` [View command implementation](https://github.com/getprobo/probo/blob/main/pkg/cmd/task/task.go#L42). ## prb task activity Manage task activities. ### Usage ```text prb task activity ``` [View command implementation](https://github.com/getprobo/probo/blob/main/pkg/cmd/task/activity/activity.go#L31). ## prb task activity list List activities on a task. ### Usage ```text 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 ```bash # List activities on a task prb task activity list --task ``` [View command implementation](https://github.com/getprobo/probo/blob/main/pkg/cmd/task/activity/list/list.go#L84). ## prb task activity view View a task activity. ### Usage ```text prb task activity view ``` 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](https://github.com/getprobo/probo/blob/main/pkg/cmd/task/activity/view/view.go#L72). ## prb task comment Manage task comments. ### Usage ```text prb task comment ``` [View command implementation](https://github.com/getprobo/probo/blob/main/pkg/cmd/task/comment/comment.go#L34). ## prb task comment create Add a comment to a task. ### Usage ```text 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 ```bash # Create a comment interactively prb task comment create # Create a comment non-interactively prb task comment create --task --content "Looks good" ``` [View command implementation](https://github.com/getprobo/probo/blob/main/pkg/cmd/task/comment/create/create.go#L64). ## prb task comment delete Delete a task comment. ### Usage ```text prb task comment delete ``` Requires 1 positional argument. ### Flags | Flag | Type | Default | Required | Description | | ------------- | ------- | ------- | -------- | ------------------------ | | `--yes`, `-y` | boolean | `false` | — | Skip confirmation prompt | [View command implementation](https://github.com/getprobo/probo/blob/main/pkg/cmd/task/comment/delete/delete.go#L43). ## prb task comment list List comments on a task. ### Usage ```text 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 ```bash # List comments on a task prb task comment list --task ``` [View command implementation](https://github.com/getprobo/probo/blob/main/pkg/cmd/task/comment/list/list.go#L76). ## prb task comment update Update a task comment. ### Usage ```text prb task comment update ``` 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](https://github.com/getprobo/probo/blob/main/pkg/cmd/task/comment/update/update.go#L58). ## prb task comment view View a task comment. ### Usage ```text prb task comment view ``` 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](https://github.com/getprobo/probo/blob/main/pkg/cmd/task/comment/view/view.go#L66). ## prb task create Create a new task. ### Usage ```text 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 ```bash # Create a task interactively prb task create # Create a task non-interactively prb task create --name "Review access controls" --priority HIGH ``` [View command implementation](https://github.com/getprobo/probo/blob/main/pkg/cmd/task/create/create.go#L96). ## prb task delete Delete a task. ### Usage ```text prb task delete ``` Requires 1 positional argument. ### Flags | Flag | Type | Default | Required | Description | | ------------- | ------- | ------- | -------- | ------------------------ | | `--yes`, `-y` | boolean | `false` | — | Skip confirmation prompt | [View command implementation](https://github.com/getprobo/probo/blob/main/pkg/cmd/task/delete/delete.go#L43). ## prb task link-linear Link a task to an existing Linear issue. ### Usage ```text prb task link-linear ``` Requires 1 positional argument. ### Additional help ```text 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](https://github.com/getprobo/probo/blob/main/pkg/cmd/task/link-linear/link.go#L66). ## prb task list List tasks in an organization. ### Usage ```text 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 ```bash # 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 ``` [View command implementation](https://github.com/getprobo/probo/blob/main/pkg/cmd/task/list/list.go#L78). ## prb task list-linear-issues Search Linear issues for a team. ### Usage ```text prb task list-linear-issues ``` 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](https://github.com/getprobo/probo/blob/main/pkg/cmd/task/list-linear-issues/list.go#L68). ## prb task list-linear-teams Search Linear teams for an organization. ### Usage ```text prb task list-linear-teams ``` 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](https://github.com/getprobo/probo/blob/main/pkg/cmd/task/list-linear-teams/list.go#L67). ## prb task publish-linear Publish a task as a new Linear issue. ### Usage ```text prb task publish-linear ``` Requires 1 positional argument. ### Additional help ```text 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](https://github.com/getprobo/probo/blob/main/pkg/cmd/task/publish-linear/publish.go#L61). ## prb task unlink-external Unlink a task from its external issue. ### Usage ```text prb task unlink-external ``` Requires 1 positional argument. [View command implementation](https://github.com/getprobo/probo/blob/main/pkg/cmd/task/unlink-external/unlink.go#L51). ## prb task update Update a task. ### Usage ```text prb task update ``` 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](https://github.com/getprobo/probo/blob/main/pkg/cmd/task/update/update.go#L69). ## prb task update-linear-settings Update the organization's Linear settings. ### Usage ```text prb task update-linear-settings ``` 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](https://github.com/getprobo/probo/blob/main/pkg/cmd/task/update-linear-settings/set.go#L72). ## prb task view View a task. ### Usage ```text prb task view ``` 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](https://github.com/getprobo/probo/blob/main/pkg/cmd/task/view/view.go#L82).