sazabi tasks — Manage tasks and automatic task creation rules in connected trackers. Subcommands: create, comment, transition, rules, mapping.
sazabi tasks
Manage tasks and automatic task creation rules in connected trackers
sazabi tasks <subcommand>
sazabi tasks create --container ENG --title "Fix login bug" # Create a task in the ENG tracker
sazabi tasks rules list # List automatic task creation rules
sazabi tasks mapping set --provider linear --resolved "Done" # Map Resolved to a Linear state
sazabi tasks rules create --connection-id <id> --provider linear --container-id ENG --min-severity high # Create a routing rule
sazabi tasks comment --task-id ENG-123 --body-markdown "Fixed in the latest deploy" # Add a comment to a task
sazabi tasks transition --task-id ENG-123 --state Done # Move a task to a target state
sazabi tasks create
Create a task such as a Linear issue
sazabi tasks create [options]
| Flag | Type | Required | Description |
|---|---|---|---|
--token | string | No | Override token (prefer SAZABI_TOKEN; arguments are visible to other local users) |
--api-base-url | string | No | Override API base URL |
--json | boolean | No | Output as JSON |
--organization-id | string | No | Override active organization ID |
--container | string | No | Container id, short key (e.g. a Linear team key like ENG), or display name |
--title | string | No | Task title |
--body-markdown | string | No | Markdown body/description for the task |
--state | string | No | Optional initial workflow state, by name or state ref |
--item-type | string | No | Task type, by name or type ref (required only for trackers that declare types) |
--client-request-id | string | No | Stable idempotency key. Pass the same value when retrying a create so a lost/timed-out response does not file a duplicate task |
sazabi tasks create --container ENG --title "Fix login bug" # Create a task in the ENG tracker
sazabi tasks create --container ENG --title "Fix login bug" --body-markdown "Steps to repro..." --json # Create with a body and print JSON
sazabi tasks create --container ENG --title "Fix login bug" --client-request-id "$(uuidgen)" # Safe to retry with the same key
sazabi tasks comment
Add a comment to a task
sazabi tasks comment [options]
| Flag | Type | Required | Description |
|---|---|---|---|
--token | string | No | Override token (prefer SAZABI_TOKEN; arguments are visible to other local users) |
--api-base-url | string | No | Override API base URL |
--json | boolean | No | Output as JSON |
--organization-id | string | No | Override active organization ID |
--task-id | string | No | The task to comment on: its provider-native id or human identifier (e.g. “ENG-123”) |
--body-markdown | string | No | Markdown body of the comment |
sazabi tasks comment --task-id ENG-123 --body-markdown "Fixed in the latest deploy" # Add a comment to a task
sazabi tasks transition
Move a task to a target workflow state
sazabi tasks transition [options]
| Flag | Type | Required | Description |
|---|---|---|---|
--token | string | No | Override token (prefer SAZABI_TOKEN; arguments are visible to other local users) |
--api-base-url | string | No | Override API base URL |
--json | boolean | No | Output as JSON |
--organization-id | string | No | Override active organization ID |
--task-id | string | No | The task to transition: its provider-native id or human identifier (e.g. “ENG-123”) |
--state | string | No | Target workflow state, by name (case-insensitive) or state ref |
sazabi tasks transition --task-id ENG-123 --state Done # Move a task to a target state
sazabi tasks rules
Manage automatic task creation rules for a project
sazabi tasks rules <subcommand>
sazabi tasks rules list
List task creation rules
sazabi tasks rules list [options]
| Flag | Type | Required | Description |
|---|---|---|---|
--token | string | No | Override token (prefer SAZABI_TOKEN; arguments are visible to other local users) |
--api-base-url | string | No | Override API base URL |
--json | boolean | No | Output as JSON |
--organization-id | string | No | Override active organization ID |
--project-id | string | No | Override active project ID |
sazabi tasks rules list # List all rules in priority order
sazabi tasks rules list --json # Output rules as JSON
sazabi tasks rules get
Get a task creation rule by ID
sazabi tasks rules get <rule-id> [options]
| Flag | Type | Required | Description |
|---|---|---|---|
--token | string | No | Override token (prefer SAZABI_TOKEN; arguments are visible to other local users) |
--api-base-url | string | No | Override API base URL |
--json | boolean | No | Output as JSON |
--organization-id | string | No | Override active organization ID |
--project-id | string | No | Override active project ID |
--rule-id | string | No | Rule ID (UUID) |
sazabi tasks rules get <rule-id> # View details of a rule
sazabi tasks rules create
Create an automatic task creation rule
sazabi tasks rules create [options]
| Flag | Type | Required | Description |
|---|---|---|---|
--token | string | No | Override token (prefer SAZABI_TOKEN; arguments are visible to other local users) |
--api-base-url | string | No | Override API base URL |
--json | boolean | No | Output as JSON |
--organization-id | string | No | Override active organization ID |
--project-id | string | No | Override active project ID |
--connection-id | string | No | Integration connection ID (Linear, Jira or GitHub connection) |
--provider | string | No | Task provider (linear, jira, github) |
--container-id | string | No | Container ID (Linear team ID, Jira project ID or key, or GitHub repository as owner/repo) |
--min-severity | string | No | Minimum issue severity to match (low, medium, high, critical) |
--types | string | No | Comma-separated issue types to match (reliability, correctness, security, efficiency); matches an issue with any listed type |
--component-ids | string | No | Comma-separated component UUIDs to match (repeatable via commas; exclusive with —team-ids) |
--team-ids | string | No | Comma-separated owning-team UUIDs to match (exclusive with —component-ids) |
--default-item-type | string | No | Default task item type (required for Jira) |
--default-state | string | No | Default workflow state in external tracker |
--priority | string | No | Evaluation priority order (lower numbers evaluated first) |
--enabled | boolean | No | Enable the rule (default: true) |
--disabled | boolean | No | Create rule in disabled state |
sazabi tasks rules create --connection-id <id> --provider linear --container-id ENG --min-severity high # Route high/critical issues to Linear ENG
sazabi tasks rules create --connection-id <id> --provider jira --container-id PROJ --default-item-type Bug # Route issues to Jira PROJ as Bug
sazabi tasks rules create --connection-id <id> --provider github --container-id acme/api # Route issues to GitHub Issues in acme/api
sazabi tasks rules update
Update an automatic task creation rule
sazabi tasks rules update <rule-id> [options]
| Flag | Type | Required | Description |
|---|---|---|---|
--token | string | No | Override token (prefer SAZABI_TOKEN; arguments are visible to other local users) |
--api-base-url | string | No | Override API base URL |
--json | boolean | No | Output as JSON |
--organization-id | string | No | Override active organization ID |
--project-id | string | No | Override active project ID |
--rule-id | string | No | Rule ID (UUID) |
--connection-id | string | No | New integration connection ID |
--provider | string | No | New task provider (linear, jira, github) |
--container-id | string | No | New container ID |
--min-severity | string | No | New minimum issue severity (or ‘all’ to match all severities) |
--clear-min-severity | boolean | No | Clear minimum severity threshold to match all severities |
--types | string | No | Comma-separated issue types to match (reliability, correctness, security, efficiency), or empty string to clear |
--clear-types | boolean | No | Clear the type filter so the rule matches every type |
--component-ids | string | No | Comma-separated component UUIDs to match (or empty string to clear; exclusive with —team-ids) |
--clear-components | boolean | No | Clear component filter so the rule matches all components |
--team-ids | string | No | Comma-separated owning-team UUIDs to match (or empty string to clear; exclusive with —component-ids) |
--clear-teams | boolean | No | Clear team filter so the rule matches all teams |
--default-item-type | string | No | New default task item type |
--default-state | string | No | New default workflow state |
--priority | string | No | New evaluation priority order |
--enabled | string | No | Enable or disable rule (true/false) |
sazabi tasks rules update <rule-id> --min-severity critical # Raise severity threshold
sazabi tasks rules update <rule-id> --enabled false # Disable a rule
sazabi tasks rules delete
Delete an automatic task creation rule
sazabi tasks rules delete <rule-id> [options]
| Flag | Type | Required | Description |
|---|---|---|---|
--token | string | No | Override token (prefer SAZABI_TOKEN; arguments are visible to other local users) |
--api-base-url | string | No | Override API base URL |
--json | boolean | No | Output as JSON |
--organization-id | string | No | Override active organization ID |
--project-id | string | No | Override active project ID |
--rule-id | string | No | Rule ID (UUID) |
sazabi tasks rules delete <rule-id> # Delete a task creation rule
sazabi tasks rules reorder
Reorder task creation rules by priority
sazabi tasks rules reorder <rule-ids...> [options]
| Flag | Type | Required | Description |
|---|---|---|---|
--token | string | No | Override token (prefer SAZABI_TOKEN; arguments are visible to other local users) |
--api-base-url | string | No | Override API base URL |
--json | boolean | No | Output as JSON |
--organization-id | string | No | Override active organization ID |
--project-id | string | No | Override active project ID |
sazabi tasks rules reorder <id1> <id2> <id3> # Reorder rules (first is evaluated first)
sazabi tasks mapping
Map Sazabi issue statuses to a task tracker’s states
sazabi tasks mapping <subcommand>
sazabi tasks mapping get # Show the mapping for the one connected tracker
sazabi tasks mapping set --resolved "Done" --ignored "Canceled" # Pick two rows
sazabi tasks mapping get
Show the toggle and the mapped states
sazabi tasks mapping get [options]
| Flag | Type | Required | Description |
|---|---|---|---|
--token | string | No | Override token (prefer SAZABI_TOKEN; arguments are visible to other local users) |
--api-base-url | string | No | Override API base URL |
--json | boolean | No | Output as JSON |
--organization-id | string | No | Override active organization ID |
--provider | string | No | Task tracker (linear, jira, github). Optional while one tracker with status mapping is connected |
--connection-id | string | No | The tracker connection to act on; defaults to the organization’s live connection. GitHub may have one per installation. |
sazabi tasks mapping get --provider linear # Show the toggle and the four rows
sazabi tasks mapping set
Turn status mapping on or off and pick a row’s state
sazabi tasks mapping set [options]
| Flag | Type | Required | Description |
|---|---|---|---|
--token | string | No | Override token (prefer SAZABI_TOKEN; arguments are visible to other local users) |
--api-base-url | string | No | Override API base URL |
--json | boolean | No | Output as JSON |
--organization-id | string | No | Override active organization ID |
--provider | string | No | Task tracker (linear, jira, github). Optional while one tracker with status mapping is connected |
--connection-id | string | No | The tracker connection to act on; defaults to the organization’s live connection. GitHub may have one per installation. |
--enabled | boolean | No | Turn status mapping on |
--disabled | boolean | No | Turn status mapping off |
--open | string | No | State for Open, by name, or none to empty the row |
--resolved | string | No | State for Resolved, by name, or none to empty the row |
--ignored | string | No | State for Ignored (and Rejected), by name, or none to empty the row |
--resolved-resolution | string | No | Jira only: resolution a Resolved move closes with, by name, or none for the default done one. Takes effect only while Resolved maps to a done-type status |
--ignored-resolution | string | No | Jira only: resolution an Ignored (and Rejected) move closes with, by name, or none for the first canceling one |
sazabi tasks mapping set --provider linear --enabled # Turn it on, rows unchanged
sazabi tasks mapping set --provider linear --resolved "Done" # Map Resolved to Done
sazabi tasks mapping set --provider linear --ignored none # Empty the Ignored row
sazabi tasks mapping set --provider jira --resolved "Done" --resolved-resolution "Fixed" # Close resolved issues as Done / Fixed
sazabi tasks mapping set --provider jira --ignored "Done" --ignored-resolution "Won't Do" # Close ignored issues as Done / Won't Do
sazabi tasks mapping set --provider github --enabled # Turn it on; GitHub's rows come prefilled
sazabi tasks mapping set --provider github --connection-id <id> --enabled # One of several GitHub installations
sazabi tasks mapping states
List the tracker states a row may take
sazabi tasks mapping states [options]
| Flag | Type | Required | Description |
|---|---|---|---|
--token | string | No | Override token (prefer SAZABI_TOKEN; arguments are visible to other local users) |
--api-base-url | string | No | Override API base URL |
--json | boolean | No | Output as JSON |
--organization-id | string | No | Override active organization ID |
--provider | string | No | Task tracker (linear, jira, github). Optional while one tracker with status mapping is connected |
--connection-id | string | No | The tracker connection to act on; defaults to the organization’s live connection. GitHub may have one per installation. |
sazabi tasks mapping states --provider linear # The default team's states and their types
sazabi tasks mapping states --provider jira # The default project's statuses and the site's resolutions
sazabi tasks mapping states --provider github # The three GitHub Issue states: open, closed as completed, closed as not planned