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.