Skip to Content

cmdop issue

cmdop issue reads and writes the issue board from the terminal. An issue you file here is the same record an agent or a scheduled trigger files, apart from its recorded source.

cmdop issue list cmdop issue create --title "Fix the migration script" cmdop issue show CMD-42

Issues are addressed by the identifier that list and create print (CMD-42).

List issues

cmdop issue list cmdop issue list --status todo,in_progress cmdop issue list --source trigger --limit 20
FlagPurpose
--status <list>Comma-separated statuses: backlog, todo, in_progress, in_review, done, blocked, cancelled.
--source <list>Comma-separated sources: manual, agent, trigger, webhook.
--limit <n>Maximum rows. Default 50.

Filters combine with AND semantics. ls is an alias for list.

Show one issue

cmdop issue show CMD-42

Prints the issue together with its recent runs.

Create an issue

cmdop issue create --title "Fix the migration script" cmdop issue create --title "Rotate the relay password" --priority high --labels ops,infra cmdop issue create --title "Investigate disk pressure" --status in_progress
FlagPurpose
--title <text>Required.
--description <text>Body text; use shell quoting for multiple lines.
--status <status>Initial status. Default todo, so the issue lands on the active column rather than the backlog.
--priority <level>urgent, high, medium, low, or none.
--labels <list>Comma-separated labels.

Issues created this way record source manual — distinct from agent (filed by an AI operator) and trigger (filed by a schedule).

Update an issue

cmdop issue update CMD-42 --status in_progress cmdop issue update CMD-42 --title "New title" --priority high cmdop issue update CMD-42 --labels ops,urgent

Only the fields you pass change; omitted fields stay as they are. --labels replaces the label set rather than appending to it, so pass the full list you want the issue to end up with.

update takes the same --title, --description, --status, --priority, and --labels flags as create.

Close an issue

cmdop issue close CMD-42 cmdop issue close CMD-7 --cancelled

close is sugar for update --status done. Pass --cancelled for work that was abandoned or superseded. Neither form is destructive — the issue stays for history.

Delete an issue

cmdop issue delete CMD-42 cmdop issue delete CMD-42 --yes

delete is a soft delete: the issue is marked cancelled and closed and drops out of the default list view, but the record survives. It asks for confirmation unless you pass -y/--yes. rm is an alias for delete.

Last updated on