edhil work-items
edhil work-items
edhil work-items [--epic NUMBER]
Lists the open epics of the project with their open work items, as a tree, in ascending order of the issue numbers. Work items that belong to no epic are listed last, under No epic. A work item that an earlier run committed is marked with the run and the short hash of the commit. An issue with the Projects label is a project, not a work item: it is never listed, neither under an epic that is linked to it nor under No epic.
#5 The epic
#11 First item committed in run #3 (0123456)
#12 Second item
#6 Empty epic
(no open work items)
No epic
#30 Loose item
An issue is an epic when it has the Epics label. A work item belongs to an epic when it is linked to it, which is what edhil import does.
Options
| Option | Meaning |
|---|---|
--epic NUMBER |
Only this epic, with its open work items. The number must be one of the open epics, or the command fails with #N is not one of the open epics. |
Good to know
- It needs the token and the configuration file. The marks come from the journal of the repository you are in; without a journal nothing is marked.
- Every open issue of the project is listed, however many there are: edhil reads them 50 at a time until the forge has no more. A project with more than 20000 open issues gets an error instead of a cut list.
- With nothing open it prints
No open epics or work items. - The output is plain lines. Bold epics and a green mark are used only on a terminal.