Skip to content

orion group ​

Groups of items

sh
orion group <command> [options]

orion group list ​

List groups with their progress

sh
orion group list [options]
ArgumentDescription
--jsonPrint JSON

orion group create ​

Make a group: empty, optionally inside another, or wrapping items that share a parent

sh
orion group create [options] [label...]
ArgumentDescription
[label...]Group name
--items <value>Comma-separated ids to wrap; the group goes where they are
--in <value>Group to make an empty group inside
--jsonPrint JSON

orion group remove ​

Remove groups with everything inside them

sh
orion group remove [options] [ids...]
ArgumentDescription
[ids...]Group ids or selectors
--where <value>Select targets with an expression instead of ids
--dry-runPreview changes and current revision without writing
--if-revision <value>Write only if the document has this revision
--jsonPrint JSON

orion group set ​

Change a group's fields

sh
orion group set [id] [options]
ArgumentDescription
[id]Item or group id, or a selector such as label:"Extract slider", ref:jira:ABC-12, or pr:86
--label <value>New label
--blurb <value>Group description
--arrange <value>How reflow arranges a group: auto (default) flows by dependency, custom keeps items where they are
--cover <value>Image asset id for the cover, from orion media add --json (empty to clear)
--background <value>Color, color token such as card.background, or image asset id (empty to clear)
--header <value>Markdown with layout HTML shown under the group's title (empty to clear)
--color <value>The group's tint: teal, blue, purple, amber, rose, green, or slate (empty to clear)
--jsonPrint JSON

orion group ungroup ​

Dissolve groups, keeping their items in place

sh
orion group ungroup [options] [ids...]
ArgumentDescription
[ids...]Group ids or selectors
--where <value>Select targets with an expression instead of ids
--dry-runPreview changes and current revision without writing
--if-revision <value>Write only if the document has this revision
--jsonPrint JSON

orion group tidy ​

Mark groups for the app to lay out in place

sh
orion group tidy [options] [ids...]
ArgumentDescription
[ids...]Group ids
--where <value>Select groups with an expression instead of ids
--dry-runPreview changes and current revision without writing
--if-revision <value>Write only if the document has this revision
--jsonPrint JSON